ConceptosCheckout

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

CampoTipoDescripción
idstringIdentificador único de la sesión
urlstringURL hospedada (https://checkout.rekurra.dev/{id}) a la que rediriges a tu cliente
statusstringopen · complete · expired
subscription_idstring?Suscripción creada, una vez completado
expires_atdatetimeFecha de expiración de la sesión

Flujo

  1. 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.
  2. Rediriges a tu usuario a la url devuelta.
  3. Tu cliente completa el pago en la página hospedada por Rekurra.
  4. Rekurra redirige a success_url (o cancel_url si abandona) y dispara el webhook subscription.created.

Ver el paso a paso en Checkout hospedado y la referencia completa en API → Checkout sessions.