En esta sección se explica la forma en que se debe consumir el inicio de pago, la cual se encuentra expuesta en forma de API.

Endpoints

Ambiente de pruebas

https://www.zonapagosdemo.com/Apis_CicloPago/api/InicioPago

Ambiente de producción

https://www.zonapagos.com/Apis_CicloPago/api/InicioPago

Características

Método: POST
Formato: JSON

Parámetros de Entrada

Información Pago

Lista con el nombre InformacionPago.

Parámetro	Tipo	Descripción
flt_total_con_iva	Numérico	Total a pagar con IVA incluido.
flt_valor_iva	Numérico	Total IVA. Si no se utiliza IVA, enviar `0`.
str_id_pago	Alfanumérico	Identificador del pago.
str_descripcion_pago	Alfanumérico	Concepto o descripción del pago.
str_email	Alfanumérico	Correo del cliente.
str_id_cliente	Alfanumérico	Documento o identificación del cliente.
str_tipo_id	Alfanumérico	Tipo de identificación del cliente.
str_nombre_cliente	Alfanumérico	Nombre del cliente.
str_apellido_cliente	Alfanumérico	Apellido del cliente.
str_telefono_cliente	Alfanumérico	Teléfono del cliente.
str_opcional1	Alfanumérico	Campo opcional 1.
str_opcional2	Alfanumérico	Campo opcional 2.
str_opcional3	Alfanumérico	Campo opcional 3.
str_opcional4	Alfanumérico	Campo opcional 4.
str_opcional5	Alfanumérico	Campo opcional 5.

Valores válidos `str_tipo_id`

Valor	Tipo
0	No identificado
1	CC
2	CE
3	NIT
4	NUIP
5	TI
6	Pasaporte
7	IDC
8	CEL
9	RC
10	Documento Extranjero
11	Otro

Para certificación PSE este campo es obligatorio.

Información Seguridad

Lista con el nombre InformacionSeguridad.

Parámetro	Tipo	Descripción
int_id_comercio	Numérico	Identificador único del comercio.
str_usuario	Alfanumérico	Usuario validador entre comercio y Zonapagos.
str_clave	Alfanumérico	Clave de validación.
int_modalidad	Numérico	Siempre enviar `-1`.

Adicionales Configuracion

Lista con el nombre AdicionalesConfiguracion.

Parámetro	Tipo	Descripción
int_codigo	Numérico	Configuración adicional.
str_valor	Alfanumérico	Valor de configuración adicional.

Valores válidos

Código	Descripción
50	Código de servicio principal
200	Tokenización NC (`1`) o pasarela convencional (`0`)

Si no se envía ningún valor se toma 0 por defecto.

Parámetros de Retorno

Parámetro	Tipo	Descripción
int_codigo	Int	`1` éxito, `2` error
str_cod_error	String	Código del error
str_descripcion_error	String	Descripción del error
str_url	String	URL de redirección

Ejemplo de URL

https://zonapagos.com/tokenizacionweb/tokentc?rut=F9BF5D512D0ABA29580B2BBECF47245A5DBCF465F98468064782A767C1F50145

Ejemplo Request

{
  "InformacionPago": {
    "str_email": "pruebas@zonavirtual.com",
    "str_id_cliente": "2111231451",
    "str_tipo_id": "1",
    "str_nombre_cliente": "armando",
    "str_apellido_cliente": "casas",
    "str_telefono_cliente": "323151561531",
    "str_opcional1": "opcion 11",
    "str_opcional2": "opcion 12",
    "str_opcional3": "opcion 13",
    "str_opcional4": "opcion 14",
    "str_opcional5": "opcion 15"
  },
  "InformacionSeguridad": {
    "int_id_comercio": 8469,
    "str_usuario": "UsuarioDef",
    "str_clave": "Zona1523+",
    "int_modalidad": -1
  },
  "AdicionalesConfiguracion": [
    {
      "int_codigo": 200,
      "str_valor": "1"
    }
  ]
}

Ejemplo Response

{
  "int_codigo": 1,
  "str_cod_error": "",
  "str_descripcion_error": "",
  "str_url": "https://zonapagosdemo.com/tokenizacionweb/tokenzptc.aspx?rut=3408532B22C22E2F77F0627144837837F9E7F3910DEE1FBCA03FD0D6E0F3156A221B09321070DE3B6BC9C728A4B952B9E8137294696F05A3"
}

Empieza ahora

Zonapay - Pasarelas de pagos

Zonarecaudo

Zonaexpress - Formulario de pago

Tokenización

Link de cobro

Inicio de pago

Endpoints

Ambiente de pruebas

Ambiente de producción

Características

Parámetros de Entrada

Información Pago

Valores válidos `str_tipo_id`

Información Seguridad

Adicionales Configuracion

Valores válidos

Parámetros de Retorno

Ejemplo de URL

Ejemplo Request

Ejemplo Response

​Endpoints

​Ambiente de pruebas

​Ambiente de producción

​Características

​Parámetros de Entrada

​Información Pago

​Valores válidos str_tipo_id

​Información Seguridad

​Adicionales Configuracion

​Valores válidos

​Parámetros de Retorno

​Ejemplo de URL

​Ejemplo Request

​Ejemplo Response

Endpoints

Ambiente de pruebas

Ambiente de producción

Características

Parámetros de Entrada

Información Pago

Valores válidos `str_tipo_id`

Información Seguridad

Adicionales Configuracion

Valores válidos

Parámetros de Retorno

Ejemplo de URL

Ejemplo Request

Ejemplo Response