---
title: "Create Virtual Account"
method: POST
path: "/v3/api/VirtualAccount"
tags: ["VirtualAccount"]
---

# Create Virtual Account

`POST /v3/api/VirtualAccount`

## Request

- Base URL: `https://api.bamboopayment.com`
- URL: `https://api.bamboopayment.com/v3/api/VirtualAccount`
- Auth: API key in header `Authorization`

Provision a dedicated local bank identifier (e.g. CLABE or CVU) for an end-user.

## Request body

- CreateVirtualAccountCommand
  - `Country` string, nullable
  - `Currency` string, nullable
  - `PaymentMethod` string, nullable
  - `ExternalReference` string, nullable
  - `AccountOwner` AccountOwnerCommand
    - `Type` string, nullable
    - `BusinessName` string, nullable
    - `FirstName` string, nullable
    - `LastName` string, nullable
    - `DocumentNumber` string, nullable
    - `DocumentType` string, nullable
    - `Email` string, nullable
    - `PhoneNumber` string, nullable
  - `MetadataIn` object, nullable

## Response `200`

Success

- VirtualAccountResponse
  - `VirtualAccountId` string, nullable
  - `ErrorCode` string, nullable
  - `ErrorDescription` string, nullable
  - `Status` string, nullable
  - `Created` string, date-time
  - `OwnershipModel` string, nullable
  - `PaymentInstrument` VirtualAccountPaymentInstrument
    - `Type` string, nullable
    - `BankAccount` string, nullable
    - `BankName` string, nullable
    - `BankAccountHolder` string, nullable
  - `MetadataOut` object, nullable

---

[API](https://skmtc.dev/bamboopayment/apis/gateway-servicefacade-api.md) - [All operations](https://skmtc.dev/bamboopayment/apis/gateway-servicefacade-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bamboopayment/apis/gateway-servicefacade-api/revisions/ddfffdaa1e3a?raw)