Gold and silver,
as an API call.
Quote it, buy it, gift it, ship it — over REST. Live INR rates, ten-minute locked quotes, and settlement that either completes or refunds itself.
No card. No approval queue. No sales call.
POST /partner/buy/quoteSandbox{
"user_code": "usr_test_a1b2c3d4e5f6",
"asset_type": "gold",
"amount_inr": 1000
}// Press Run to see the responseIllustrative rate — your sandbox returns the live one.
- Gold & silver, priced in INR
- PAN + Aadhaar KYC built in
- 3% GST handled
- HMAC-signed webhooks
- Physical coin delivery
Most APIs bill you. This one pays you.
There are no per-call fees, no monthly minimums and no charge to go live. You earn a commission on the buy volume your integration drives — so the better your product performs, the more the integration returns.
Commission applies to buy volume routed through your integration. It does not apply to assets you gift or send from your own wallet — you already own those. See the full pricing
Four ways to ship it.
Pick how much of the experience you want to own. Every path uses the same keys, the same sandbox and the same webhooks — and you can change your mind later without new credentials.
Hosted webview
Ship gold this sprint. Support none of it.
We run the payments, the PAN and Aadhaar checks, and the end-user support tickets. You don't build a buy screen, reconcile a gateway, or answer "where is my gold" — and every user who onboards through it is attributed to you. One server call and a WebView.
Read the guide→Raw API
Your interface. Our licence, custody and settlement.
You own every pixel and every step. We own the vault, the bullion supplier, the GST and the regulatory surface — the parts that take months to arrange and can't be shipped by writing code. Retries are safe, and a failed fulfilment refunds itself.
Read the guide→Gifting & rewards
Pay people in something that appreciates.
A ₹200 voucher expires and gets forgotten. Two hundred rupees of gold gets checked. Send to any Indian mobile number — no account, no signup funnel, nothing for the recipient to do before the reward lands.
Read the guide→White-label
Your own gold product, without building one.
Your domain, your logo, your words on the sign-in page — and nothing of ours anywhere the user looks. You point one DNS record; we run the app, the vaults, the KYC and the payments. There is no front end for you to build and no release for you to schedule.
Read the guide→Want it on your own domain, under your own brand? That is white-label — a DNS record and a logo, and we run the rest.
Built like money movement, not like a demo.
Gold is not a toy payload. The parts of this that are hard to build are the parts you would otherwise have to build yourself.
Show a price and honour it
Every quote locks its rate for ten minutes and freezes the price block it was struck against. The number your user sees is the number that settles — no slippage between screen and confirmation.
Retry without fear
Send an Idempotency-Key and a replay returns the original response, flagged as a replay. Keys are scoped per environment, so a key you exercised in sandbox can never satisfy a live request. Quotes are row-locked, so two concurrent confirms can never both settle.
Failures refund themselves
If your wallet is debited and fulfilment then fails, the wallet is credited back automatically and the order voided. You get a clear error instead of a silent hole in your ledger.
Never poll for settlement
Webhooks are HMAC-signed with a replay-resistant timestamp and retried across six hours. The delivery queue lives in the database, not in memory, so events survive a restart on our side — and you can replay any delivery yourself.
Your users’ holdings, reconciled
Every asset your integration puts in a user’s hands is tracked in a per-partner ledger that moves in the same transaction as the balance itself. You can see and reconcile your position without running a ledger of your own.
You never hold the PII
You address users by an opaque user_code. Mobile numbers and email addresses come back masked, bank account numbers are never returned in full, and internal identifiers never leave our side.
A sandbox with real money problems.
Most sandboxes return whatever you ask for, which means the first thing you meet in production is the first failure you have never handled. Ours has a balance sheet.
A float you can actually run out of
Your sandbox wallet starts at ₹1,00,000 and every test buy debits it. Insufficient funds is a state you can reach and handle, not a branch you hope you got right.
Real prices, simulated settlement
Quotes are struck against the same live market feed as production. Only the settlement is simulated — no real money moves, and responses carry the same field names and types as live.
It fires real webhooks
Sandbox events are signed and delivered exactly like production ones, stamped with the sandbox mode. You can build and verify your event handling before you ever hold a live key.
Reset it in one call
One request clears users, balances and trades and reseeds the float. Keep your test identities if you want them.
| OTP | 1234 | Always accepted — no SMS sent |
| Email code | 123456 | Verifies the address |
| PAN | ABCDE1234F | KYC approved |
| PAN | ZZZZZ9999Z | KYC rejected |
| Withdrawal | amount ending .01 | Fails, then refunds |
Deterministic, so your integration tests stay stable.
Your first gram, in three calls.
Register a user, lock a quote, confirm it. Swap asset_type to silver and the same three calls buy silver instead.
# 1. Register a test user. Returns a persistent user_code.
curl -X POST https://api.oropocket.com/partner/users/init \
-H "Authorization: Bearer oro_test_xxx" \
-H "Content-Type: application/json" \
-d '{"flow":"api","mobile":"9000000001"}'
# 2. Quote 1,000 rupees of gold. Locks the rate for 10 minutes.
curl -X POST https://api.oropocket.com/partner/buy/quote \
-H "Authorization: Bearer oro_test_xxx" \
-H "Content-Type: application/json" \
-d '{"user_code":"usr_test_xxx","asset_type":"gold","amount_inr":1000}'
# 3. Confirm. Idempotency-Key makes this safe to retry.
curl -X POST https://api.oropocket.com/partner/buy/confirm \
-H "Authorization: Bearer oro_test_xxx" \
-H "Idempotency-Key: 8f14e45f-cea1-4b2c-9d3a-1f2e3d4c5b6a" \
-H "Content-Type: application/json" \
-d '{"quote_id":"tqt_xxx"}'Free to go live. About seven minutes.
No integration fee, no procurement call, no minimum volume commitment. Four short steps, your progress saves as you go, and most applications are approved within one business day.
- 01~2 min
Company
Who we are contracting with.
- 02~1 min
Bank
Where your commission settles.
- 03~3 min
KYC
Required to move real money.
- 04~1 min
Agreement
Sign, and submit for review.
Frequently asked.
- What can I build with the OroPocket gold and silver API?
- Three things ship today. A hosted webview that renders buying, selling and KYC inside your app. A raw server-to-server REST API where you own the entire interface. And programmatic gifting, where you fund a wallet once and send gold or silver to any Indian mobile number. Physical coin delivery is available on top of all three.
- How quickly can I get an API key?
- Verify your mobile with an OTP, pick what you are building, and your sandbox key is on screen. There is no card, no approval step and no sales call. Most developers make their first successful call within a few minutes.
- Does the API support silver as well as gold?
- Yes, and at full parity. Every operation takes an asset_type of gold or silver — quoting, buying, selling, sending, gifting and physical delivery all work identically for both metals. There is no gold-only endpoint.
- What does it cost to use?
- There are no per-call fees and no monthly minimums, and going live is free. You earn 1% commission on buy volume attributed to your integration, rising to 2% on the optional ₹50,000 + GST Pro tier, which also adds marketing support. Commission applies to buys your users make — not to assets you gift or send from your own wallet, since you already own those.
- Is the sandbox a mock?
- No. It is a stateful environment backed by real tables, priced off the same live market feed as production, with only settlement simulated. Your sandbox partner wallet is seeded with ₹1,00,000, so you can test insufficient-funds and rejected-KYC paths rather than only the happy path. It also fires real signed webhooks, so you can wire your event handling before going live.
- How do I move from sandbox to production?
- A four-step self-serve wizard: company details, settlement bank account, KYC, and signing the partner agreement. It takes about seven minutes, your progress saves as you go, and it costs nothing. Most applications are approved within one business day.
Start with a key, not a meeting.
Verify a mobile number, choose what you are building, and your sandbox key is on the screen. Everything after that is documented.