One base URL for sandbox and production. Swap your API key when you go live, no code changes required. Prefunded wallet, synchronous issuance and idempotent order placement built for reseller integrations.
From receiving keys to placing a live transaction. Each step links to its full reference page.
Your API key decides who you are and which environment you reach. The idempotency key makes order retries safe.
Static API keys in the format qrk_{test|live}_{opaque}. The key prefix selects your workspace: test keys route to sandbox, live keys to production. No code changes required to switch environments.
Source IPs must be on the allowlist registered with your account manager. Scopes (catalog.read, orders.read, orders.write, wallet.read) are bound to the key at issuance.
| Status | Meaning |
|---|---|
| 401 | Missing, invalid, revoked or expired key (unauthorized) |
| 403 | Source IP not on allowlist, or missing scope (forbidden) |
| 402 | Wallet below required amount (insufficient_funds) |
| 409 | Idempotency key in progress or rate card missing |
| 422 | Out of stock, activation failed or activation timeout |
| 410 | Idempotency key expired (24 h TTL) |
| 429 | Rate limited, check Retry-After |
POST /orders requires an Idempotency-Key header. Retrying with the same key and body replays the original response: the same issuedCode, the same wallet debit, exactly once.
If you receive 504 Gateway Timeout, retry the same request with the same idempotency key. Do not generate a new key until you intend a new order.
A complete request for one voucher. Use denominationInCents from GET /catalog. Optional metadata stores your reconciliation tags.
Eight endpoints across catalog, codes, orders and wallet. Each links into the Scalar reference for schemas and try-it.
Schemas, request and response examples, and a try-it console for every endpoint. Hosted on Scalar, bring your sandbox key.