v1

latestOpenAPI 3.0.32026-07-26184851.6 MB

Virtual Accounts

Master Wallet Create

This endpoint is used to create a new virtual account within a specific master wallet.

Field	Type	Required	Description
firstname	string	Yes	Customer's first name
lastname	string	Yes	Customer's last name
email	string	Yes	Customer's email address (must be unique per business)
phone	string	No	Customer's phone number in format: +234XXXXXXXXXX
bvn	string	Yes	Customer's Bank Verification Number
dateOfBirth	string	Yes	Customer's date of birth in yyyy-MM-dd format

post/v1/wallets/{id}/virtual-accounts

Request body

bvnstring required

dateOfBirthstring required

emailstring required

firstnamestring required

lastnamestring required

phonestring

Example request

{
  "bvn": "22345678901",
  "dateOfBirth": "1992-08-14",
  "email": "luteeph1234@gmail.com",
  "firstname": "Luthfulah",
  "lastname": "Osen",
  "phone": "+2348161846125"
}

Response

200

messagestring

statusCodenumber

Example response

{
  "data": {
    "accountName": "luthfulah osen",
    "accountNumber": "9018927611",
    "bankCode": "076",
    "bankName": "Polaris Bank",
    "createdAt": "2025-11-06T18:30:34.286Z",
    "currency": "NGN",
    "customer": {
      "createdAt": "2025-11-06T18:30:34.286Z",
      "email": "luteeph1234@gmail.com",
      "id": "caa17eb8-4da8-45b4-a866-81dd0a1df613",
      "name": "luthfulah osen",
      "network": "mainnet",
      "phone": "+2348161846125",
      "status": "ACTIVE",
      "updatedAt": "2025-11-06T18:30:34.286Z"
    },
    "id": "8180309e-1ead-4a72-a013-b5674600ce4c",
    "isActive": true,
    "reference": "20",
    "status": "ACTIVE",
    "type": "AUTO_FUNDING",
    "updatedAt": "2025-11-06T18:30:34.286Z",
    "wallet": {
      "address": "0xD8582C57E56Ef45f9fe82870aDF63d9baB89e1F7",
      "createdAt": "2024-05-27T19:33:42.377Z",
      "derivationPath": "m/44'/60'/0'/0/11",
      "description": "This is Base wallet",
      "id": "35e964a6-436a-424f-bf3a-618cc060feea",
      "isActive": true,
      "name": "Base Wallet",
      "network": "mainnet",
      "status": "ACTIVE",
      "updatedAt": "2024-05-27T19:33:42.377Z"
    }
  },
  "message": "Virtual account created successfully",
  "statusCode": 201
}