¿Cómo crear suscripciones vía API por sesión de checkout?

Esta guía describe el flujo completo para crear una nueva suscripción para un cliente mediante la API de Treli: genera un enlace hasta confirmar la activación y ajustar la próxima fecha de renovación si es necesario.

Resumen del flujo

Crea una sesión de checkout

Utiliza el endpoint 'Crear sesión de checkout' con el parámetro mode: "subscription" para generar un enlace. Al completarlo, el cliente realizará un pago y activara una suscripción.

Utiliza el endpoint Crear sesión de checkout con los parámetros requeridos.
Treli retorna una URL de checkout. Redirige al cliente a esa URL para que complete el pago y active su suscripción.

Parámetros clave

Si el cliente ya se encuentra creado en Treli y envías el ID del cliente: customer el cliente estará autenticado en la sesión de checkout estarán disponible sus métodos de pagos anteriormente tokenizados.

Opcional: Escuchar eventos

Cuando el cliente completa la sesión de checkout y su suscripción queda activa, Treli envía el evento subscription_activated a tu punto de conexión.

Además del evento subscription_activated, Treli envía el evento collection.paid cada vez que un cobro asociado a la suscripción es pagado exitosamente, ya sea el cobro de activación inicial o los cobros de renovaciones.

Utiliza collection.paid para registrar pagos recibidos y mantener el historial de cobros actualizado en tu integración, tanto para activaciones como para renovaciones futuras.

Opcional: Actualizar la fecha de renovación

Una vez confirmada la activación, puedes ajustar la próxima fecha de renovación de la suscripción utilizando el endpoint 'Actualizar suscripción'.

Esto es útil cuando necesitas sincronizar el ciclo de cobro con una fecha específica.

Obtén el subscription_id desde el payload del evento subscription_activated.
Llama al endpoint 'Actualizar suscripción' con la nueva fecha de renovación en el campo next_renewal_date enviando el ID de la suscripción id.

¿Cómo verificar que un evento fue enviado por Treli?

Protege tu punto de conexión, debes proteger tu integración verificando que todas las solicitudes de webhook provengan realmente de Treli. Para ello, tu controlador debe validar la firma incluida en cada evento.