Cómo funcionan los pagos en Venti

Todos los productos de cobro de Venti —pagos con tarjeta, cuotas, suscripciones y cuentas de marca propia— comparten el mismo modelo mental. Entiéndelo una vez y sabrás leer cualquiera de ellos.

Una intención que se convierte en dinero

Con Venti no creas "un cobro" directamente. Creas un Checkout: una intención de cobro con una página de pago alojada que le compartes a tu cliente. El dinero existe recién cuando el cliente confirma y, según el medio que elija, esa intención se materializa en uno de tres objetos:

flowchart TD
    C["Checkout · una intención de cobro"] --> Q{"el cliente elige<br/>cómo pagar"}
    Q --> P["Payment<br/>tarjeta · transferencia"]
    Q --> L["Loan<br/>cuotas BNPL"]
    Q --> A["AccountEntry<br/>Cuentas Venti"]
    P --> W(["webhook checkout.paid"])
    L --> W
    A --> W
    W --> B["abono a tu balance"] --> PO["payout a tu banco"]

• Payment — el cliente pagó con un medio externo: tarjeta o transferencia bancaria.
• Loan — pagó en cuotas con Créditos en cuotas; tú recibes el total por adelantado.
• AccountEntry — pagó con su cuenta de Cuentas Venti; no mueve dinero real hasta que salda su estado de cuenta.

Un cobro exitoso abona a tu balance (menos comisiones), y ese balance se liquida a tu cuenta bancaria en un payout. Cada cambio importante te llega por webhook, para que tu sistema se entere sin preguntar.

El vocabulario compartido

Estos términos aparecen en todos los productos. Vale la pena tenerlos claros antes de integrar:

Elige tu producto

Todos parten de un checkout; se diferencian en cómo paga tu cliente y en qué pasa con el dinero después.

Cuando quieras el detalle de cada campo y endpoint, la referencia completa de la API vive en la sección Payments del API Reference.