Skip to main content

​
Ambientes

AmbienteURL base del APIUso
Producciónhttps://www.zonapagos.com/Apis_CicloPago/apiTransacciones reales.
Formulario web dummiehttps://www.zonapagos.com/dummie_ciclopago/FormulariosWeb/InicioPago_Dummie.aspxPruebas manuales del flujo visual.
API REST de pruebasSe habilita por solicitudRequiere credenciales de preproducción.

​
Endpoints principales

InicioPago

POST /Apis_CicloPago/api/InicioPago

VerificacionPago

POST /Apis_CicloPago/api/VerificacionPago
Ambos usan HTTPS y reciben / devuelven application/json.

​
Credenciales necesarias

Para operar con Zonapay necesitas:
​
int_id_comercio
integer
required
Identificador único del comercio, entero de hasta 7 dígitos.
​
str_usuario
string
required
Usuario de integración. Se usa como str_usuario en InicioPago y como str_usr_comercio en VerificacionPago.
​
str_clave
string
required
Clave de integración. Se usa como str_clave en InicioPago y como str_pwd_Comercio en VerificacionPago.Puede cambiarse desde el portal administrativo.
​
Código de servicio PSE
integer
required
Obligatorio si aceptas PSE. Se envía en AdicionalesConfiguracion con int_codigo: 50.

​
Cómo obtener credenciales

1

Contacto comercial

Escribe a soporte@zonavirtual.com.co o usa el formulario de contacto.
2

Documentación

Zonapagos es entidad vigilada. Prepara RUT, cámara de comercio, estados financieros y documentación del representante legal.
3

Definición del modelo

Se acuerda operación en Gateway o Agregador, medios de pago habilitados y tarifas.
4

Credenciales de preproducción

Recibes un int_id_comercio de pruebas para validar la integración.
5

Certificación y producción

Tras certificar (especialmente PSE), se habilita producción.

​
Certificación PSE

Si tu integración va a procesar PSE, antes de salir a producción debes certificar el comercio ante ACH Colombia. Los requisitos se detallan en Certificación PSE.

​
Pruebas antes de producción

El formulario web dummie sirve para validar la experiencia visual. Para probar el API REST directamente, solicita credenciales de preproducción al equipo de soporte. Ver Sandbox y pruebas.

​
Próximo paso

Quickstart →

Tu primer request.