RevKeenDocs
StatusSupport
API Reference
🔗 CheckoutCheckout Sessions

Retrieve a checkout session

Retrieve a checkout session by its ID.

GET/checkout-sessions/{id}

Retrieve a checkout session by its ID.

Related endpoints

  • POST /checkout-sessions — Create a checkout session
  • POST /checkout-sessions/{id}/expire — Expire a checkout session

Common errors

  • 401 authentication_error — missing, invalid, expired, or revoked credential. Codes: authentication_failed, invalid_api_key, expired_api_key, api_key_revoked, session_invalid, merchant_required. Carries a WWW-Authenticate: Bearer challenge.
  • 404 resource_missing — the referenced resource does not exist or is not visible to your key.

Authorization

x-api-key<token>

Your RevKeen merchant API key. Create and manage keys in Dashboard → Settings → Developer. Use rk_sandbox_* for staging/test and rk_live_* for production. The same key may be sent as Authorization: Bearer <key> if that suits your HTTP client better. A missing, invalid, expired, or revoked key returns 401 with a WWW-Authenticate: Bearer challenge; a valid key without the required scope returns 403.

In: header

Path Parameters

id*string

Checkout session ID.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

Stuck on an error response? Ask the RevKeen assistant to explain it.
curl -X GET "https://api.revkeen.com/v2/checkout-sessions/11111111-1111-4111-8111-111111111111" \
  -H "x-api-key: $REVKEEN_API_KEY"

Synthetic documentation data, validated against the response schema; not a live API result.

{  "data": {    "id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a55",    "object": "checkout_session",    "status": "pending",    "mode": "subscription",    "amount_total": 4900,    "currency": "GBP",    "customer_id": "c2a1e7d4-5b3f-4a8e-9d21-6f0b3e4c7a11",    "payment_intent_id": null,    "invoice_id": null,    "subscription_id": null,    "url": "https://checkout.revkeen.com/p/rvk_cs_2xK9mQ4vLp8RwT3nYb6Hc",    "success_url": "https://example.com/checkout/success",    "cancel_url": "https://example.com/checkout/cancel",    "expires_at": "2026-04-03T10:00:00.000Z",    "created_at": "2026-04-02T10:00:00.000Z",    "allowed_methods": [      "card"    ],    "selected_method": null  },  "requestId": "00000000-0000-4000-8000-000000000001"}

Put this endpoint to work

Integrate checkout

Integrate terminal payments