¿Qué son las Suscripciones?

Las suscripciones te permiten cobrar automáticamente a un cliente de forma recurrente: el cliente inscribe su tarjeta una vez y Venti lo cobra en cada ciclo, sin que nadie tenga que hacer nada. Sirven para membresías, servicios mensuales, cajas por suscripción, arriendos — cualquier cobro que se repite.

Los cobros automáticos funcionan con tarjetas (crédito, débito y prepago inscritos). Las transferencias bancarias requieren la intervención del cliente en cada pago, por lo que no soportan cobros automáticos.

¿Cuándo usarlo?

Usa suscripciones para cualquier cobro que se repite en el tiempo: membresías, software por mensualidad, cajas por suscripción, arriendos o donaciones recurrentes. El cliente autoriza su tarjeta una vez y Venti se encarga de cobrar cada ciclo, reintentar los pagos fallidos y avisarte por webhook. Para un cobro único usa Checkout; para financiar una compra en cuotas, Créditos en cuotas.

El principio detrás del producto

Una suscripción es una máquina de generar cobros: en cada ciclo emite una nota de venta (Invoice) por el monto del período y la carga a la tarjeta inscrita. Cada cobro exitoso es un pago normal de Venti — abona a tu balance menos las comisiones estándar de procesamiento, igual que cualquier venta.

flowchart TD
    S["Suscripción"] --> I["cada ciclo genera una nota de venta"] --> T["se carga a la tarjeta"]
    T -->|pagada| P["Payment normal → abono a tu balance<br/>(menos comisiones)"]
    T -->|falla| F["past_due → reintentos"] --> U["unpaid o canceled"]

Las notas de venta también existen por sí solas: puedes crear una suelta para un cobro puntual y enviarla por email con su link de pago, o cargarla a un medio de pago inscrito. Eso está en Notas de venta.

Los objetos

Objeto	Prefijo	Qué representa
`Product`	`prod_`	Un bien o servicio con precio y moneda. `pricing_type: recurrent` se cobra en cada ciclo; `one_time` solo en el primer cobro (ej. costo de instalación). Si cambias su precio, el cambio se propaga a los próximos cobros.
`TaxRate`	`txr_`	Un impuesto porcentual. `inclusive: true` ya está dentro del precio (solo se desglosa); `inclusive: false` se agrega sobre el subtotal. Se aplica en cada cobro.
`Plan`	`pl_`	Una plantilla de suscripción con link de pago compartible (`url`): cada cliente que lo abre y se suscribe genera su propia `Subscription` con la configuración del plan.
`Subscription`	`sub_`	El cobro recurrente a un cliente concreto: intervalo, período vigente, estado, medio de pago y productos. También tiene su propio link (`url`) para dirigirla a un cliente específico.
`Invoice`	`inv_`	Una nota de venta: el documento de cobro de un período (generado automáticamente) o de un cobro puntual (creado por ti).

Su ciclo de vida, en resumen

Una suscripción nace incomplete, pasa a active (o trialing si tiene prueba) cuando el cliente la autoriza, y desde ahí Venti cobra cada ciclo. Si un cobro falla entra en past_due y se reintenta; agotados los reintentos termina en unpaid o canceled. Puedes pausarla (suspended, con notas de venta por $0) y reactivarla cuando quieras.

Los montos se calculan siempre a partir de los productos e impuestos asociados, en unidades menores de la moneda. Cómo se arma cada período —anclaje mensual, prorrateo del primer ciclo, las 14 frecuencias de cobro— y cuándo se mueve el dinero está en Ciclo de vida. La lista completa de campos y estados vive en la sección Subscriptions del API Reference.

Siguientes pasos

Inicio rápido — tu primer producto, plan y suscripción con cobro real.
Ciclo de vida — períodos, prorrateo, reintentos, pausa y cancelación.
Notas de venta — cobros puntuales con link de pago.
Webhooks y conciliación — cómo integrar tu backoffice.
Reglas y errores — todo lo que el servidor exige.
La referencia completa de la API está en la sección Subscriptions del API Reference.