Skip to main content

​
Estado actual del sandbox

Al cierre de esta documentación, ZonaPagos ofrece dos niveles de prueba con limitaciones:
  1. Formulario web dummie (disponible): permite probar el flujo visual completo.
  2. API REST sandbox público (no disponible): dummie_ciclopago/api/* retorna HTTP 404.
[Pendiente con TI: habilitar endpoint REST sandbox público para desarrolladores.]

​
Opción A: Formulario web dummie

​
URL y credenciales

URL: https://www.zonapagos.com/dummie_ciclopago/FormulariosWeb/InicioPago_Dummie.aspx

int_id_comercio: 31416
Usuario:         UsuarioDef
Clave:           PagosN3*)
Código servicio: 2701

​
Qué puedes probar

El flujo visual completo del ciclo de pago.
Cómo se ve el formulario con tus configuraciones (pagos mixtos, desactivar medios, etc.).
La UX del usuario.
Los distintos medios de pago disponibles.

​
Qué NO puedes probar

El API REST directamente (los endpoints dummie_ciclopago/api/* no existen).
Tu integración backend real end-to-end.
La sonda (no hay pagos REST creados).
Callbacks a tu comercio.

​
Cómo usarlo

1

Abre la URL del formulario

Entra a InicioPago_Dummie.aspx en tu navegador.
2

Llena el formulario con las credenciales dummie

Usa los datos de arriba como comercio. Invéntate datos del pagador.
3

Envía y completa el ciclo

Sigue el flujo hasta el final como lo haría un usuario real.
4

Verifica el callback a tu servidor

Si configuraste URL de retorno, revisa los logs de tu servidor para ver cómo llega el callback.

​
Opción B: Credenciales de preproducción

Para probar el API REST realmente, contacta a ZonaPagos y solicita un int_id_comercio de preproducción.
1

Solicita por email

Escribe a soporte@zonapagos.com con asunto [PREPRODUCCIÓN REST] indicando:
  • Tu comercio (si ya es cliente).
  • El tipo de integración que vas a hacer.
  • Fechas esperadas de salida a producción.
2

Recibe credenciales temporales

Te asignan un int_id_comercio, usuario y clave que funcionan sobre el dominio de producción pero con transacciones marcadas como prueba.
3

Pruebas con montos bajos

Típicamente se trabaja con 1.000−1.000 - 5.000 COP para minimizar riesgo y costos.
4

Migra a producción real

Una vez validado, te entregan credenciales productivas.

​
Opción C: Pruebas con Postman

Si solo quieres ver cómo se comportan los endpoints ante distintos inputs (sin completar pagos reales), usa la colección Postman. Responderá con errores (int_codigo: 2) porque las credenciales dummie no funcionan sobre el API REST, pero al menos verificas que tu estructura JSON esté correcta.

​
Monto mínimo y máximo

No documentado en el instructivo oficial v6.0. Los límites dependen de:
  • El medio de pago (cada banco/franquicia tiene sus propios límites).
  • Tu acuerdo comercial con ZonaPagos.
  • La configuración antifraude.
Como referencia:
  • PSE: desde ~$1.000 COP hasta el límite diario de la cuenta del pagador.
  • TC: desde ~$1.000 COP hasta el cupo disponible de la tarjeta.
  • Presencial: varía según el convenio.
Confirma los límites exactos con tu gerente comercial.

​
Datos de prueba típicos

Para tests de desarrollo, usa estos datos (funcionan en el formulario dummie): 
{
  "cliente_aprobado": {
    "documento": "1020304050",
    "tipo_id": "1",
    "email": "test@ejemplo.com",
    "nombre": "Juan",
    "apellido": "Perez",
    "telefono": "3001234567"
  },
  "monto_tipico": 50000,
  "iva_tipico": 7983
}

​
Checklist antes de pasar a producción

Antes de solicitar credenciales productivas:
Probé el flujo visual completo en el formulario dummie.
Mi código maneja int_codigo: 2 sin crashear.
El parser de str_res_pago funciona contra respuestas simuladas.
La sonda está implementada (aunque no haya podido probarla end-to-end).
Los mensajes obligatorios al usuario están en mi UI.
Completé el checklist de producción.

​
Ver también

Ambientes

URLs y endpoints.

Contacto

Solicitar credenciales.