Skip to main content

Retrieve a Checkout

Merchant route confirmed. Check applicability.

Object and complete fields · Authentication, amounts and errors · Integration guide

GET /v1/checkouts/{id}

Retrieves current session status and funds exceptions for result polling, page recovery, or rechecking a Webhook. Does not return payment details.

Attributes​

AttributeLocationTypeRequiredDescription
idpathstringYesUnique Checkout identifier

Request example​

GET /v1/checkouts/checkout_example
Authorization: Bearer inv_test_...

Response example​

200 OK, returning the complete Checkout object.

{
"id": "checkout_example",
"amount": "10",
"currency": "usdc",
"transaction_speed": "low",
"status": "succeeded",
"failure_reason": null,
"exception_status": null,
"order_id": "ORDER_001",
"description": "Order payment",
"metadata": {},
"url": "https://pay.example.com/c/checkout_example",
"return_url": "https://merchant.example.com/orders/ORDER_001",
"expires_at": "2026-10-28T08:30:00Z",
"created_at": "2026-10-28T08:00:00Z",
"updated_at": "2026-10-28T08:02:00Z"
}

Business error codes