Payment Features
Bulk Dedicated Virtual Accounts
The Bulk Dedicated Virtual Account API enables Nigerian merchants to generate bulk virtual account number for customers using the batch ID.
Feature Availability
This feature is only available to businesses in Nigeria.
Create Bulk Dedicated Virtual Accounts
Create bulk dedicated virtual accounts and assign to a customers
Endpoint: /dedicated_virtual_account
Method: POST
Bank Availability
We currently support Wema, Premium Trust.
Header
| Param | Type | Required? | Decription |
|---|---|---|---|
| authorization | string | Yes | Set value to Bearer SECRET_KEY |
| content-type | string | Yes | Set value to application/json |
Body Param
| Param | Type | Required? | Decription |
|---|---|---|---|
| batchId | string | Yes | Batch ID |
Testing Bulk Dedicated Virtual Accounts
To create Bulk Dedicated Virtual Accounts for testing, simply use your test secret key to generate the dedicated account number. And get your payment approved automatically. .
Sample Post
curl https://api.budpay.com/api/v2/dedicated_bulk_virtual_account
-H "Authorization: Bearer YOUR_SECRET_KEY"
-H "Content-Type: application/json"
-d '{ "batchId": "65c1368420424"
}'
-X POST
Sample Response
{
"status": true,
"message": "NUBAN accounts successfully created",
"totalCreated": 3,
"totalSkipped": 0,
"data": [
{
"businesses_id": 25,
"customer_id": 8242070,
"account_name": "Afg / Test 1 Test 1",
"account_number": "1969038145",
"bank_name": "BudPay Bank",
"currency": "NGN",
"domain": "test",
"status": "active",
"provider_id": "1",
"reference": "js1uydt88xjsvih",
"assignment": "reserved",
"updated_at": "2025-07-02T10:11:35.000000Z",
"created_at": "2025-07-02T10:11:35.000000Z",
"id": 7912727
},
{
"businesses_id": 25,
"customer_id": 8242071,
"account_name": "Afg / Test 2 Test 2",
"account_number": "1691707728",
"bank_name": "BudPay Bank",
"currency": "NGN",
"domain": "test",
"status": "active",
"provider_id": "1",
"reference": "rdw3ce6i2zr0lqv",
"assignment": "reserved",
"updated_at": "2025-07-02T10:11:35.000000Z",
"created_at": "2025-07-02T10:11:35.000000Z",
"id": 7912728
},
{
"businesses_id": 25,
"customer_id": 8242072,
"account_name": "Afg / Test 3 Test 3",
"account_number": "1288698105",
"bank_name": "BudPay Bank",
"currency": "NGN",
"domain": "test",
"status": "active",
"provider_id": "1",
"reference": "vdyxm34j3nzlyc8",
"assignment": "reserved",
"updated_at": "2025-07-02T10:11:35.000000Z",
"created_at": "2025-07-02T10:11:35.000000Z",
"id": 7912729
}
]
}