Esta guía describe el flujo completo para guardar de forma segura el método de pago de un cliente utilizando la API de Treli. Una vez almacenado, el método de pago puede usarse en cobros posteriores sin que el cliente deba ingresarlo de nuevo.
Resumen del flujo
Paso #1: Crear cliente
Utiliza el endpoint 'Crear cliente' para registrar al cliente en Treli y obtener su customer_id.
¿El cliente ya existe?
Si el cliente fue creado previamente, no es necesario volver a crearlo. Simplemente utiliza el customer_id que ya tienes creado en Treli y continúa con el Paso 2.
Paso #2: Crear sesión de checkout en modo 'Setup'
Utiliza el endpoint 'Crear sesión de checkout' enviando el parámetro mode: "setup". Treli devolverá una URL de checkout donde el cliente podrá ingresar y guardar su método de pago.
Parámetros claves
Opcional: Confirmar el método de pago mediante webhook
Una vez que el cliente finaliza la sesión de checkout y agrega su método de pago, puedes escuchar el evento que Treli envía automáticamente a tu punto de conexión configurado el evento checkout_session_completed.
Crea en Treli un Webhook y configura un endpoint en tu servidor para recibir el el evento
checkout_session_completed.
Del payload del webhook, extrae el campo
payment_method. Este es el ID del método de pago que el cliente acaba de agregar.
¿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.