Create Business Virtual Account

Create a virtual NUBAN account for a corporate entity. Requires business registration details.

Endpoint

POST /api/v1/business/virtualaccount/business

Signature required: Yes

Headers

Header	Required	Description
`X-Numero-Api-Key`	Yes	Your API key
`X-Numero-Signature`	Yes	Base64 HMAC-SHA256 over the exact raw request body (POST) or the canonicalised query string (GET), keyed with your Public Key. See Request signing.
`X-Numero-Signature-Version`	Yes	Always `v2`.

Request body

Field	Type	Required	Description
`businessName`	string	Yes	Registered business name
`rcNumber`	string	Yes	RC registration number
`tin`	string	Yes	Tax Identification Number
`address`	string	Yes	Business address
`firstName`	string	Yes	Contact person’s first name
`lastName`	string	Yes	Contact person’s last name
`email`	string	Yes	Contact email address
`mobileNumber`	string	Yes	Contact phone number

Request example

curl -X POST "https://api.usenumero.com/numeroaccount/api/v1/business/virtualaccount/business" \
  -H "Content-Type: application/json" \
  -H "X-Numero-Api-Key: your_api_key" \
  -H "X-Numero-Signature: $SIGNATURE" \
  -H "X-Numero-Signature-Version: v2" \
  -d '{
    "businessName": "Acme Ltd",
    "rcNumber": "RC123456",
    "tin": "12345678-0001",
    "address": "123 Marina Road, Lagos",
    "firstName": "Jane",
    "lastName": "Smith",
    "email": "[email protected]",
    "mobileNumber": "08098765432"
  }'

Response

{
  "data": {
    "reference": "VA-20240115-def456",
    "accountName": "Acme Ltd",
    "accountNumber": "8098765432",
    "bankName": "Providus Bank",
    "providerCode": "PROVIDUS"
  },
  "error": null,
  "meta": {
    "request_id": "req_365123ebc73323f1482508560ce6400e",
    "pagination": null
  }
}

The response format is the same as Create Customer Virtual Account.

Getting Started

Transfers & Payouts

Collections (Virtual Accounts)

Wallet-as-a-Service

Customers

Invoices

Cards

Cardholders

Balance & Transactions

Value Added Services

Credit

Verification / KYC

Webhooks

Create Business Virtual Account

Endpoint

Headers

Request body

Request example

Response

​Endpoint

​Headers

​Request body

​Request example

​Response

Endpoint

Headers

Request body

Request example

Response