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 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "wallet_id": "b18ed308-5ac5-4e9e-bb16-8c03ec2d3c01",
  "account_name": "Jane Doe",
  "customer_id": "9d4c4ec5-59ea-4130-bf8a-6a5edec401ee"
}
'
{ "message": "Virtual bank account initiated 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, "rejection_reason": null, "status": "PENDING" } }

Authorizations

​
Authorization
string
header
required

Use your OAuth client credentials to obtain a short-lived Bearer token from POST /oauth/token.

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 initiated successfully.

​
message
string
required
​
data
object
required