> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zonavirtual.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Inicio de pago

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

```text theme={null}
https://www.zonapagosdemo.com/Apis_CicloPago/api/InicioPago
```

### Ambiente de producción

```text theme={null}
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                 |

<Warning> Para certificación PSE este campo es obligatorio. </Warning>

***

## 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`) |

<Check> Si no se envía ningún valor se toma `0` por defecto. </Check>

***

# 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

```text theme={null}
https://zonapagos.com/tokenizacionweb/tokentc?rut=F9BF5D512D0ABA29580B2BBECF47245A5DBCF465F98468064782A767C1F50145
```

## Ejemplo Request

```json theme={null}
{
  "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

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