> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fossapay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Checkout by ID

> Retrieve a checkout wallet using its FossaPay ID

<ParamField header="x-api-key" type="string" required>
  Your existing active FossaPay API key with full permission.
</ParamField>

<ParamField path="id" type="string" required>
  The checkout `id` returned when the checkout was created.
</ParamField>

```bash theme={null}
curl https://api-production.fossapay.com/api/v1/checkouts/35f5f6fb-0c8d-4e96-ba4a-c04750724ff6 \
  -H "x-api-key: YOUR_API_KEY"
```

```json theme={null}
{
  "status": "success",
  "statusCode": 200,
  "message": "Checkout session retrieved successfully",
  "data": {
    "id": "35f5f6fb-0c8d-4e96-ba4a-c04750724ff6",
    "reference": "ORDER-10025",
    "status": "completed",
    "amount": "5000.00",
    "fee": "80.00",
    "amountPayable": "5080.00",
    "settlementAmount": "5000.00",
    "feeBearer": "customer",
    "currency": "NGN",
    "account": {
      "type": "temporary",
      "bankName": "Sterling Bank",
      "accountName": "FOSSAPAY CHECKOUT",
      "accountNumber": "9541382701",
      "expiresAt": "2026-09-11T10:30:00.000Z"
    },
    "customer": null,
    "metadata": { "orderId": "10025" },
    "transactionId": "3469cd26-a213-431e-96c9-72dc2dea51ae",
    "providerCheckoutReference": "CHK202609111000001234567",
    "expiresAt": "2026-09-11T10:30:00.000Z",
    "completedAt": "2026-09-11T10:08:14.148Z",
    "failedAt": null,
    "reversedAt": null,
    "createdAt": "2026-09-11T10:00:00.000Z",
    "updatedAt": "2026-09-11T10:08:14.148Z"
  }
}
```

The checkout is accessible only to the merchant that created it. If a pending checkout is past its expiry, retrieving it may transition it to `expired` and emit `checkout.expired`.

| HTTP status | When it occurs                                          |
| ----------- | ------------------------------------------------------- |
| `401`       | Missing, invalid, or inactive API key.                  |
| `403`       | Merchant is not eligible.                               |
| `404`       | Checkout does not exist for the authenticated merchant. |