API reference

Returns each provider's id, regions, default_region, whether it is per_region, and the fields needed to connect it.

Lists your connections with provider, region, status (active · expired · error · disabled), last balance and last check time. Session values are never returned.

Answered from FARAMENG's stored catalog (fast, no shop account needed). A region that isn't stored is fetched live from the shop on your connected account. source says which: "stored" or "live". Each game includes image — the shop's own image link for that game.

curl "$BASE/api/v2/games?provider=smileone&region=br" -H "x-api-key: sk_live_..."

Like /games, answered from the stored catalog when the game is stored (source: "stored"), otherwise live from the shop (source: "live"). Stored prices are the shop's price when the catalog was saved; the order itself is always charged at the shop's current price. Each product includes fee_usd — the service fee you'll pay for it — and fee_custom: true when that product has its own fee. Like games, each product has image — the shop's own image link for that item.

Many NetEase games have several servers (for example Identity V: Asia, NA and EU). Send the chosen host_id to /check-id and /orders. A game with a single server uses it automatically.

{ "success": true, "servers": [ { "host_id": "2001", "name": "Asia", "zone": "" }, { "host_id": "2011", "name": "NA and EU", "zone": "" } ], "count": 2 }

Returns the player's nickname when the id is valid. For Garena it also returns packed_role_id to pass to /products and /orders. Always check before ordering.

Places the order through your connected account. Returns 201 for a new order, or 200 with "idempotent": true when the reference was already used.

curl -X POST "$BASE/api/v2/orders" \
  -H "x-api-key: sk_live_..." -H "content-type: application/json" \
  -d '{"provider":"smileone","region":"br","game":"mobilelegends",
       "product_id":"212","user_id":"123456789","zone_id":"2214",
       "reference":"order-0001"}'

{
  "success": true,
  "idempotent": false,
  "order": {
    "id": "6f1c2a9e-...",
    "reference": "order-0001",
    "provider": "smileone",
    "game": "mobilelegends",
    "product_id": "212",
    "player_id": "123456789",
    "zone_id": "2214",
    "status": "success",
    "upstream_order_id": "SO123456789",
    "fee_usd": 0.05,
    "created_at": "2026-11-06T08:00:00.000Z"
  },
  "fee_balance": 9.95
}

Fetch an order by its id or by your reference. Smile.One orders refresh their upstream_status from the provider when fetched.

With no query, returns your fee wallet as fee_balance. With ?provider= and region (required with a provider), also returns the connected account's upstream balance — available for Smile.One and Garena; Midasbuy and NetEase Games balances can't be read.

Redeems Smile.One voucher codes (Smile Cards) straight into the Smile Coin balance of your connected Smile.One account. Each code is checked first; only valid codes are redeemed. Every Smile.One region has its own Smile Coin balance and a code only works in its own country, so region is required: a code for another country is refused before it is used (wrong_region). Up to 20 codes per call (they are sent one at a time, so a full batch takes up to a minute); at most 60 codes per 10 minutes. Codes are never stored in full.

POST /api/v2/vouchers/check takes the same body and only looks the codes up (value and country) without using them. GET /api/v2/vouchers lists your last redemptions.

curl -X POST "$BASE/api/v2/vouchers/redeem"   -H "x-api-key: sk_live_..." -H "content-type: application/json"   -d '{"region":"br","codes":["ABCDEFGHIJK","LMNOPQRSTUV"]}'

{ "success": true, "region": "br", "count": 2, "redeemed": 1,
  "balance_before": 120, "balance_after": 1120,
  "coins_by_country": { "Brasil（Brazil）": 1000 },
  "results": [
    { "code": "ABCD…IJK", "status": "redeemed", "coins": 1000, "country": "Brasil（Brazil）" },
    { "code": "LMNO…TUV", "status": "used", "message": "This voucher code was already used." }
  ] }

Each result's status: redeemed, valid (check only), used, invalid, illegal (not bought from an official seller), wrong_region (the code is for another country), failed or error. /vouchers/check also returns the region's current balance.