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

🚧
Disponibilidad
Cuentas Venti se habilita por comercio. Si quieres usarlo, contáctanos para activarlo en tu cuenta.

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.

Compra con cuenta        →  deuda del cliente        (sin movimiento de dinero)
Devolución               →  abono al cupo            (sin movimiento de dinero)
Pago de estado de cuenta →  abono a tu balance       (ú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 (`credit_limit`), el saldo (`posted_balance`) y el disponible (`available`).
`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.

Cómo se leen los saldos

credit_limit — el cupo total de la cuenta, en unidades menores de la moneda del programa.
posted_balance — el saldo contable. Negativo cuando hay deuda (convención de libro mayor): un cliente que debe $30.000 tiene posted_balance: -30000.
held_amount — monto reservado por pagos en curso (entre que el cliente inicia el pago y lo confirma).
available — lo que el cliente puede gastar: credit_limit + posted_balance − held_amount.

Estados de una cuenta

Estado	Significado
`active`	Operativa: puede comprar y pagar.
`frozen`	Congelada: no puede comprar, pero sus ciclos siguen cerrando y su deuda sigue siendo cobrable.
`closed`	Cerrada definitivamente. Requiere saldo cero.

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.