Bookable Payments

Bookable Payments es el producto de SimplePay para plataformas que venden inventario reservado y necesitan pago para confirmar la reserva. No es un calendario completo ni un clon de Cal.com. Tu plataforma conserva login, discovery, UI de calendario y experiencia comercial. SimplePay se encarga de la primitiva critica: disponibilidad, hold temporal, checkout, confirmacion por pago y eventos.

Cuando usarlo

Usa Bookable Payments para:

Citas y servicios con staff.
Clases con cupo.
Tours y experiencias con horarios.
Rentals por unidad o ventana.
Ofertas programadas con capacidad.
Reservas donde el pago decide si el inventario queda confirmado.

Flujo canonico

Objetos principales

Objeto	Que representa
`product`	Lo que vendes en el catalogo del tenant.
`booking_resource`	Staff, espacio, inventario, unidad, vehiculo, equipo o pool de capacidad.
`availability_schedule`	Horario recurrente.
`availability_rule`	Regla por weekday y ventana horaria.
`availability_override`	Apertura, cierre o capacidad especial en fechas concretas.
`booking_blackout`	Bloqueo de disponibilidad por producto, event type, recurso o schedule.
`booking_event_type`	Superficie reservable canonica: duracion, capacidad, slug, recursos, schedules, pago.
`booking_hold`	Reserva temporal que protege inventario mientras el cliente paga.
`booking`	Reserva creada y confirmada, expirada, cancelada, reprogramada o reembolsada por lifecycle.

Estados importantes

Estado	Significado
`held`	Inventario protegido temporalmente.
`pending`	Booking creado con checkout, esperando resultado de pago.
`confirmed`	Pago confirmado, inventario finalizado.
`expired`	Checkout o hold expiro.
`cancelled`	Reserva cancelada o pago fallo.
`rescheduled`	Reserva movida a otro horario.
`no_show`	Cliente no llego, marcado por API.
`refunded`	Pago devuelto.

El browser redirect no confirma una reserva. Tu app debe esperar booking.confirmed o leer el booking hasta status=confirmed.

Dos maneras de integrar

Shortcut setup

Crea product, price, resource, schedule y event type con POST /v1/bookable-payments/setup.

Setup manual

Controla cada objeto por separado para marketplaces, imports o configuradores avanzados.

Scopes minimos

Para un flujo completo de Scheduled Offer en sandbox:

scopes

products:read
products:write
customer_hub:write
availability:read
availability:write
bookings:read
bookings:write
webhooks:write

Preflight

Antes de construir la UI, pide a SimplePay el plan del tenant:

terminal

curl -sS "https://api.simplepay.mx/v1/bookable-payments/preflight?use_case=scheduled_offer" \
  -H "Authorization: Bearer $SIMPLEPAY_API_KEY"

Preflight detecta readiness de API key, tenant environment, cuentas de pago, webhooks y pasos faltantes.

Quickstarts

Fundamentos

Aceptar pagos

Webhooks

LLMs y DX

Bookable Payments

Cuando usarlo

Flujo canonico

Objetos principales

Estados importantes

Dos maneras de integrar

Shortcut setup

Setup manual

Scopes minimos

Preflight

​Cuando usarlo

​Flujo canonico

​Objetos principales

​Estados importantes

​Dos maneras de integrar

Shortcut setup

Setup manual

​Scopes minimos

​Preflight

Cuando usarlo

Flujo canonico

Objetos principales

Estados importantes

Dos maneras de integrar

Scopes minimos

Preflight