Checkout

Una Checkout Session es la forma más rápida de suscribir a un cliente nuevo: Rekurra hospeda una página de pago que tokeniza la tarjeta sobre tu cuenta de Wompi y crea el Customer, el PaymentMethod y la Subscription en un solo flujo, sin que tengas que construir tu propio formulario de pago.

Campos

Campo	Tipo	Descripción
`id`	string	Identificador único de la sesión
`url`	string	URL hospedada (`https://checkout.rekurra.dev/{id}`) a la que rediriges a tu cliente
`status`	string	`open` · `complete` · `expired`
`subscription_id`	string?	Suscripción creada, una vez completado
`expires_at`	datetime	Fecha de expiración de la sesión

Flujo

Creas la sesión con POST /v1/checkout-sessions, indicando el plan_id, el cycle y el cliente (nuevo con customer o existente con customer_id), más success_url y cancel_url.
Rediriges a tu usuario a la url devuelta.
Tu cliente completa el pago en la página hospedada por Rekurra.
Rekurra redirige a success_url (o cancel_url si abandona) y dispara el webhook subscription.created.

Ver el paso a paso en Crear una suscripción y la referencia completa en API → Checkout sessions.

Metadata

Puedes enviar un objeto metadata propio (pares clave-valor, máx. 60 KB serializado) al crear la checkout session. Ese metadata no se pierde al completarse el pago: queda guardado en la Subscription resultante y se repite en data.metadata de cada webhook que dispares para ella de ahí en adelante. Es la forma de correlacionar el checkout con tu propio pedido o usuario. Ver API → Checkout sessions → Crear una sesión de checkout y Webhooks → metadata en cada evento.

Método de pago Saldo prepago