Actores
Comercio
Tu backend y frontend. Inicia pagos, recibe callbacks, verifica estados y entrega el producto.
Usuario pagador
La persona que compra. Pasa del checkout del comercio al ciclo de pago de Zonapagos.
Zonapagos
Orquesta el ciclo transaccional. Hostea el formulario de pago, habla con las redes y notifica al comercio.
Red financiera
ACH-PSE, franquicias de tarjeta (Credibanco, Redeban), convenios (Bancolombia, Codensa, etc.).
Flujo end-to-end
Datos que viajan
| En el request a Zonapay | NO se envía | En el response |
|---|---|---|
| ID del pedido | ❌ Número de tarjeta | URL del ciclo de pago |
| Monto y descripción | ❌ CVV | Estado final (en VerificacionPago) |
| Datos del cliente (no sensibles) | ❌ Credenciales bancarias | CUS, franquicia, últimos 4 dígitos |
| Configuración del pago | ❌ Tokens bancarios | Datos del pagador |
Modelos de operación
Zonapay opera bajo los dos modelos de negocio de Zonapagos:- Gateway
- Agregador
El comercio tiene contrato directo con el banco o franquicia. Zonapay enruta técnicamente.
- Tarifas negociadas directamente con el banco.
- Liquidación del banco al comercio.
- Mayor control operativo, mayor responsabilidad en conciliación.
¿Qué hace Zonapay por ti?
Procesa pagos con múltiples medios en una sola integración.
Hostea el ciclo de pago (no necesitas construir formularios con campos de tarjeta).
Notifica estados y te entrega datos para reconciliación.
Envía al cliente un comprobante del pago por correo.
¿Qué NO hace?
- No gestiona inventario ni reserva stock.
- No envía el email de “gracias por tu compra” con los detalles de tu producto (eso lo envías tú).
- No reintenta automáticamente pagos rechazados (el usuario reintenta desde tu checkout).
Próximo paso
Ambientes
URLs y credenciales.
Quickstart
Tu primer request en 10 minutos.