¿Cómo pagar un cobro vía API? | Treli Centro de Ayuda

Para los cobros de tipo factura, si el cliente tiene registrado un método de pago, puedes intentar realizar el cobro directamente a ese método.

Para cobros de suscripción con collection_method=charge, Treli los crea e intenta cobrarlos automáticamente según tus configuraciones de reintentos. Sin embargo, puedes forzar un intento de cobro en cualquier momento usando este endpoint.

Endpoint 'Pagar un cobro'

Parámetros clave

Opción #1 - Cobrar a un método pago registrado

Usa este flujo cuando el cliente ya tiene un método de pago tokenizado en Treli y quieres ejecutar el cobro inmediatamente.

Pasos:

Obtén el ID del cobro: Puedes obtenerlo desde el endpoint 'Listar cobros'.
Obtén el ID del método de pago del cliente: El cliente debe tener un método de pago registrado. Puedes consultarlo con el endpoint de 'Listar métodos de pago de un cliente' enviando el id del cliente.
Ejecuta el request: Envía el id del cobro en el path y el payment_method en el body.

Opción #2 - Registrar un pago por fuera de Treli

Usa este flujo cuando el cliente ya pagó por un canal externo a Treli (transferencia bancaria, efectivo, etc.) y necesitas reflejar ese pago en la plataforma para cambiar el estado del cobro a pagado.

Pasos:

Obtén el ID del cobro: Puedes obtenerlo desde el endpoint 'Listar cobros'.
Opcional, envía la fecha de pago: Confirma la fecha en que el cliente realizó el pago externo. La enviarás en el campo paid_date con formato YYYY-MM-DD
Ejecuta el request: Con paid_out_of_band: true Treli cambiará el estado del cobro a 'Pagado' sin intentar ningún cargo a un método de pago.