Cuentas Venti
Emite cuentas de crédito de marca propia para tus clientes. Tú defines las reglas; Venti opera el libro mayor, los estados de cuenta y la cobranza.
¿Qué es Cuentas Venti?
Cuentas Venti te permite ofrecer crédito de marca propia a tus clientes, sin construir infraestructura financiera. Tú decides a quién le otorgas una cuenta y con qué cupo; tus clientes pagan tus checkouts con su cuenta como un medio de pago más, y pagan su deuda cada ciclo a través de un checkout normal de Venti.
Venti opera todo lo demás: el libro mayor inmutable, la verificación de cada pago, el cierre de ciclos, los estados de cuenta y la cobranza.
DisponibilidadCuentas Venti se habilita por comercio. Si quieres usarlo, contáctanos para activarlo en tu cuenta.
¿Cuándo usarlo?
Usa Cuentas Venti cuando quieras fidelizar y aumentar la recompra ofreciendo crédito con tu propia marca —una cuenta o "tarjeta de la casa"— y controlar tú a quién le das cupo y bajo qué reglas. A diferencia de Créditos en cuotas, acá el crédito es tuyo: tú asumes el riesgo de la deuda y Venti opera la contabilidad, los estados de cuenta y la cobranza por ti.
El principio detrás del producto
Una cuenta es una promesa tuya, no dinero. Cuando un cliente paga con su cuenta, no se mueve dinero real: la venta se registra como deuda del cliente contigo, en el libro mayor que Venti administra. Por eso una compra con cuenta no genera abonos a tu balance en Venti.
El dinero real entra una sola vez: cuando el cliente paga su estado de cuenta. En ese momento Venti abona el monto a tu balance, menos las comisiones estándar de procesamiento.
flowchart LR
A["Compra con cuenta"] --> A2["deuda del cliente<br/>(sin movimiento de dinero)"]
B["Devolución"] --> B2["abono al cupo<br/>(sin movimiento de dinero)"]
C["Pago de estado de cuenta"] --> C2["abono a tu balance<br/>(único movimiento de dinero real)"]
Los objetos
| Objeto | Prefijo | Qué representa |
|---|---|---|
Program | prog_ | Las reglas de tus cuentas: moneda, límites de crédito, ciclo de facturación y pago mínimo. Los clientes ven el nombre del programa como el nombre de su cuenta (ej: "VentiCard"). |
FinancialAccount | fa_ | La cuenta de un cliente bajo un programa. Una por cliente y programa. Mantiene el cupo, el saldo y el disponible. |
AccountEntry | ae_ | Un movimiento inmutable del libro mayor: purchase, refund, repayment, adjustment, etc. Cada movimiento referencia su transacción de origen (checkout_id, statement_id). |
Statement | stmt_ | El cierre de un ciclo de facturación: total a pagar, pago mínimo, vencimiento y su checkout de pago. |
El saldo, en convención de libro mayor
Una cuenta lleva un cupo (credit_limit), un saldo contable (posted_balance) y un disponible (available). Hay una convención que conviene tener presente antes de leer los montos:
Elposted_balancees negativo cuando hay deuda. Un cliente que te debe $30.000 tieneposted_balance: -30000, y su disponible escredit_limit + posted_balance − held_amount.
El detalle de cada campo de saldo está en la sección Cuentas Venti del API Reference; cómo cierra el ciclo y cuándo entra el dinero, en Estados de cuenta y cobranza.
El libro mayor es inmutable
Los AccountEntry nunca se editan ni se eliminan. Las correcciones se registran como movimientos nuevos (reversal, adjustment) que referencian al movimiento original. Esto te da una pista de auditoría completa de cada peso que entró y salió de cada cuenta.
Siguientes pasos
- Inicio rápido — tu primer programa y tu primera cuenta en 5 llamadas.
- Estados de cuenta y cobranza — cómo cierra el ciclo y cómo llega el dinero a tu balance.
- Webhooks y conciliación — cómo integrar tu backoffice.
- La referencia completa de la API está en la sección Cuentas Venti del API Reference.
Updated about 1 month ago