Support and API

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"}), an Idempotency-Key header so a retry never orders twice, and optionally expected_price_npr so 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-Signature header: t=<unix seconds>,v1=<hex>, where v1 is HMAC-SHA256 of <t>.<raw body> with your signing secret. Compare it to v1 and reject times more than 5 minutes old.
  • Answer with any 2xx within 8 seconds. If not, we retry for about 20 hours. X-Mao-Delivery stays the same on retries, so you can ignore duplicates.
  • Send test event in Profile sends a ping.