Skip to main content
GET
/
v2
/
checkout
/
{checkout_id}
Get Checkout Session
curl --request GET \
  --url https://api.example.com/v2/checkout/{checkout_id}

Get Checkout Session

Retrieve the current status and details of a checkout session.

Endpoint

GET /v2/checkout/{checkout_id}

Authentication

Authorization: Bearer glm_test_YOUR_API_KEY

Path Parameters

ParameterTypeDescription
checkout_idstringThe checkout session ID

Response

When open (awaiting payment):
{
  "checkout_id": "01HXYZ...",
  "reference_id": "your-order-123",
  "status": "open",
  "order_id": null,
  "expires_at": "2026-02-26T14:30:00Z"
}
When paid (payment completed):
{
  "checkout_id": "01HXYZ...",
  "reference_id": "your-order-123",
  "status": "paid",
  "order_id": "ord_abc123",
  "paid_at": "2026-02-25T15:30:00Z"
}
When expired:
{
  "checkout_id": "01HXYZ...",
  "reference_id": "your-order-123",
  "status": "expired",
  "order_id": null,
  "expired_at": "2026-02-26T14:30:00Z"
}

Checkout Status

StatusDescription
openSession created, awaiting customer payment
paidCustomer completed payment, order created
expiredSession expired (24 hours)

Example

curl https://api.withgale.com/v2/checkout/01HXYZ... \
  -H "Authorization: Bearer glm_test_YOUR_API_KEY"
Once status is paid, use the order_id to query the Order for full payment details.

Errors

Status CodeError CodeDescription
401unauthorizedInvalid API key
404not_foundCheckout session not found