Retrieve a checkout session

GET/api/v1/checkout/sessions/{id}

Fetch a checkout session by its ID. Useful for polling sessions when you cannot run a webhook receiver.

When status is Completed, orderId is populated.

Path parameters

idstringrequired

The checkout session ID (e.g., cs_a8f3jk29bcMq2zx7Lp4WnDvR).

Headers

X-Api-Keystringrequired

Your API key.

GET/api/v1/checkout/sessions/{id}


curl -H "X-Api-Key: flx_XXX_YYY" \
  https://api.fluxstore.net/api/v1/checkout/sessions/cs_a8f3jk29bcMq2zx7Lp4WnDvR

200OK


{
  "success": true,
  "data": {
    "id": "cs_a8f3jk29bcMq2zx7Lp4WnDvR",
    "url": "https://fluxstore.net/storefront/your-store/checkout?session=cs_a8f3jk29bcMq2zx7Lp4WnDvR",
    "status": "Completed",
    "orderId": "ord_e5f6a7b8-...",
    "expiresAt": "2026-04-28T11:00:00Z",
    "subtotal": 12.99,
    "totalAmount": 11.69,
    "currency": "GBP",
    "clientReferenceId": "merchant-cart-abc-123"
  }
}