Top up your billing account
The Money page holds two pots that are easy to confuse and behave completely differently. Getting them straight is the difference between a working integration and a stream of 402s.
Two pots, kept apart
| Pot | What it is for |
|---|---|
| Billing account | What OroPocket charges when your API buys metal for one of your users. This is the one that stops buys when it runs dry. |
| Your assets | Gold, silver and INR that you own. Only /send and /gift draw from here — a customer buy never touches it. |
Prepaid or postpaid
Prepaid accounts hold a balance that each buy debits; when it is gone, buys stop. Postpaid accounts have a credit line and settle later, so what matters is how much of the line is still free and whether anything is overdue. The card tells you which you are on with a badge, and the stat cards change to match.
Choose how to pay
The funding card has two tabs. Card / UPI takes you through a payment gateway and credits the account as soon as the payment confirms. Bank transfer gives you beneficiary details and asks for the UTR afterwards, which an administrator matches and credits.
Enter an amount and pay
There is a minimum top-up, shown on the field. On a postpaid account the button reads Settle with the outstanding figure rather than Add funds.
Top-ups are idempotent against the payment reference, so a page refresh mid-payment or a duplicated webhook cannot credit you twice. Submitting the same UTR twice on a bank transfer is refused outright.Check the ledger
Recent activity lists every movement with the balance after it, so you can trace exactly which buy consumed what. If a figure looks wrong, this is where the answer is.
Clearing a 402
402 INSUFFICIENT_PARTNER_FUNDS comes back at quote time, not confirmation — you find out before you have shown your user a price, which is the useful place for it to happen. The error carries your billing type and what is actually available. Top up here and retry the quote; there is nothing to redeploy.
Two related refusals worth recognising: billing is not configured yet means the account has not been set up at all rather than being empty, and spending is suspended is an administrative hold that funding will not lift — both need a word with support.
In Test mode you are spending a simulated float
Test mode gives you ₹1,00,000 of simulated float, and your test buys debit it exactly as real buys debit real money — which is the point, because it means you meet the 402 path in testing rather than in production.
Your own assets have no sandbox equivalent — that section is replaced by a note saying so, because gold you own is real whichever mode the dashboard is in.