# Realizar transferencias

## Producción

<mark style="color:green;">`POST`</mark> `https://api.payvalida.com/cashout/v1/transfer`

## Sandbox

<mark style="color:green;">`POST`</mark> `https://api-test.payvalida.com/cashout/v1/transfer`

{% tabs %}
{% tab title="Request" %}

<table><thead><tr><th width="209">Campo</th><th width="133">Tipo de dato</th><th width="121.30859375">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td>merchant</td><td>String</td><td>Sí</td><td>Identificación del comercio que realiza la operación, (50 caracteres).</td></tr><tr><td>operation</td><td>String</td><td>Sí</td><td>Identificador de la operación generada por el comercio. Debe ser identificador único, (40 caracteres).</td></tr><tr><td>checksum</td><td>String</td><td>Sí</td><td>SHA512(merchant+operation+FIXED_HASH) (128 caracteres)</td></tr><tr><td>beneficiary</td><td>JSON</td><td>Sí</td><td>Información específica del beneficiario (JSON)</td></tr><tr><td>identification</td><td>String</td><td>Sí</td><td>Número de identificación del beneficiario (20 caracteres)</td></tr><tr><td>identificationType</td><td>String</td><td>Sí</td><td><p>Tipo de identificación provisto, pueden ser los siguientes valores:<br><strong>Colombia</strong>:<br>- CC: Cédula de Ciudadanía<br>- CE: Cédula de Extranjería<br>- PS: Pasaporte<br>- TI: Tarjeta de Identificación<br>- NIT: Número de Identificación Tributaria<br><strong>Ecuador:</strong><br>- CC: Cédula de identidad<br>- RUC: Registro único de contribuyentes</p><p><strong>El Salvador:</strong></p><p>- DUI<br>- DNI<br>- PS<br>- CE<br>- SRL<br>- NIT<br><strong>Guatemala:</strong><br>- DPI: Documento personal de identificación<br><strong>Perú:</strong><br>- DNI: Documento nacional de identidad<br>- CE: Cédula de Extranjería</p></td></tr><tr><td>name</td><td>String</td><td>Sí</td><td>Nombre del beneficiario, no soporta caracteres especiales (50 caracteres)</td></tr><tr><td>lastname</td><td>String</td><td>Sí</td><td>Apellido del beneficiario, no soporta caracteres especiales (50 caracteres)</td></tr><tr><td>email</td><td>String</td><td>Sí</td><td>Dirección de correo electrónico válida.</td></tr><tr><td>country</td><td>String</td><td>Sí</td><td><p>Valores permitidos:</p><ul><li><strong>CO</strong>: Transferencias en Colombia</li><li><strong>EC</strong>: Transferencias en Ecuador</li><li><strong>GT</strong>: Transferencias en Guatemala</li><li><strong>PE</strong>: Transferencias en Perú</li><li><strong>SV</strong>: Transferencias en El Salvador</li></ul></td></tr><tr><td>bankAccount</td><td>String</td><td>Sí</td><td><p>Nombre del banco en donde tiene su cuenta el beneficiario, se permiten los siguientes valores:</p><ul><li><a href="/pages/sBVpWPoiaxN0VCBDmKRm">Bancos en Colombia</a></li><li><a href="/pages/yYdClYOfAALTj1oGMup6">Bancos en Ecuador</a></li><li><a href="/pages/efSijNk08muOvAurDXRO">Bancos en El Salvador</a></li><li><a href="/pages/pGgejMPILNkSxNhQGMHF">Bancos en Guatemala</a></li><li><a href="/pages/NIXbjjvkxD69So4xXpww">Bancos en Perú</a></li></ul><p></p></td></tr><tr><td>bankAccountNumber</td><td>String</td><td>Sí</td><td>Número de cuenta del beneficiario. <br><br><strong>Perú:</strong> número de cuenta local. <a href="https://docs.payvalida.com/api-payouts-2.0/bancos/peru">Consultar bancos</a> que trabajan con cuenta local.<br><br><strong>Perú:</strong> si se envía cuenta CCI, este campo es opcional.</td></tr><tr><td>bankAccountNumberCci</td><td>String</td><td>No</td><td><strong>Perú:</strong> número de cuenta CCI, usado para transferencias interbancarias. (20 caracteres). <a href="https://docs.payvalida.com/api-payouts-2.0/bancos/colombia">Consultar bancos </a>que trabajan con cuenta CCI. <br><br>Para Perú si se envía cuenta CCI, bankAccountNumber es opcional.</td></tr><tr><td>bankAccountType</td><td>String</td><td>Sí</td><td><p>Tipo de cuenta, se permiten los siguientes valores:<br><strong>Colombia</strong><br>- Ahorro<br>- Corriente<br><strong>Ecuador</strong><br>- Ahorro<br>- Corriente</p><p><strong>El Salvador</strong></p><p>- Ahorro</p><p>- Corriente<br><strong>Guatemala</strong><br>- Ahorro<br>- Monetaria <br><strong>Perú</strong><br>- Ahorro<br>- Corriente</p></td></tr><tr><td>transactionValue</td><td>Float</td><td>Sí</td><td>Valor a transferir, este valor será debitado de la billetera del comercio</td></tr></tbody></table>

{% endtab %}

{% tab title="Request (ejemplo)" %}

```json
{
    "merchant": "merchantName",
    "operation": "opId1234",
    "checksum": "5807c366db37aff0330cb0fc520149e45024f9224d035e0d420f153b69b2effc514204a0d4e7aba629343c6890e7642db6c4ef0249ef4bc855590846f948c083",
    "beneficiary": {
        "identification": "43750860",
        "name": "James Arthur",
        "lastname": "Hammett Green",
        "email": "account@email.org",
        "country": "CO",
        "bankAccount": "BANCO DE OCCIDENTE",
        "bankAccountNumber": "123456789",
        "bankAccountType": "Corriente",
        "identificationType": "CC",
        "transactionValue": 2301.00
    }

```

{% endtab %}

{% tab title="Request Perú (ejemplo)" %}

```json
{
    "merchant": "merchantName",
    "operation": "opId1234",
    "checksum": "5807c366db37aff0330cb0fc520149e45024f9224d035e0d420f153b69b2effc514204a0d4e7aba629343c6890e7642db6c4ef0249ef4bc855590846f948c083",
    "beneficiary": {
        "identification": "43750860",
        "name": "James Arthur",
        "lastname": "Hammett Green",
        "email": "account@email.org",
        "country": "PE",
        "bankAccount": "BCP",
        "bankAccountNumber": "84320000036204819572",
        "bankAccountNumberCci": "84320000036204819572",
        "bankAccountType": "Corriente",
        "identificationType": "CC",
        "transactionValue": 2301.00
    }
```

{% endtab %}

{% tab title="Response" %}

| Campo        | Tipo de dato | Descripción                                                                                               |
| ------------ | ------------ | --------------------------------------------------------------------------------------------------------- |
| CODE         | String       | Indica el código del resultado, “0000” indica resultado sin error, otro valor indica el código del error. |
| DESC         | String       | Contiene el mensaje referente al code enviado.                                                            |
| DATA         | String       | Indica si la transacción se envío con éxito (para resultados sin error)                                   |
| {% endtab %} |              |                                                                                                           |

{% tab title="Response (ejemplo)" %}

```json
{
    "CODE": "0000",
    "DESC": "OK",
    "DATA": "Transfer sent successfully"
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
Usar números de cuenta en **formato real** (aunque sean de prueba). Formatos inventados provocan errores en la transferencia.
{% endhint %}

**Nota:** Toda operación registrada, queda en estado **EN PROCESO.** Una vez que el banco responda a la solicitud de transferencia el estado será actualizado.

{% hint style="info" %}
Para poder utilizar este servicio, se debe coordinar con su gerente comercial la activación.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payvalida.com/api-payouts/transferencias/master.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.