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

# Create Virtual Account

> Issue a virtual bank account to a customer to receive funds

Create a virtual bank account for a customer. The customer must have KYC approved (`is_va_approved: true`) before a virtual account can be issued.

```
POST /v1/business/virtual-account/create
```

<Note>
  Requires an `Idempotency-Key` header. Each customer can hold one virtual account per currency.
</Note>

## Request Body

<ParamField body="currency" type="string" required>
  Currency for the virtual account. Supported values: `MXN`, `BRL`, `USD`, `EUR`, `MXN_USD`, `MXN_BASE`, `MXNBASE`, `EURBASE`, `USDBASE`, `EUR_BASE`, `USD_BASE`, `EURDE`, `USDDE`, `GBP`, `USD_KIRA`, `USDKIRA`.
</ParamField>

<ParamField body="customer_id" type="string">
  The UUID of the KYC-approved customer. **Required when currency is `USD`**; optional for other currencies.
</ParamField>

<RequestExample>
  ```bash Brazil (PIX / BRL) theme={null}
  curl -X POST 'https://api.yativo.com/api/v1/business/virtual-account/create' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
    -H 'Content-Type: application/json' \
    -H 'Idempotency-Key: unique-key-here' \
    -d '{
      "currency": "BRL"
    }'
  ```

  ```bash USD (ACH) theme={null}
  curl -X POST 'https://api.yativo.com/api/v1/business/virtual-account/create' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
    -H 'Content-Type: application/json' \
    -H 'Idempotency-Key: unique-key-here' \
    -d '{
      "customer_id": "da44a3e6-eb5d-429f-8d17-357aa5a6cdf2",
      "currency": "USD"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "status": "success",
    "status_code": 201,
    "message": "Virtual account creation in progress",
    "data": {
      "account_id": "va_xxxxxx",
      "account_number": "9900123456",
      "account_type": "savings",
      "currency": "BRL",
      "customer_id": "da44a3e6-eb5d-429f-8d17-357aa5a6cdf2",
      "created_at": "2026-04-01T10:00:00Z"
    }
  }
  ```
</ResponseExample>