Quentli ofrece dos modalidades principales para cobrar desde tu sistema. Elige una para cada caso de uso antes de integrar: las dos modalidades pueden coexistir, pero no debes usar ambas para representar el mismo adeudo.
Crea facturas cuando Quentli deba conocer el adeudo
Esta modalidad sincroniza los adeudos de tu sistema con Quentli. Crea un cliente, una suscripción cuando corresponda y una factura por cada importe que debas cobrar.
Quentli conserva el estado de cada factura y puede encargarse de cobrar un método de pago guardado, ofrecer alternativas como efectivo o transferencia, enviar recordatorios y notificar los pagos a tu sistema.
Úsala cuando necesites:
- Programar uno o varios cobros futuros.
- Cobrar automáticamente una tarjeta guardada.
- Ofrecer más de un método de pago para el mismo adeudo.
- Conocer desde tu sistema cuándo un adeudo se pagó, se pagó parcialmente o falló un intento de cobro.
- Usar los recordatorios y la cobranza de Quentli.
Tu sistema sigue siendo la fuente de verdad de la deuda comercial. Guarda la relación entre tu identificador y los IDs de customer, subscription e invoice de Quentli, y mantén ambos sistemas sincronizados mediante webhooks.
Una factura en Quentli representa un adeudo o solicitud de pago; no representa un pago completado.
- Recopila la tarjeta del cliente con una sesión de inscripción, si usarás cargos recurrentes.
- Crea una suscripción y asocia el método de pago guardado.
- Crea una factura por cada adeudo programado.
- Obtén las instrucciones de efectivo o transferencia cuando deban estar disponibles.
- Consume los webhooks para reflejar los pagos en tu sistema.
Sigue la guía Sincroniza facturas en Quentli para implementar este flujo.
Crea sesiones de pago cuando solo necesitas cobrar ahora
Una sesión de pago genera una URL de checkout para un importe específico. El pago puede quedar asociado a un cliente, pero la sesión no crea ni conserva un adeudo programado en Quentli.
Úsala cuando:
- Tu sistema ya administra por completo los adeudos, vencimientos y cobranza.
- Necesitas enviar un link de pago para un cobro puntual.
- No necesitas cargos futuros, recordatorios ni alternativas de pago asociadas a un adeudo en Quentli.
- Quieres recibir el resultado del pago por webhook y actualizar tu sistema.
En esta modalidad, tu sistema es la única fuente de verdad del adeudo. Quentli procesa el pago y te informa el resultado mediante PAYMENT_COMPLETED.
Sigue la guía de Sesiones de pago para crear el checkout.
Compara las modalidades
No crees una factura y una sesión de pago para cobrar el mismo importe. Eso crea dos objetos de cobro independientes y
puede provocar cobros duplicados.
Combina ambas modalidades solo para casos distintos
Puedes usar facturas para mensualidades o créditos programados y sesiones de pago para conceptos extraordinarios. Cada importe debe tener un único flujo de cobranza y una fuente de verdad claramente definida. 
