مرجع الواجهة البرمجية

curl https://your-store.com/api/v1/b2b/catalog?perPage=100 \
  -H "x-api-key: $KEY"

{
  "ok": true,
  "data": [{
    "id": "019f56a9-…", "slug": "steam-5-us",
    "name": { "en": "Steam $5 — United States" },
    "type": "code", "listPrice": "545", "yourPrice": "501",
    "currency": "USD", "available": true, "maxPerOrder": 20
  }],
  "meta": { "page": 1, "perPage": 100, "total": 38 }
}

curl -X POST https://your-store.com/api/v1/b2b/orders \
  -H "x-api-key: $KEY" \
  -H "x-idempotency-key: po-2026-07-12-0001" \
  -H "content-type: application/json" \
  -d '{
    "externalRef": "po-2026-07-12-0001",
    "items": [{ "productId": "019f56a9-…", "quantity": 2 }]
  }'

{ "ok": true, "data": {
  "orderId": "019f5728-…", "number": "KC-MRI0BS8W-026F",
  "status": "paid", "total": "1002"
} }

curl https://your-store.com/api/v1/b2b/orders \
  -H "x-api-key: $KEY"

curl https://your-store.com/api/v1/b2b/orders/019f5728-… \
  -H "x-api-key: $KEY"

{ "ok": true, "data": {
  "orderId": "019f5728-…", "status": "delivered",
  "externalRef": "po-2026-07-12-0001", "total": "1002",
  "lines": [{
    "product": { "slug": "steam-5-us" }, "quantity": 2,
    "units": [{ "unitIndex": 0, "status": "delivered", "code": "XXXX-YYYY-ZZZZ" }]
  }]
} }

curl https://your-store.com/api/v1/b2b/orders/by-ref/po-2026-07-12-0001 \
  -H "x-api-key: $KEY"

curl https://your-store.com/api/v1/b2b/wallet \
  -H "x-api-key: $KEY"

{ "ok": true, "data": { "cash": "48998", "currency": "USD" } }