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
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.
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"
}
