¿Qué es Créditos en cuotas?

Créditos en cuotas te permite ofrecer financiamiento (BNPL, Buy Now Pay Later) a tus clientes sin asumir riesgo de crédito. El cliente paga la primera cuota hoy con su tarjeta y el resto en cuotas programadas; tú recibes el monto completo de la venta por adelantado, como cualquier otro pago.

Venti hace todo lo demás: evalúa y aprueba el crédito al momento del pago, cobra las cuotas restantes al cliente, gestiona los recordatorios y la morosidad, y asume la pérdida si el cliente no paga.

🚧
Disponibilidad
Los programas de cuotas se configuran por comercio en tus medios de pago con tarjeta. Si quieres ofrecer cuotas, contáctanos para activarlos en tu cuenta.

El principio detrás del producto

Un Checkout puede ser autorizado por uno de dos tipos de transacciones: un Payment (pago directo) o un Loan (financiamiento). Cuando el cliente elige pagar en cuotas, la transacción que paga tu checkout es un Loan:

Cliente paga la primera cuota hoy   →  crédito autorizado, checkout pagado
Venti te abona el monto completo    →  menos comisiones, en tu calendario habitual
Cliente paga las cuotas restantes   →  a Venti; no afectan tu balance

Para ti, una venta en cuotas es económicamente igual a una venta con pago directo: recibes el total de una vez. Lo que el cliente pague (o deje de pagar) después es entre el cliente y Venti.

Los objetos

Objeto	Prefijo	Qué representa
`Loan`	`loan_`	El financiamiento otorgado a un cliente. Autoriza un `Checkout` igual que lo haría un `Payment`: el checkout pagado queda con `successful_object: "loan"` y `loan_id`. También puede existir sin checkout, como préstamo directo con su propia página de pago (`url`).
`Installment`	`inst_`	Una cuota individual del préstamo: monto (`amount`, interés incluido), vencimiento (`due_at`), estado y cargos por atraso.

Cómo se leen los campos clave

amount — el monto del préstamo (la venta), en unidades menores de la moneda. No incluye sobrecargos ni intereses.
installment_program — el programa de cuotas elegido (ej: cl_1n2l_bw). Define la estructura del financiamiento.
installments_plan — el resumen legible del plan: { "type": "bnpl", "count": 3, "interval": "biweek" }.
interest_amount / interest_rate — el interés total del financiamiento (lo paga el cliente, repartido en sus cuotas). Muchos programas son sin interés (0).
surcharge_amount / surcharge_tax — sobrecargo al cliente si tu configuración lo define. Se suma a las cuotas del cliente; no afecta tu abono.
fee — la comisión de Venti por la transacción, en unidades menores.
authorized / authorized_at — si el crédito se concretó. La aprobación (status: "succeeded") es la evaluación crediticia; la autorización es el cobro exitoso de la primera cuota. Solo un préstamo autorizado paga tu checkout y genera abono.
refunded / refunded_amount — devoluciones acumuladas (ver reglas).
La suma de las cuotas del cliente = amount + sobrecargo (con IVA) + interés.

Estados de un préstamo

Estado	Significado
`open`	Creado, pendiente de que el cliente complete el financiamiento.
`succeeded`	Aprobado por la evaluación crediticia. Con `authorized: true` cuando además se cobró la primera cuota.
`failed`	No se pudo aprobar, generalmente por una razón de sistema (`status_reason`).
`canceled`	Cancelado — por ejemplo, expiró sin autorizarse.

Un préstamo aprobado que no logra autorizarse (la primera cuota no se pudo cobrar) vuelve a intentarse o expira: se cancela automáticamente a los 20 minutos. Un préstamo open sin actividad se cancela después de 1 hora.

Estados de una cuota

Estado	Significado
`open`	Pendiente, se cobrará automáticamente en su vencimiento (`due_at`).
`paid`	Pagada (`paid_at` indica cuándo).
`past_due`	Venció y el cobro automático falló. Empieza a acumular cargos por atraso.
`uncollectible`	Dada por incobrable (gestión de Venti; no te afecta).
`canceled`	Cancelada — típicamente por una devolución del préstamo.

Siguientes pasos

Inicio rápido — tu primera venta en cuotas, del checkout al préstamo.
Cuotas y cobranza — cuándo llega tu abono y cómo cobra Venti las cuotas.
Webhooks y conciliación — cómo integrar tu backoffice.
Reglas y errores — las reglas del producto y sus códigos de error.
La referencia completa de la API está en la sección Loans del API Reference.