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 by the platform or a partner (promotions, trials, 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.