Get Checkout Session

{
  "session": {
    "id": "01951c8a-7c3d-7e1f-9d4a-2b3c4d5e6f70",
    "merchantId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "merchantReference": "ORDER-20260624-001",
    "amount": 10000,
    "currencyId": "USD",
    "expiresAt": "2026-06-24T11:00:00Z",
    "customerId": "9b2d7f3a-8c4e-4f1a-9d3e-1a2b3c4d5e6f",
    "payerLocation": "KEN",
    "redirectUrl": "https://merchant.example.com/order/confirmation",
    "paymentAttributes": {
      "paymentMethod": "card",
      "platform": "web"
    },
    "fxCommit": {
      "quoteId": "qut_01951c8a-9d5e-7f3b-bc4f-6e7d8c9b0a21",
      "collectionCurrency": "KES",
      "collectionAmount": "13260.00",
      "midRate": "130.00",
      "markupBps": 200,
      "allInRate": "132.60",
      "fee": "260.00",
      "expiresAt": "2026-06-24T10:35:00Z",
      "pricingModel": "SPOT_QUOTE"
    }
  }
}

Retrieves the details of a specific checkout session using the provided session ID. The response includes the session object and may include an active transaction if one exists. Note that the hosted checkout paymentLink is returned only by session creation and is not included here — see the Payment Status & Recovery guide.

Query parameters

sessionIdstringRequiredformat: "uuid"

Unique identifier for the checkout session.

Response

Checkout session details retrieved successfully.

sessionobject

payerIdstringOptionalformat: "uuid"

Persistent identifier for the payer (customer) associated with this session. The same payer keeps the same payerId across all of their sessions and transactions. Store it against your customer record and pass it back in payerDetails.payerId on future sessions to recognise a returning customer. See the Payer ID guide.

payerDetailsobjectOptional

activeTransactionobjectOptional

The current active transaction for this session (if any). Fields may vary depending on payment method and auth state.

Errors

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error