API V1

Developer documentation

Connect your store to Nokor Store with a prepaid wallet, one Bearer API key, KHQR wallet funding, server-side pricing and signed order webhooks.

Authentication

Send the API key created in Admin → Reseller API. Keys begin withnkr_live_and are shown only once.

GET https://nokor.store/api/reseller/v1/me
Authorization: Bearer nkr_live_...
Accept: application/json

Catalogue and packages

Fetch products published to the Reseller channel, then request the packages for one game. Prices are calculated server-side and cannot be overridden by the request.

GET /api/reseller/v1/catalogue
→ {
  "ok": true,
  "games": [{ "id", "name", "category", "type", "image_url" }]
}

GET /api/reseller/v1/packages?game=ff
→ {
  "ok": true,
  "game": { "id", "name", "type" },
  "packages": [{
    "code", "name", "price_usd", "in_stock",
    "quantity_min", "quantity_max",
    "required_fields", "email_domain", "delivery"
  }]
}

Top up wallet

Create one KHQR funding request between $1.00 and $1,000.00. Only one request may be pending at a time. Poll the reference until it becomesPAIDor terminal.

POST /api/reseller/v1/wallet/topups
Content-Type: application/json

{ "amount_usd": 10.00 }

→ 201 {
  "ok": true,
  "topup": {
    "reference": "NKR-W-...",
    "amount_usd": 10.00,
    "status": "PENDING",
    "expires_at": "...",
    "qr_data_url": "data:image/png;base64,..."
  },
  "balance_usd": 5.00
}

GET /api/reseller/v1/wallet/topups/{reference}
→ status: PENDING | PAID | EXPIRED | FAILED

A pending request is reused instead of creating a second QR. Wallet credits are applied exactly once through the reseller ledger.

Endpoints

GET/api/reseller/v1/meReseller profile and wallet balance
GET/api/reseller/v1/catalogueReseller-published games and digital products
GET/api/reseller/v1/packages?game=ffPackages, prices and required fields
POST/api/reseller/v1/wallet/topupsCreate a KHQR wallet funding request
GET/api/reseller/v1/wallet/topupsPending and recent wallet funding
GET/api/reseller/v1/wallet/topups/{reference}Poll one wallet top-up
POST/api/reseller/v1/ordersCreate an idempotent reseller order
GET/api/reseller/v1/orders/{reference}Order status and delivered items
GET/api/reseller/v1/orders?limit=50Recent reseller orders

Create an order

Reuse the exact same Idempotency-Key if a response is lost. The wallet is charged once, prices are resolved server-side and failed provider orders are refunded automatically.

POST /api/reseller/v1/orders
Authorization: Bearer nkr_live_...
Idempotency-Key: your-order-0001
Content-Type: application/json

{
  "game": "ff",
  "code": "25",
  "fields": {
    "User ID": "123456789"
  },
  "quantity": 1
}

Order status and limits

PROCESSING
Provider is still confirming the order.

COMPLETED
Order and delivered items are final.

FAILED
The reseller wallet debit is refunded.

Idempotency
Reuse the same key when retrying.

GET /api/reseller/v1/orders/{reference}
GET /api/reseller/v1/orders?limit=50

200 OK | 201 Created | 400 Bad Request | 401 Unauthorized
402 Insufficient balance | 404 Not found | 409 Invalid state
429 Rate limited | 500 Server error | 502/503 Upstream unavailable

Webhook signature

Configure a webhook URL in Admin. Verify the raw request body using HMAC-SHA256. The signing secret is the SHA-256 hex digest of the raw API key.

X-Nokor-Signature: sha256=<hex>

secret = sha256_hex(nkr_live_...)
signature = HMAC_SHA256(secret, raw_body)

event: order.update
status: COMPLETED | FAILED