Checkout
Check a selection token from the widget
POST/checkout/selections/verify
Scope checkout.write
Verifies the signature, expiry, Business and environment of a checkout selection token and returns what the buyer chose (price, promised date, point) and whether it was already used. You can also verify offline with the public keys from GET /checkout/keys; booking with checkoutSelection checks it again and uses it once.
Request
Body CheckoutSelectionVerifyRequest
| Field | Type | Description |
|---|---|---|
tokenRequired | string | The selection token from the widget.0–8000 characters |
Response
| Status | Meaning |
|---|---|
200 | Valid selection |
The body is { "status": "success", "data": … }. Fields of data (CheckoutSelectionVerification):
| Field | Type | Description |
|---|---|---|
selectionIdRequired | string | Selection IDPattern ^(?:QD-SEL-[A-F0-9]{24}|QDSEL[A-Z0-9]{10,31})$ |
sessionIdRequired | string | |
environmentRequired | Environment | The key environment. TEST never touches live custody, payments, dispatch or notifications. |
expiresAtRequired | string (date-time) | |
orderReferenceOptional | string or null | |
embedOriginOptional | string | The page that showed the widget. |
selectionRequired | CheckoutSelection | What the buyer chose. Point and price come from Qoene, never from the browser. |
usedRequired | boolean | Already booked. |
shipmentIdRequired | string or null |
Errors
Errors use the error envelope { "status": "error", "message", "code"?, "details"? }.
| Status | When |
|---|---|
400 | The request is not valid. A field is missing or invalid, or the Idempotency-Key header is missing or malformed. |
401 | Missing, invalid, expired or revoked API key. The API key is missing, invalid, expired or revoked. |
403 | The key lacks the scope, or the operation needs a LIVE key. The key lacks the scope, or this call needs a LIVE key (LIVE_KEY_REQUIRED), or the Business owner is not verified (SENDER_VERIFICATION_REQUIRED). |
404 | Not found for this Business and environment. IDs from another Business or environment are always 404. Not found for this Business and environment. IDs from another Business or the other environment are always 404. |
422 | Eligibility or business rule refused the request; details.reason explains why. A business rule refused the request. details.reason.code says why (for example OVER_PRODUCT_WEIGHT_LIMIT or a point exclusion reason). |
429 | Too many requests. See the RateLimit headers. Too many requests. Wait for Retry-After, then retry with the same idempotency key. |