> ## 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: Bookable Payments

> Configura inventario reservado, consulta slots y crea un booking checkout con pago requerido.

Bookable Payments es para citas, clases, tours, rentals, experiencias o cualquier inventario que se reserva y se confirma con pago.

## 1. Revisa capacidades

```bash terminal theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -sS "https://api.simplepay.mx/v1/bookable-payments/config" \
  -H "Authorization: Bearer $SIMPLEPAY_API_KEY"
```

## 2. Crea un preset

```bash terminal theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -sS -X POST "https://api.simplepay.mx/v1/bookable-payments/setup" \
  -H "Authorization: Bearer $SIMPLEPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: scheduled_offer_setup_v1" \
  -d '{
    "use_case": "scheduled_offer",
    "product": {
      "name": "Experiencia Isla",
      "currency": "mxn"
    }
  }'
```

## 3. Lista slots

```bash terminal theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -sS "https://api.simplepay.mx/v1/bookable-payments/event_types/experiencia-isla/slots?start=2026-07-10T14:00:00.000Z&end=2026-07-11T00:00:00.000Z&time_zone=America/Cancun&quantity=2" \
  -H "Authorization: Bearer $SIMPLEPAY_API_KEY"
```

## 4. Crea booking checkout

```bash terminal theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -sS -X POST "https://api.simplepay.mx/v1/bookable-payments/bookings" \
  -H "Authorization: Bearer $SIMPLEPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: booking_user_123_20260710_v1" \
  -d '{
    "event_type_id_or_slug": "experiencia-isla",
    "starts_at": "2026-07-10T16:00:00.000Z",
    "quantity": 2,
    "customer": {
      "email": "ana@example.com",
      "name": "Ana"
    },
    "success_url": "https://example.com/bookings/success",
    "cancel_url": "https://example.com/bookings"
  }'
```

## 5. Confirma reserva

Entrega acceso, voucher o calendario solo despues de `booking.confirmed` o de leer el booking con `status=confirmed`.

## Siguiente

* Guia completa: [Bookable quickstart](/bookable-payments/quickstart)
* Modelo: [Bookable model](/bookable-payments/model)
* Endpoint checkout: [POST /v1/bookable-payments/bookings](/api-reference/endpoints/bookable-bookings/create-booking-checkout)