¿Qué es un Checkout?

Un Checkout es una intención de cobro: tú defines qué estás cobrando (ítems y moneda) y Venti genera una página de pago alojada (url) donde tu cliente elige el medio de pago y confirma. No integras pasarelas ni manejas datos de tarjetas: creas un objeto, compartes un link y escuchas un webhook.

flowchart LR
    A["POST /checkouts"] --> B["compartes la url"] --> C["el cliente paga"] --> D(["webhook checkout.paid"])

¿Cuándo usarlo?

Usa un checkout siempre que necesites cobrar por única vez: una venta en tu ecommerce sin integrar una pasarela, un link de pago que envías por WhatsApp o email, o un QR para cobrar de forma presencial. Es también la base de los demás productos —cuotas, suscripciones y cuentas— que por debajo se cobran a través de un checkout.

Para cobros recurrentes, usa Suscripciones.
Para ofrecer cuotas, usa Créditos en cuotas.
Para crédito de marca propia, usa Cuentas Venti.

El principio detrás del producto

Un checkout no es dinero: es una intención. El dinero existe recién cuando el cliente confirma y el cobro se materializa en otro objeto, según el medio de pago que eligió:

Payment — medios de pago externos: tarjetas, transferencia, etc.
Loan — compra en cuotas BNPL de Créditos en cuotas.
AccountEntry — pago con una cuenta de crédito de Cuentas Venti (no mueve dinero real).

Este es el mismo modelo mental que comparten todos los productos de cobro; el mapa completo está en Cómo funcionan los pagos. Un checkout pagado te dice exactamente con qué se pagó —lo verás al integrar los webhooks en Ciclo de vida y dinero.

Los objetos

Objeto	Prefijo	Qué representa
`Checkout`	`chk_`	La intención de cobro y su página de pago (`url`). Define ítems, moneda y redirecciones.
`Payment`	`pay_`	El cargo a un medio de pago externo. Registra autorización, captura, comisión y liquidación.
`Charge`	`ch_`	Un intento de cargo en el adquirente. Un `Payment` puede tener varios; el exitoso queda en `successful_charge_id`.
`Refund`	`ref_`	Una devolución total o parcial de un pago.
`PaymentButton`	`pb_`	Un link de pago reutilizable que genera un checkout nuevo por cada cliente que lo abre.
`Coupon`	`cpn_`	Un descuento por código, aplicable a checkouts o suscripciones.

Su ciclo de vida, en resumen

Un checkout nace unpaid y llega a uno de tres desenlaces: paid cuando el cliente completa el pago, expired si vence antes de pagarse (por defecto, 2 semanas), o canceled si lo cancelas tú. El pago que lo salda tiene su propio ciclo de autorización y captura, que puedes hacer en uno o dos pasos.

Cuándo llega el dinero a tu balance, con qué comisiones, cómo capturar, reembolsar, y cómo leer cada monto está en Ciclo de vida y dinero. La lista completa de campos y estados vive en la sección Payments del API Reference.

Siguientes pasos

Inicio rápido — tu primer cobro y tu primer reembolso en 5 llamadas.
Ciclo de vida y dinero — cuándo llega el dinero a tu balance y con qué comisiones.
Webhooks y conciliación — cómo integrar tu backend.
Reglas y errores — las reglas del producto y sus códigos de error.
La referencia completa de la API está en la sección Payments del API Reference.