Estados de cuenta y cobranza

El ciclo de facturación

Cada cuenta cierra su ciclo según las reglas del programa:

• Anclado a un día del mes (billing_anchor: "1" a "31", o "nearest"): el ciclo cierra siempre ese día. Es la opción recomendada — todos tus clientes facturan el mismo día.
• Por días corridos (billing_cycle_days, por defecto 30): cada ciclo dura N días desde el cierre anterior.

Al cerrar el ciclo, Venti genera automáticamente el Statement:

{
  "id": "stmt_Xk3mR7vQpL9wN2sJhT5yBc4d",
  "object": "statement",
  "status": "closed",
  "period_started_at": "2026-07-01T00:00:00.000Z",
  "period_ended_at": "2026-08-01T00:00:00.000Z",
  "opening_balance": 0,
  "closing_balance": -45990,
  "total_due": 45990,
  "minimum_due": 11498,
  "due_at": "2026-08-11T00:00:00.000Z",
  "repayment_checkout_id": "chk_9WpL2mK4vR7xT3nQ8sYbF6dA",
  "paid_at": null
}

• total_due es la deuda al cierre (−closing_balance). Si el cliente no debe nada, el statement nace paid y no se genera cobro.
• minimum_due se calcula según el min_payment_type del programa: full (todo), percentage (un % del total) o fixed (monto fijo, o el total si es menor).
• due_at es el cierre más los grace_period_days del programa.

Cómo paga el cliente

Junto con el statement, Venti crea su checkout de pago (repayment_checkout_id): un checkout normal, restringido a medios de pago externos (tarjetas, transferencia, etc.). El cliente lo recibe por dos vías, sin que tengas que hacer nada:

1. Email automático al cierre del ciclo, con los montos, el vencimiento y el botón de pago.
2. Su billetera Venti (pay.ventipay.com/wallet → Cuentas), donde ve cada estado de cuenta con su botón "Pagar".

También puedes cobrar por tus propios canales: lee repayment_checkout_id del statement y comparte el link https://pay.ventipay.com/checkout/{id}.

❗

Una cuenta nunca puede pagar su propio estado de cuenta. El checkout de pago no ofrece la cuenta como medio de pago — sería pagar deuda con más deuda. Esta regla se aplica en el servidor y no es configurable.

Cuándo llega el dinero a tu balance

Este es el único momento en que entra dinero real. Cuando el checkout de pago se paga:

1. Se registra un movimiento repayment en el libro mayor: la deuda del cliente baja y su cupo se restituye.
2. El statement pasa a paid.
3. El monto se abona a tu balance de Venti menos las comisiones estándar de procesamiento del medio de pago usado — igual que cualquier otra venta. No hay comisiones adicionales del producto en esta fase.

En tus transacciones de balance verás el abono asociado al pago del checkout de cobro, no a las compras originales — las compras con cuenta nunca tocan tu balance.

Estados de un statement

Consulta los statements de una cuenta con GET /statements?financial_account_id=fa_..., o todos los vencidos de tu comercio con GET /statements?status=overdue.

Riesgo y morosidad

Venti no asume riesgo de crédito: la deuda es tu cuenta por cobrar y la morosidad es tu pérdida. Herramientas a tu disposición:

• Congela la cuenta (status: "frozen") para bloquear nuevas compras mientras la deuda siga impaga — los ciclos siguen cerrando y el cliente sigue pudiendo pagar.
• Monitorea GET /statements?status=overdue desde tu backoffice.
• El libro mayor define los tipos de movimiento interest y fee; hoy ningún flujo los genera automáticamente.