Skip to main content
Create a virtual NUBAN account for a corporate entity. Requires business registration details.

​
Endpoint

POST /api/v1/business/virtualaccount/business
Signature required: Yes

​
Headers

HeaderRequiredDescription
x-api-keyYesYour API key
x-signature-keyYesRequest signature

​
Request body

FieldTypeRequiredDescription
businessNamestringYesRegistered business name
rcNumberstringYesRC registration number
tinstringYesTax Identification Number
addressstringYesBusiness address
firstNamestringYesContact person’s first name
lastNamestringYesContact person’s last name
emailstringYesContact email address
mobileNumberstringYesContact phone number

​
Request example

curl -X POST "https://api-dev.usenumero.com/numeroaccount/api/v1/business/virtualaccount/business" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key" \
  -H "x-signature-key: generated_signature" \
  -d '{
    "businessName": "Acme Ltd",
    "rcNumber": "RC123456",
    "tin": "12345678-0001",
    "address": "123 Marina Road, Lagos",
    "firstName": "Jane",
    "lastName": "Smith",
    "email": "[email protected]",
    "mobileNumber": "08098765432"
  }'

​
Response

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "version": "v1",
  "reference": "abc123",
  "data": {
    "reference": "VA-20240115-def456",
    "accountName": "Acme Ltd",
    "accountNumber": "8098765432",
    "bankName": "Providus Bank",
    "providerCode": "PROVIDUS"
  },
  "error": null
}
The response format is the same as Create Customer Virtual Account.