Saltar al contenido principal

Pagos en Cuotas

Las facturas pueden ser divididas en múltiples cuotas con fechas de vencimiento individuales.

Estados de la Cuota

scheduled → pending → paid

overdue

canceled
StatusDescripción
scheduledVencimiento futuro, esperando procesamiento
pendingEl vencimiento llegó, esperando pago
paidCuota pagada
overdueVencida y no pagada
canceledCancelada (factura anulada)

Creando Cuotas

Al crear o editar una factura, informe las cuotas:

CampoDescripción
Valor (centavos)Monto de la cuota
Fecha de vencimientoFecha de pago esperada

Reglas de Validación

  • Mínimo de 2 cuotas
  • Las fechas deben ser estrictamente crecientes
  • La suma de los valores debe ser igual al total de la factura
  • La fecha de vencimiento de la factura se define como la fecha de la última cuota

Cobro de Cuotas

Procesamiento Secuencial

Las cuotas se procesan secuencialmente — cada cuota solo se cobra cuando la anterior está pagada:

  1. El worker busca cuotas con vencimiento ≤ hoy
  2. Verifica si la cuota anterior está pagada (o si es la primera)
  3. Para charge_automatically: cobra el método de pago predeterminado
  4. Vincula el pago a la cuota
  5. Si es la última cuota: factura marcada como paid

Política de NF-e por Cuota

Cuando la política de NF-e es per_installment, una nota fiscal es emitida para cada cuota pagada individualmente.

Cancelación

Cuando la factura es anulada:

  • Todas las cuotas con status scheduled o pending son canceladas
  • Las cuotas ya pagadas no son afectadas