> For the complete documentation index, see [llms.txt](https://vitawallet.gitbook.io/vita-business-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vitawallet.gitbook.io/vita-business-documentation/gestion-de-transacciones/crear-transaccion/retiros.md).

# Retiros

Esta es la forma de realizar el retiro de dinero a una cuenta bancaria.

### Caso de uso

Considere el cliente desea retirar su dinero del *e*-*commerce* hacia su **cuenta bancaria personal,** para tal fin Vita Business provee el servicio de retiro, el cual se descuenta dinero de la wallet del cliente y la envía a la cuenta bancaria.<br>

{% hint style="warning" %}
Tenga en cuenta, que los campos que requiere el endpoint para realizar un retiro a un país, son ahora dinámicos, puedes ver más información en la sección [formularios](#formulario-solo-entorno-qa).
{% endhint %}

## Create Withdrawal Transaction

<mark style="color:green;">`POST`</mark> `api.vitawallet.io/api/businesses/transactions`

Este método permite crear una transacción de tipo **retiro** con el uso de una **wallet**, el monto sera reflejado de forma **negativa** en el **balance** de la **wallet**.&#x20;

#### Request Body

| Name                                                 | Type   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ---------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| url\_notify<mark style="color:red;">\*</mark>        | string | Url bajo el protocolo **HTTPS**, a la cual enviaremos nuestro **IPN**.                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| beneficiary\_document\_type                          | string | <p>Tipo de documento del beneficiario.<br><br>Nota: Te facilitamos todos los tipos de documento, dependiendo del país a retirar, visita la sección <a href="/vita-business-documentation/gestion-de-transacciones/crear-transaccion/retiros/formularios.md"><strong>formularios</strong></a>.</p>                                                                                                                                                                                                                   |
| beneficiary\_document\_number                        | string | <p>Numero de documento del beneficiario.<br><br><strong>Para Chile</strong><br>Puedes enviar este campo de las siguientes alternativas:<br><br>11.111.111-1<br>11.111.111-K<br>11111111K<br><br><strong>Para el resto</strong><br>SOLO <strong>NUMEROS</strong></p>                                                                                                                                                                                                                                                 |
| account\_type\_bank                                  | string | <p>Tipo de cuenta bancaria.<br><br>Tipos soportados:<br>País que no sea <strong>México</strong><br><strong>CA</strong> Cuenta de ahorros<br><strong>CC</strong> Cuenta corriente<br><br><strong>CLABE</strong> Solo si es México</p><p></p><p>Nota: Te facilitamos todos los tipos de cuenta bancaria, dependiendo del país a retirar, visita la sección <a href="/vita-business-documentation/gestion-de-transacciones/crear-transaccion/retiros/formularios.md"><strong>formularios</strong></a>.</p>             |
| account\_bank                                        | string | Numero de cuenta bancaria, solo **NÚMEROS,** se verifica la cantidad de dígitos dependiendo del **banco**.                                                                                                                                                                                                                                                                                                                                                                                                          |
| bank\_code                                           | string | <p>Código del banco al cual se hará el pago.<br><br>Nota: Te facilitamos todos códigos de los bancos, dependiendo del país a retirar, visita la sección <a href="/vita-business-documentation/gestion-de-transacciones/crear-transaccion/retiros/formularios.md"><strong>formularios</strong></a>.</p>                                                                                                                                                                                                              |
| beneficiary\_email                                   | string | Correo electrónico del beneficiario.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| beneficiary\_address                                 | string | Dirección de residencia del beneficiario.                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| beneficiary\_last\_name                              | string | Apellido del beneficiario.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| beneficiary\_first\_name                             | string | Nombre del beneficiario.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| purpose\_comentary<mark style="color:red;">\*</mark> | string | Descripción del retiro.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| purpose<mark style="color:red;">\*</mark>            | string | Código del propósito del retiro.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| country<mark style="color:red;">\*</mark>            | string | <p>Código <strong>ISO</strong> del <strong>país</strong> al cual se hace el retiro.<br><br><strong>Países</strong> <strong>soportados</strong>:<br><strong>CL</strong> Chile<br><strong>CO</strong> Colombia<br><strong>MX</strong> México<br><strong>VE</strong> Venezuela<br><br>Nota: Te facilitamos todos los países disponibles para retiros, visita la sección <a href="/vita-business-documentation/gestion-de-transacciones/crear-transaccion/retiros/formularios.md"><strong>formularios</strong></a>.</p> |
| currency<mark style="color:red;">\*</mark>           | string | \[clp, usd]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| order<mark style="color:red;">\*</mark>              | string | **Orden de pago único**, con el cual se identifica una transacción.                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| amount<mark style="color:red;">\*</mark>             | number | <p>Monto de la operación.<br><br>Monto <strong>mínimo</strong> de <strong>1000 CLP</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                     |
| transactions\_type<mark style="color:red;">\*</mark> | string | withdrawal                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| wallet<mark style="color:red;">\*</mark>             | string | **UUID** de la **wallet** con la que vas a ejecutar una transacción.                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| city                                                 | string | <p>Ciudad del beneficiario.<br><br>Nota: Te facilitamos todos los campos requeridos por un país, visita la sección <a href="/vita-business-documentation/gestion-de-transacciones/crear-transaccion/retiros/formularios.md"><strong>formularios</strong></a>.</p>                                                                                                                                                                                                                                                   |
| phone                                                | string | <p>Teléfono del beneficiario.</p><p></p><p>Nota: Te facilitamos todos los campos requeridos por un país, visita la sección <a href="/vita-business-documentation/gestion-de-transacciones/crear-transaccion/retiros/formularios.md"><strong>formularios</strong></a>.</p>                                                                                                                                                                                                                                           |

{% tabs %}
{% tab title="201: Created Request CREATED" %}

```
{
    "transaction": {
        "id": "27",
        "type": "business_transaction",
        "attributes": {
            "recipient_wallet": null,
            "sender_wallet": {
                "token": "1234567890",
                "uuid": "5cb344ae-7479-4c96-b17c-f469b12a7e8b",
                "balances": {
                    "clp": 884500.0
                },
                "is_master": false,
                "created_at": "2020-01-15T20:37:17.926Z"
            },
            "status": "pending",
            "order": "12345678978945612s3181a014234",
            "currency": "clp",
            "category": "withdrawal",
            "amount": "15000.0",
            "total": "15000.0",
            "fee_value": "0.0",
            "total_fee": "0.0",
            "created_at": "2020-05-01T15:45:56.197Z"
        }
    }
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
**Nota:**

Por cuestiones de seguridad, no es posible crear más de una transacción en un período de 5 segundos. Se debe tomar en cuenta esta validación para la integración.
{% endhint %}

## Formularios

**Los campos que no son requeridos, se deben obtener del método /withdrawal\_rules en la sección formularios, ya que pueden variar a lo largo del tiempo.**

{% content-ref url="/pages/K2mFymU628rxdBAPFLPN" %}
[Formularios](/vita-business-documentation/gestion-de-transacciones/crear-transaccion/retiros/formularios.md)
{% endcontent-ref %}

### SDK

{% tabs %}
{% tab title="Node" %}
Para realizar un retiro, el módulo **wallets** recibe el uuid de la wallet con la cual se desea hacer el retiro mediante el método **withdrawal.**

```javascript
import Business from 'vita-business-code';

try {
    // Debe actualizar precios, recuerde que 
    // los precios deben ser actualizados cada cierto
    // tiempo, dependiendo del campo valid_until
    // Para conocer el monto final en el país destino
    
    await Business.wallets(uuid).updatePrices();
} catch {}

try {
    const response = await Business.wallets(uuid).withdrawal({
        url_notify: "https://example.com/notify",
        beneficiary_document_type: "CC",
        beneficiary_document_number: "1487498569",
        account_type_bank: "CA",
        account_bank: "874895988",
        bank_code: "000050",
        beneficiary_email: "example@example.com",
        beneficiary_address: "example address #33-37",
        beneficiary_last_name: "Toledo Parra",
        beneficiary_first_name: "Juan Victor",
        purpose_comentary: "send for friend",
        purpose: "EPTOUR",
        country: "CO",
        currency: "clp",
        order: "order",
        amount: 1000,
    });
} catch {}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
**Monto mínimo a retirar**

El monto mínimo a retirar es de **1000 CLP**
{% endhint %}