Skip to main content
POST
/
api
/
external
/
virtual-bank-account
Create virtual bank account
curl --request POST \
  --url https://api-prod.blaaiz.com/api/external/virtual-bank-account \
  --header 'Content-Type: application/json' \
  --header 'x-blaaiz-api-key: <api-key>' \
  --data '
{
  "wallet_id": "b18ed308-5ac5-4e9e-bb16-8c03ec2d3c01",
  "account_name": "Jane Doe",
  "customer_id": "9d4c4ec5-59ea-4130-bf8a-6a5edec401ee"
}
'
{
  "message": "Virtual bank account created successfully.",
  "data": [
    {
      "id": "33580c65-d063-4138-a875-82ff09dfaeb5",
      "business_wallet_id": "b18ed308-5ac5-4e9e-bb16-8c03ec2d3c01",
      "currency_id": 1,
      "currency": "NGN",
      "account_number": "7880000024",
      "account_name": "John Doe",
      "bank_name": "78 Finance Company Limited",
      "bank_code": "123456",
      "provider": "BANK78",
      "account_reference": "2327323232",
      "reservation_reference": null
    }
  ]
}

Authorizations

​
x-blaaiz-api-key
string
header
required

Body

application/json

Supports NGN, GBP, USD, EUR. For NGN, account_name is required. For GBP/USD/EUR, customer must have type=individual (business not supported).

​
wallet_id
string
required

ID of the business wallet the account will be associated with.

​
account_name
string

Name for the virtual bank account holder (max 255 chars). Required when currency is NGN.

​
customer_id
string

Customer ID the VBA should be created for. For GBP/USD/EUR, customer must have type=individual (business not supported).

Response

Virtual bank account created successfully.

​
message
string
required
​
data
object[]
required