Wallet & Top-up
Online payments, redemption codes, limited-time grants, balance rules and order history.
Menu location: Personal → Wallet in the left sidebar. This page holds your balance summary, top-up and redemption entries, and order history.
What is on the page
| Section | Content |
|---|---|
| Balance summary | Current balance, total spend, total requests |
| Limited-time grants | Appears only when you hold unexpired grants — see below |
| Add funds | Choose an amount and payment method; the redemption-code entry is here too |
| Order history | Top-up records, searchable by order number |
Paying online
- Open the Wallet page.
- Pick a preset amount, or enter a custom amount.
- Choose a payment method. The platform supports Alipay, WeChat Pay, bank cards and other channels — which ones are available depends on the site, so go by what the page shows.
- Confirm the order, complete payment, and your balance is credited automatically.
Credits from online payments never expire.
Payment callbacks are signature-verified and order state transitions run inside database transactions, so a single payment is never credited twice. If a payment succeeds but the balance does not change, refresh the page first; if it still has not arrived, contact support with your order number — an administrator can settle it manually.
Redemption codes
If you received a code from a promotion, an offline purchase or support:
- Find the redemption input on the Wallet page ("Have a code?").
- Enter the code and confirm; the credit lands in your account balance immediately.
Key rules:
- Each code can be used only once and is voided on redemption, recording who used it.
- The date on a code is the redemption deadline — after it, the code can no longer be redeemed.
- Credits from codes go into the same pool as paid top-ups and likewise never expire.
A common misunderstanding is that the code's date is the expiry of the credits. It is not. The deadline only governs when you must redeem it; once redeemed, the amount becomes ordinary balance and does not expire.
What may expire is the complimentary credit described next.
Complimentary credit
Credit issued through promotions, trials or offline provisioning is tracked separately as complimentary credit.
It does not necessarily expire — that depends on whether a validity period was set when it was issued:
| Top-up / code credit | Complimentary (no expiry) | Complimentary (with expiry) | |
|---|---|---|---|
| Expires | Never | Never | Unused remainder reclaimed at expiry |
| Where shown | In the wallet total | Also in the total, plus its own card | Also in the total, plus its own card |
| Spending order | One pool, no ordering | Same | Same |
Complimentary credit is already included in the wallet total you see — it is not a separate amount. When you hold some, the wallet page shows an extra card with one of three messages:
| What you hold | Card title | Card text |
|---|---|---|
| All without expiry | Complimentary credit | No expiry date, will not be reclaimed |
| All with expiry | Limited-time grants | Unused amounts are reclaimed on expiry |
| A mix of both | Limited-time grants | States how much is limited-time and how much has no expiry |
If your balance drops unexpectedly, check this card first. If the title is "Limited-time grants", a tranche most likely expired; if it is "Complimentary credit", nothing was reclaimed and the change has another cause — check the account ledger.
The card is hidden when you hold no complimentary credit.
Balance and charging rules
- Calls are charged as model price × actual usage; see prices in the model catalog.
- Charging is pre-deduct then settle: an estimate is held at the start and reconciled against actual usage at the end.
- Failed calls are fully refunded — you never pay for a failed request.
- When the balance is insufficient the API returns an insufficient-quota error; topping up restores service immediately.
Balance versus key quota
The most common point of confusion. In one sentence: there is only one pool of money — the account balance. A key's quota is just a spending cap.
Example: an account balance of $100 and a key with a $10 quota.
- That key can spend at most $10, then shows as Exhausted;
- The account still has $90 and other keys keep working;
- If the balance were only $3, that key could only spend $3.
See API Key Management.
Order history
Order history lists every top-up, searchable by order number. Each record shows amount, payment method, status and time.
For reconciliation or disputes, the order number is the definitive reference — always include it when contacting support.
Invoices and corporate payment
Self-service top-ups do not issue invoices directly. For invoices or corporate bank transfers, contact site support or your account manager.