Usage & top-ups

Call minutes are paid from a prepaid credit wallet, not metered through Stripe. Your plan renewal deposits credit into the wallet; calls draw it down. When you want more, you buy a top-up. This keeps spend predictable: an agent can't run up an open-ended bill.

How the wallet works

• Plan renewal deposits the plan's included credit into your wallet each period.
• Calls consume credit as they happen (minutes × your country's per-minute rate).
• Top-ups add one-time credit on demand — larger packages include a bonus.
• The wallet tracks separate buckets (plan, top-up, bonus) and a combined balance.

Check usage and balance

curl https://api.agoralia.app/api/v1/billing/usage -H "X-API-Key: ag_..."

Returns your plan, included vs. used minutes, remaining minutes, and the wallet's credit balance / credit consumed for the period.

get_billing_usage()                           # minutes + wallet credit balance
get_topup_packages()                          # available top-up amounts
get_cost_estimate(...)                        # estimate a campaign before launch
get_credit_transactions(phone_number_id="…")  # per-number voice-credit ledger

Buy a top-up

Top-ups are purchased from the dashboard. Open Billing at app.agoralia.app, choose a credit package, and check out through Stripe. Larger packages carry a bonus (e.g. extra credit on the bigger tiers). Money movement is a human action — it goes through hosted Stripe checkout, never headless over the API key.

Manage your subscription

Update your card, switch plans, view invoices, or cancel through the Stripe Customer Portal. Open it from the dashboard Billing page.

Next steps

• Plans
• Analytics & reports