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

# Retrieve checkout session

> Retrieve public hosted checkout session details.

Retrieve the public details used by Pasteaza's hosted checkout page.

## Endpoint

```http theme={null}
GET /public/checkout/:reference
```

No authentication is required.

## Example request

```bash theme={null}
curl https://api.oyapasteaza.com/public/checkout/ch_Fb8z7rX8r9w2
```

## Successful response

```json theme={null}
{
  "status": true,
  "message": "Checkout session retrieved successfully.",
  "data": {
    "reference": "ch_Fb8z7rX8r9w2",
    "merchant": {
      "id": "123456",
      "displayName": "Acme Stores"
    },
    "amount": 50000,
    "currency": "NGN",
    "description": "Premium subscription",
    "customer": {
      "name": "John Doe",
      "email": "john@example.com"
    },
    "paymentMethods": [
      {
        "code": "bank_transfer",
        "label": "Bank Transfer",
        "enabled": true,
        "available": true,
        "status": "available"
      },
      {
        "code": "card",
        "label": "Card",
        "enabled": true,
        "available": false,
        "status": "coming_soon"
      }
    ],
    "status": "pending",
    "expiresAt": "2026-07-22T12:30:00.000Z"
  }
}
```

## Status values

| Status      | Meaning                                  |
| ----------- | ---------------------------------------- |
| `pending`   | Checkout is awaiting payment.            |
| `paid`      | Payment has been confirmed and credited. |
| `expired`   | Checkout is no longer payable.           |
| `cancelled` | Checkout was cancelled.                  |