API referenceEndpointsCheckouts
Recover a buyer's checkout history
GET
Durable reservation-first history for this partner's buyer, newest first. Unknown buyers return an empty list. Refresh each checkout for its latest status. This does not include payment-first ticket purchases. Never create a new payment for an unresolved checkout after browser storage is cleared; reconcile its original payment first.
PartnerApiKeyheader
AuthorizationBearer <token>Authorization: Bearer <your_api_key>
Keep this credential on your server, never in browser or mobile app code.
A missing, invalid or disabled key returns 401 PLATFORM_KEY_INVALID.
Ask Verity to replace a lost or exposed key.
externalUserRef*stringlimit?integerRange
1 <= value <= 50Default
20offset?integerRange
0 <= value <= 100000Default
0A page of checkouts; add the number of returned items to offset while has_more is true.
application/json- response
success?unknowndata?curl -X GET 'https://api-staging.theverity.xyz/api/v1/platform/users/string/checkouts' \ -H 'Authorization: Bearer <your_partner_api_key>'Example Response
{ "success": true, "data": { "items": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "request_key": "string", "raffle_id": 0, "purchase_id": 0, "status": "queued", "qty": 0, "total_usd": 0, "payment_deadline": "2019-08-24T14:15:22Z", "settlement_deadline": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z", "tickets": [ { "ticket_no": 0, "code": "string" } ], "retry_allowed": true, "error": "string", "refund_only": true, "refund_operation_id": "b5dfb603-0ee2-4d5b-8e76-a9d60c0e9d98", "source_payment_signature": "string" } ], "has_more": true }}