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

"AdicionalesConfiguracion": [
  { "int_codigo": 50,  "str_valor": "2701" },
  { "int_codigo": 113, "str_valor": "1" },
  { "int_codigo": 114, "str_valor": "12" },
  { "int_codigo": 115, "str_valor": "1" }
]
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

"AdicionalesConfiguracion": [
  { "int_codigo": 50,  "str_valor": "2701" },
  { "int_codigo": 113, "str_valor": "1" },
  { "int_codigo": 114, "str_valor": "24" },
  { "int_codigo": 115, "str_valor": "3" }
]
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.