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

# Quickstart: Hosted Checkout

> Crea una Checkout Session, redirige al cliente y confirma el pago con webhook o API read.

Hosted Checkout es el camino recomendado para integrar SimplePay por primera vez: tu backend crea una sesion, SimplePay regresa una URL y tu UI redirige al cliente.

## 1. Variables

```bash terminal theme={"theme":{"light":"github-light","dark":"github-dark"}}
export SIMPLEPAY_API_BASE="https://api.simplepay.mx"
export SIMPLEPAY_API_KEY="spk_sandbox_..."
```

## 2. Crea la sesion

```bash terminal theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -sS -X POST "$SIMPLEPAY_API_BASE/v1/hosted-checkout/sessions" \
  -H "Authorization: Bearer $SIMPLEPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order_1001_checkout_v1" \
  -d '{
    "currency": "mxn",
    "success_url": "https://example.com/orders/order_1001/success?session_id={CHECKOUT_SESSION_ID}",
    "cancel_url": "https://example.com/orders/order_1001",
    "client_reference_id": "order_1001",
    "line_items": [
      {
        "name": "Orden order_1001",
        "amount": 90000,
        "quantity": 1
      }
    ],
    "metadata": {
      "order_id": "order_1001"
    }
  }'
```

## 3. Redirige

Guarda `id` y redirige al cliente a `url`.

```ts browser.ts theme={"theme":{"light":"github-light","dark":"github-dark"}}
window.location.assign(session.url);
```

## 4. Confirma

El `success_url` no prueba que el pago quedo finalizado. Marca la orden como pagada solo despues de:

* recibir un webhook firmado de SimplePay, o
* leer `GET /v1/hosted-checkout/sessions/{id}` desde tu backend.

## Siguiente

* Guia completa: [Checkout Sessions](/payments/checkout-sessions)
* Endpoint create: [POST /v1/hosted-checkout/sessions](/api-reference/endpoints/checkout/create-checkout-session)
* Endpoint read: [GET /v1/hosted-checkout/sessions/{id}](/api-reference/endpoints/checkout/get-checkout-session)