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
Connect your store to Nokor Store with a prepaid wallet, one Bearer API key, KHQR wallet funding, server-side pricing and signed order webhooks.
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
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"
}]
}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 | FAILEDA pending request is reused instead of creating a second QR. Wallet credits are applied exactly once through the reseller ledger.
/api/reseller/v1/meReseller profile and wallet balance/api/reseller/v1/catalogueReseller-published games and digital products/api/reseller/v1/packages?game=ffPackages, prices and required fields/api/reseller/v1/wallet/topupsCreate a KHQR wallet funding request/api/reseller/v1/wallet/topupsPending and recent wallet funding/api/reseller/v1/wallet/topups/{reference}Poll one wallet top-up/api/reseller/v1/ordersCreate an idempotent reseller order/api/reseller/v1/orders/{reference}Order status and delivered items/api/reseller/v1/orders?limit=50Recent reseller ordersReuse 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
}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 unavailableConfigure 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