Skip to main content

​
Escenario

Suscripciones, membresías, servicios por pago mensual. El usuario autoriza una vez y Zonapagos cobra periódicamente.
Los pagos recurrentes aplican típicamente a tarjeta de crédito. La disponibilidad depende de tu configuración comercial y del acuerdo con la franquicia. Coordina con tu gerente de cuenta antes de implementar.

​
Códigos de configuración

​
int_codigo: 113
string
required
Habilita recurrencias. "1" = habilitado.
​
int_codigo: 114
string
required
Plazo total de la recurrencia en meses. Ej: "12" = 12 meses.
​
int_codigo: 115
string
required
Frecuencia del cobro en meses. Ej: "1" = cada mes, "3" = trimestral.

​
Ejemplo: suscripción mensual por 12 meses

Resultado: el usuario autoriza el primer cobro en el ciclo de pago; Zonapagos programa 11 cobros adicionales (uno por mes) hasta completar 12.

​
Ejemplo: trimestral por 2 años

Resultado: 8 cobros trimestrales a lo largo de 24 meses.

​
Consideraciones

Tu comercio no inicia cada cobro recurrente. Zonapagos lo hace automáticamente según la programación. Tu backend recibe una notificación / callback por cada cobro ejecutado.[Pendiente con TI: documentar formalmente el flujo de notificación para cobros recurrentes — el PDF v6.0 no lo detalla.]
Cumplimiento legal: en Colombia, los cobros recurrentes deben ser claramente comunicados al usuario. Asegúrate que tu checkout muestre el plazo total y la frecuencia antes de que autorice.
Cancelación: el usuario debe poder cancelar su suscripción. Expón un endpoint de cancelación y notifica a ZonaPagos. Los detalles operativos los coordina tu área comercial.
Si la tarjeta expira o es cancelada durante el ciclo de vida de la recurrencia, los cobros subsecuentes fallarán. Maneja ese caso avisando al usuario vía email para que actualice el medio de pago.

​
Ver también

Contacto

Coordina recurrencias con tu gerente comercial antes de producción.

AdicionalesConfiguracion

Catálogo completo.