API for resellers
Place orders from your own system with an API key. Orders are paid from your Mao wallet.
Create a key in Profile → API key. Send it as the X-Api-Key header on every request. Anyone with the key can spend your wallet balance, so keep it secret; you can replace or revoke it any time.
Base address: https://maogaming.store/api/v1 · JSON · up to 60 requests a minute. Your account email must be confirmed to order.
Endpoints
GET /me- Your username and wallet balance.
GET /products- Every game, gift card and subscription with its packages, prices in rupees, and the fields an order needs.
POST /orders- Place an order:
product_id,fields(for example{"player_id": "5123456"}), anIdempotency-Keyheader so a retry never orders twice, and optionallyexpected_price_nprso the order stops if the price is higher. GET /orders/:id- An order's status and, once completed, its delivery (codes included).
Errors answer with {"ok": false, "error": "…"}: 401 bad key, 402 not enough balance, 403 email not confirmed or account blocked, 404 not found, 422 invalid input or player ID, 429 too many requests (see Retry-After).
Order webhooks
Set an https address in Profile → Order webhooks. When an order is completed or refunded we send order.completed or order.refunded with the order id, status and source only; fetch the order with your key for its details.
- Check the
X-Mao-Signatureheader:t=<unix seconds>,v1=<hex>, where v1 is HMAC-SHA256 of<t>.<raw body>with your signing secret. Compare it tov1and reject times more than 5 minutes old. - Answer with any 2xx within 8 seconds. If not, we retry for about 20 hours.
X-Mao-Deliverystays the same on retries, so you can ignore duplicates. - Send test event in Profile sends a
ping.






