Dedicated Virtual AccountsCreate Bulk Dedicated Virtual Accounts

Create Bulk Dedicated Virtual Accounts

Use this endpoint to create dedicated virtual accounts for customers previously submitted through Create Bulk Customer.

How It Works

  1. Create the customers with the bulk-customer endpoint.
  2. Copy data.batchid from the response.
  3. Send that value as batchId to this endpoint.
  4. Review totalCreated and totalSkipped to 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_account

Request Body

{
  "batchId": "0705855c54999"
}
FieldTypeRequiredDescription
batchIdstringYesThe 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

FieldTypeDescription
statusbooleanIndicates whether the request was processed successfully.
messagestringA summary of the result.
totalCreatedintegerNumber of virtual accounts created.
totalSkippedintegerNumber of customers for whom an account was not created.
dataarrayThe virtual accounts created by the request.
data[].account_namestringName registered to the account.
data[].account_numberstringThe customer’s virtual account number.
data[].bank_namestringBank that hosts the virtual account.
data[].currencystringAccount currency, such as NGN.
data[].domainstringEnvironment in which the account was created.
data[].statusstringCurrent account status.
data[].referencestringUnique reference for the virtual account.
data[].assignmentstringAccount assignment type.
data[].created_atstringDate and time the account was created.
data[].updated_atstringDate 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.