# Retiros

### 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="/pages/K2mFymU628rxdBAPFLPN"><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="/pages/K2mFymU628rxdBAPFLPN"><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="/pages/K2mFymU628rxdBAPFLPN"><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="/pages/K2mFymU628rxdBAPFLPN"><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="/pages/K2mFymU628rxdBAPFLPN"><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="/pages/K2mFymU628rxdBAPFLPN"><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 %}


---

# 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://vitawallet.gitbook.io/vita-business-documentation/gestion-de-transacciones/crear-transaccion/retiros.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.