Skip to main content
Objeto que se envía en el cuerpo de /InicioPago con las credenciales del comercio.
/VerificacionPago usa los mismos datos pero con nombres diferentes y en el nivel raíz del body. Ver Autenticación.

​
Campos

​
int_id_comercio
integer
required
Identificador único del comercio. Suministrado por ZonaPagos al activar tu cuenta.Ejemplo: 678, 31416
​
str_usuario
string
required
Usuario técnico de integración. Máximo 40 caracteres.
En /VerificacionPago este mismo valor se llama str_usr_comercio.
​
str_clave
string
required
Clave de integración. Máximo 50 caracteres.
En /VerificacionPago este mismo valor se llama str_pwd_Comercio (con C mayúscula).
​
int_modalidad
integer
required
Valor fijo.
Contradicción en la documentación oficial v6.0:
  • El texto normativo indica que debe ser siempre -1.
  • El ejemplo JSON oficial (sección 7.4.1) envía 1.
Esta documentación recomienda -1 siguiendo el texto. [Pendiente de confirmación con TI.]

​
Ejemplo

{
  "int_id_comercio": 678,
  "str_usuario": "Usuario",
  "str_clave": "ClaveSecreta",
  "int_modalidad": -1
}

​
Manejo de credenciales

Guárdalas en secret manager / variables de entorno cifradas. Nunca en código.
Rota la clave periódicamente desde el portal.
No loguees la clave en archivos de log.
Usa HTTPS siempre (el API solo acepta TLS).