Wallet
Monitor your wallet balance and ensure sufficient funds for order processing.
Fetch Wallet Balance
Section titled “Fetch Wallet Balance”GET /v1/partners/wallet/balance
curl "https://api.rewardos.in/v1/partners/wallet/balance" \ -H "Authorization: Bearer <prod_token>" \ -H "X-REQUEST-ID: $(uuidgen)"Response
Section titled “Response”Status 200:
{ "balance": 1000.5}Error Responses
Section titled “Error Responses”| Status | Meaning |
|---|---|
401 |
Unauthorized |
400 |
Bad request |
Staging vs Production Wallet
Section titled “Staging vs Production Wallet”| Staging | Production | |
|---|---|---|
| Funds | Test balance (can be exhausted) | Real money |
| Top-up | Request via RewardOS support | Via agreed billing / top-up flow |
| Debits | Test orders | Gross order amount |
Handling Insufficient Balance
Section titled “Handling Insufficient Balance”When balance is too low to process an order, you receive error code E300.
{ "id": "E300", "code": "INSUFFICIENT_BALANCE", "message": "Insufficient wallet balance", "requestId": "req_12345"}Monitor balance proactively and subscribe to the Wallet Low Balance webhook.
Wallet Top-Up
Section titled “Wallet Top-Up”Contact contact@rewardos.in for staging top-ups and production funding instructions for your account.