คู่มือ API

x-api-key: tg_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

{
  "ok": true,
  "name": "ร้านของคุณ",
  "credit": 850.5
}

{
  "ok": true,
  "game": "freefire",
  "count": 11,
  "items": [
    {
      "item_id": 80,
      "name": "30 Diamond",
      "type": "point",
      "amount": 30,
      "bonus": 3,
      "retail": 10,
      "price": 9.7,
      "image": "https://..."
    }
  ]
}

{
  "game": "freefire",
  "item_id": 80,
  "player_id": "1911341532",
  "ref": "order-0001"
}

{
  "ok": true,
  "order": {
    "id": 1024,
    "ref": "order-0001",
    "game": "freefire",
    "item_id": 80,
    "item_name": "30 Diamond",
    "player_id": "1911341532",
    "price": 9.7,
    "status": "success",
    "created_at": "2026-11-15T03:10:00.000Z",
    "updated_at": "2026-11-15T03:10:04.000Z"
  }
}

{
  "ok": false,
  "error": "Not enough credit",
  "code": "insufficient_credit"
}

curl -X POST "{BASE}/v1/orders" \
  -H "x-api-key: tg_xxx" \
  -H "Content-Type: application/json" \
  -d '{"game":"freefire","item_id":80,"player_id":"1911341532","ref":"order-0001"}'

# เช็คสถานะ
curl "{BASE}/v1/orders?ref=order-0001" -H "x-api-key: tg_xxx"

const BASE = '{BASE}';
const headers = { 'x-api-key': process.env.TOPUP_API_KEY, 'Content-Type': 'application/json' };

async function topup(game, itemId, playerId, ref) {
  let res = await fetch(`${BASE}/v1/orders`, {
    method: 'POST',
    headers,
    body: JSON.stringify({ game, item_id: itemId, player_id: playerId, ref }),
    signal: AbortSignal.timeout(40000),
  });
  let data = await res.json();
  if (!data.ok) throw new Error(`${data.code}: ${data.error}`);

  // ยังไม่เสร็จ: เช็คต่อทุก 4 วินาที
  while (['queued', 'processing'].includes(data.order.status)) {
    await new Promise((r) => setTimeout(r, 4000));
    res = await fetch(`${BASE}/v1/orders/${data.order.id}`, { headers });
    data = await res.json();
  }
  return data.order; // status: success | failed | unknown
}

const order = await topup('freefire', 80, '1911341532', 'order-0001');
console.log(order.status, order.error ?? '');

<?php
$base = '{BASE}';
$key  = getenv('TOPUP_API_KEY');

function call($method, $url, $key, $body = null) {
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_CUSTOMREQUEST  => $method,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => 40,
        CURLOPT_HTTPHEADER     => ["x-api-key: $key", 'Content-Type: application/json'],
    ]);
    if ($body !== null) curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));
    $res = json_decode(curl_exec($ch), true);
    curl_close($ch);
    return $res;
}

$data = call('POST', "$base/v1/orders", $key, [
    'game' => 'freefire', 'item_id' => 80, 'player_id' => '1911341532', 'ref' => 'order-0001',
]);
if (empty($data['ok'])) exit("{$data['code']}: {$data['error']}\n");

// ยังไม่เสร็จ: เช็คต่อทุก 4 วินาที
while (in_array($data['order']['status'], ['queued', 'processing'])) {
    sleep(4);
    $data = call('GET', "$base/v1/orders/{$data['order']['id']}", $key);
}
echo $data['order']['status'], "\n"; // success | failed | unknown

import os, time, requests

BASE = "{BASE}"
HEADERS = {"x-api-key": os.environ["TOPUP_API_KEY"]}

def topup(game, item_id, player_id, ref):
    r = requests.post(f"{BASE}/v1/orders", headers=HEADERS, timeout=40,
                      json={"game": game, "item_id": item_id, "player_id": player_id, "ref": ref})
    data = r.json()
    if not data["ok"]:
        raise RuntimeError(f'{data.get("code")}: {data["error"]}')

    # ยังไม่เสร็จ: เช็คต่อทุก 4 วินาที
    while data["order"]["status"] in ("queued", "processing"):
        time.sleep(4)
        data = requests.get(f'{BASE}/v1/orders/{data["order"]["id"]}', headers=HEADERS, timeout=20).json()
    return data["order"]  # status: success | failed | unknown

order = topup("freefire", 80, "1911341532", "order-0001")
print(order["status"], order.get("error", ""))