> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quentli.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tipos de integración

> Decide si debes sincronizar adeudos con Quentli o crear sesiones de pago para cobros puntuales.

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.

<Tip>Una factura en Quentli representa un adeudo o solicitud de pago; no representa un pago completado.</Tip>

El flujo habitual es:

1. Recopila la tarjeta del cliente con una sesión de inscripción, si usarás cargos recurrentes.
2. Crea una suscripción y asocia el método de pago guardado.
3. Crea una factura por cada adeudo programado.
4. Obtén las instrucciones de efectivo o transferencia cuando deban estar disponibles.
5. Consume los webhooks para reflejar los pagos en tu sistema.

Sigue la guía [Sincroniza facturas en Quentli](/api/guias/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](/api/guias/sesiones-de-pago) para crear el checkout.

## Compara las modalidades

| Necesidad                                              | Facturas | Sesiones de pago |
| ------------------------------------------------------ | -------- | ---------------- |
| Cobro puntual                                          | Sí       | Sí               |
| Programar varios vencimientos                          | Sí       | No               |
| Cargos recurrentes a una tarjeta guardada              | Sí       | No               |
| Referencias de efectivo o transferencia para un adeudo | Sí       | No               |
| Recordatorios y reintentos de cobranza                 | Sí       | No               |
| Quentli conserva el estado del adeudo                  | Sí       | No               |
| Tu sistema conserva el único estado del adeudo         | No       | Sí               |

<Warning>
  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.
</Warning>

## 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.