Skip to main content
Esta guía te lleva por el flujo mínimo: iniciar pago → redirigir → verificar. Asume que ya tienes credenciales. Si no, ve a Ambientes y credenciales.

​
1. Variables de entorno

Guarda tus credenciales en variables de entorno. Nunca las pongas en código versionado. 
ZP_ID_COMERCIO=tu_id
ZP_USUARIO=tu_usuario
ZP_CLAVE='tu_clave'
ZP_COD_SERVICIO=tu_codigo
ZP_API_URL=https://www.zonapagos.com/Apis_CicloPago/api

​
2. Primer InicioPago

curl -X POST "$ZP_API_URL/InicioPago" \
  -H "Content-Type: application/json" \
  -d '{
    "InformacionPago": {
      "flt_total_con_iva": 50000,
      "flt_valor_iva": 7983,
      "str_id_pago": "ORDEN-TEST-001",
      "str_descripcion_pago": "Mi primer pago de prueba",
      "str_email": "dev@ejemplo.com",
      "str_id_cliente": "1020304050",
      "str_tipo_id": "1",
      "str_nombre_cliente": "Juan",
      "str_apellido_cliente": "Perez",
      "str_telefono_cliente": "3001234567"
    },
    "InformacionSeguridad": {
      "int_id_comercio": '"$ZP_ID_COMERCIO"',
      "str_usuario": "'"$ZP_USUARIO"'",
      "str_clave": "'"$ZP_CLAVE"'",
      "int_modalidad": -1
    },
    "AdicionalesPago": [],
    "AdicionalesConfiguracion": [
      { "int_codigo": 50, "str_valor": "'"$ZP_COD_SERVICIO"'" }
    ]
  }'

​
3. Respuesta esperada

{
  "int_codigo": 1,
  "str_cod_error": "",
  "str_descripcion_error": "",
  "str_url": "https://www.zonapagos.com/Ciclo_Pago/Pago.aspx?rut=6C44EA66B127D743..."
}
  • int_codigo: 1 = éxito. Redirige al usuario a str_url.
  • int_codigo: 2 = error. Revisa str_descripcion_error.
El parámetro rut en la URL es un token criptográfico. No lo modifiques.

​
4. Redirigir al usuario

En tu backend: 
// Node / Express
return res.redirect(data.str_url);
El usuario completa el pago en el formulario de Zonapagos. Cuando termine, Zonapagos lo redirige a la URL de retorno de tu comercio.

​
5. Verificar estado

Al recibir al usuario de vuelta, consulta el estado: 
curl -X POST "$ZP_API_URL/VerificacionPago" \
  -H "Content-Type: application/json" \
  -d '{
    "int_id_comercio": '"$ZP_ID_COMERCIO"',
    "str_usr_comercio": "'"$ZP_USUARIO"'",
    "str_pwd_Comercio": "'"$ZP_CLAVE"'",
    "str_id_pago": "ORDEN-TEST-001",
    "int_no_pago": -1
  }'
Los nombres de campos son diferentes entre endpoints: str_usuario ↔ str_usr_comercio, str_clave ↔ str_pwd_Comercio. No es typo, es así.

​
6. Lo que sigue

Recibir callback

Cómo procesar correctamente el retorno del usuario.

Sonda

Obligatoria si aceptas PSE.

Manejo de errores

Cómo reaccionar cuando algo falla.

Checklist producción

Antes de salir a producción.

​
Problemas frecuentes

SíntomaProbable causa
int_codigo: 2 con mensaje "Object reference not set..."Credenciales inválidas o int_id_comercio inexistente.
HTTP 404URL mal escrita. Debe ser Apis_CicloPago/api/InicioPago.
HTTP 415Falta header Content-Type: application/json.
TimeoutRed corporativa bloquea *.zonapagos.com o el servidor está saturado.
Más casos en Errores comunes.