Returns the prepaid credit you have left and your recent top-ups. Allo pays every partner charge from this credit first.
How partner charges are paid
Everything you buy for your accounts is paid the same way: new accounts, their renewals, extra numbers, member seats and eSIMs.
- Allo draws on your prepaid credit first.
- If the credit does not cover the whole charge, Allo charges the rest to the card on your billing account.
- If the credit does not cover the charge and you have no card on file, the request fails with
402 PARTNER_CREDIT_INSUFFICIENT. Nothing is created and nothing is charged.
When you pay a prepaid credit invoice, its amount before tax is added to your balance. To top up your credit, write to [email protected].
Response
balance_centsis the credit left, in the smallest unit ofcurrency(cents for EUR and USD). It is0before your first top-up.currencyis lowercase, for exampleeur. It is absent before your first top-up.prepaidistrueonce at least one top-up was added to your credit.last_top_upis your most recent top-up:amount_cents,currencyandat. It is absent when you have none.top_upslists your 20 most recent top-ups, newest first. Each one hasamount_cents(before tax),currency,invoice_idandat.
Only Discounted licence (reseller) partners can read the credit. Any other partner gets PARTNER_CONTRACT_CANNOT_PROVISION, and an account that is not an enabled partner gets PARTNER_ACCESS_REQUIRED.