Endpoint
POST /api/v1/business/virtualaccount/customer
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 |
|---|---|---|---|
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.usenumero.com/numeroaccount/api/v1/business/virtualaccount/customer" \
-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 '{
"firstName": "John",
"lastName": "Doe",
"email": "[email protected]",
"mobileNumber": "08012345678",
"bvn": "12345678901"
}'
Response
{
"data": {
"reference": "VA-20240115-abc123",
"accountName": "John Doe",
"accountNumber": "8012345678",
"bankName": "Providus Bank",
"providerCode": "PROVIDUS"
},
"error": null,
"meta": {
"request_id": "req_365123ebc73323f1482508560ce6400e",
"pagination": 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 |