Create Bulk Dedicated Virtual Accounts
Use this endpoint to create dedicated virtual accounts for customers previously submitted through Create Bulk Customer.
How It Works
- Create the customers with the bulk-customer endpoint.
- Copy
data.batchidfrom the response. - Send that value as
batchIdto this endpoint. - Review
totalCreatedandtotalSkippedto confirm the result.
This request uses your secret key and must be made from a secure backend server. Never expose your secret key in browser or mobile-app code.
API Endpoint
POST https://backendapi.sayswitchgroup.com/api/v1/dedicated_bulk_virtual_accountRequest Body
{
"batchId": "0705855c54999"
}| Field | Type | Required | Description |
|---|---|---|---|
batchId | string | Yes | The batch identifier returned as data.batchid by the bulk-customer endpoint. |
Replace the sample batch ID with the value returned when you created your customers.
Sample Request
curl -X POST https://backendapi.sayswitchgroup.com/api/v1/dedicated_bulk_virtual_account \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_SECRET_KEY" \
-d '{
"batchId": "0705855c54999"
}'Success Response
The example below focuses on the account details merchants normally need. The API response may include additional record identifiers.
{
"status": true,
"message": "NUBAN accounts successfully created",
"totalCreated": 2,
"totalSkipped": 0,
"data": [
{
"account_name": "John Doe",
"account_number": "6600026605",
"bank_name": "Example Bank",
"currency": "NGN",
"domain": "live",
"status": "active",
"reference": "v31jqnnxuqydmm2",
"assignment": "reserved",
"created_at": "2026-02-02T21:53:30.000000Z",
"updated_at": "2026-02-02T21:53:30.000000Z"
},
{
"account_name": "Jane Smith",
"account_number": "8787606921",
"bank_name": "Example Bank",
"currency": "NGN",
"domain": "live",
"status": "active",
"reference": "rwniknz6axh8gsm",
"assignment": "reserved",
"created_at": "2026-02-02T21:53:30.000000Z",
"updated_at": "2026-02-02T21:53:30.000000Z"
}
]
}Response Fields
| Field | Type | Description |
|---|---|---|
status | boolean | Indicates whether the request was processed successfully. |
message | string | A summary of the result. |
totalCreated | integer | Number of virtual accounts created. |
totalSkipped | integer | Number of customers for whom an account was not created. |
data | array | The virtual accounts created by the request. |
data[].account_name | string | Name registered to the account. |
data[].account_number | string | The customer’s virtual account number. |
data[].bank_name | string | Bank that hosts the virtual account. |
data[].currency | string | Account currency, such as NGN. |
data[].domain | string | Environment in which the account was created. |
data[].status | string | Current account status. |
data[].reference | string | Unique reference for the virtual account. |
data[].assignment | string | Account assignment type. |
data[].created_at | string | Date and time the account was created. |
data[].updated_at | string | Date and time the account was last updated. |
Errors and Skipped Accounts
The request can fail if the secret key is invalid, batchId is missing, or the batch cannot be found. A successful request may still contain skipped customers, so always compare totalCreated and totalSkipped before treating the whole batch as complete.
If accounts are skipped, review the customer batch and existing virtual accounts before retrying. Retrying the same batch without checking could repeat work for customers who already have accounts.