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",
  "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. A verified customer is required for all currencies. NGN supports both type=individual and type=business customers — businesses must have completed the KYB flow (Business customer KYB). GBP, USD, and EUR currently support type=individual only; type=business for those currencies is not yet available.

​
wallet_id
string
required

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

​
customer_id
string
required

ID of the verified customer the VBA should be created for. The customer must belong to your business and have verification_status=VERIFIED. NGN accepts both type=individual and type=business. GBP, USD, and EUR accept type=individual only — type=business for those currencies is not yet available.

Response

Virtual bank account initiated successfully.

​
message
string
required
​
data
object
required