Skip to content
Open Portal

Billing

Credits, transactions and checkout.

Applies to Appylar v1.0

Network cross-promotion is funded by a plan. Each plan includes a monthly impression allowance that renews every billing cycle. When you need more than your plan covers, you can buy one-off top-ups. Everything is measured in impressions — one network impression is one unit. This page explains how the allowance, top-ups and billing work.

Manage your plan and top-ups at Billing in the portal.

#Plans & the monthly allowance

A plan is a subscription: you pay monthly and receive an impression allowance for that cycle. Serving on the network draws down the allowance.

  • The allowance resets each billing cycle — you start every period with your full plan allowance.
  • Unused allowance does not roll over (v1): a new cycle starts fresh.
  • Promoting across your own apps is always free and never touches the allowance.

You can change plans at any time from Billing.

#Top-ups

A top-up is a one-off pack of impressions for bursts beyond your plan.

  • Top-ups are consumed only after the monthly allowance is exhausted.
  • Top-up impressions do not expire — they carry over until used.

#How usage is consumed

Each network impression is charged to the advertiser in a fixed order:

  1. Monthly allowance for the current period, then
  2. Top-up balance.
ActionCost
A network campaign's creative is served1 impression (allowance first, then top-up)
A portfolio campaign's creative is servedFree
Showing ads from other developers in your appFree

When neither your allowance nor your top-up balance has anything left, network serving is paused automatically — it simply stops filling until your allowance renews or you top up. Your campaigns are never deleted, and portfolio serving keeps working. There is no automatic overage billing.

#Reading your balance

The Billing page shows, all in impressions:

  • your plan and the current period's allowance (used / remaining),
  • your top-up balance, and
  • your total available (allowance remaining + top-up).

Via the API, GET /v1/billing/summary returns the same picture:

curl https://api.appylar.com/v1/billing/summary \
  -H "Authorization: Bearer <token>" -H "Accept: application/json"
# { "plan": { "key": "growth", "name": "Growth", "monthly_impressions": 500000 },
#   "allowance": { "granted": 500000, "used": 148200, "remaining": 351800 },
#   "topup_balance": 47000, "total_available": 398800, ... }

#Subscribing and topping up

From Billing, choose a plan and subscribe, or pick a top-up pack. You complete payment on a secure hosted checkout; your plan activates (and its allowance is granted) as soon as payment clears. Via the API:

# Start a subscription checkout for a plan
curl -X POST https://api.appylar.com/v1/billing/subscribe \
  -H "Authorization: Bearer <token>" -H "Accept: application/json" -d "plan=growth"
# { "url": "https://checkout..." }

# Or a one-off top-up
curl -X POST https://api.appylar.com/v1/billing/top-up \
  -H "Authorization: Bearer <token>" -H "Accept: application/json" -d "pack=topup_250k"

#Transaction history

The transaction history records top-up movements — purchases (+) and the impressions later drawn from your top-up balance (−) — each with the balance after it. Your monthly allowance and its usage are shown separately on the Billing page, since allowance is included in your plan rather than billed per impression.