Create Customer Virtual Account

Create a virtual NUBAN account for an individual customer. Requires basic KYC information.

Endpoint

POST /api/v1/business/virtualaccount/customer

Signature required: Yes

Headers

Header	Required	Description
`x-api-key`	Yes	Your API key
`x-signature-key`	Yes	Request signature

Request body

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
`mobileNumber`	string	Yes	Customer’s phone number
`bvn`	string	Yes	Customer’s Bank Verification Number

Request example

curl -X POST "https://api-dev.usenumero.com/numeroaccount/api/v1/business/virtualaccount/customer" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key" \
  -H "x-signature-key: generated_signature" \
  -d '{
    "firstName": "John",
    "lastName": "Doe",
    "email": "[email protected]",
    "mobileNumber": "08012345678",
    "bvn": "12345678901"
  }'

Response

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "version": "v1",
  "reference": "abc123",
  "data": {
    "reference": "VA-20240115-abc123",
    "accountName": "John Doe",
    "accountNumber": "8012345678",
    "bankName": "Providus Bank",
    "providerCode": "PROVIDUS"
  },
  "error": null
}

Field	Type	Description
`reference`	string	Unique reference for this virtual account
`accountName`	string	The name on the virtual account
`accountNumber`	string	The NUBAN account number — share this with your customer
`bankName`	string	The bank the account was created with
`providerCode`	string	Provider identifier

Collections Create Business Virtual Account

⌘I

​Endpoint

​Headers

​Request body

​Request example

​Response

Endpoint

Headers

Request body

Request example

Response