BulkCreateVirtualAccounts
POST
https://test.api.neotek.sa/b2b-unified/va/v1/remitters/bulkSandbox URL · in Production call https://api.neotek.sa
Creates several VAs in one request. ARB assigns sequential remitter ids, IBANs and BBANs — you do not choose them.
Body:
| Parameter | Required | Description |
|---|---|---|
bankCode | Required | always RJHISARI |
count | Required | how many to create, minimum 1 |
schemeId | Optional | required only if you have several schemes |
startDate | Optional | defaults to today |
expiryDate | Optional | — |
msgReference | Optional | generated if omitted |
Headers:
| Parameter | Required | Description |
|---|---|---|
authorization | Required | Bearer <ACCESS_TOKEN> |
content-type | Required | application/json |
cURL
curl -X POST 'https://test.api.neotek.sa/b2b-unified/va/v1/remitters/bulk' \ --header 'authorization: Bearer <ACCESS_TOKEN>' \ --header 'content-type: application/json' \ --data '{ "bankCode": "RJHISARI", "count": 3 }'Response (trimmed to one remitter)
JSON
{ "success": true, "code": "SUCCESS", "message": "Bulk virtual accounts created successfully", "msgReference": "BULK001", "schemeId": "SCHEME001", "remitters": [ { "remitterId": "000001", "iban": "SA4580000204000010006087", "bban": "204000010006087" } ]}Errors — every B2B failure carries a category that determines the HTTP status; see Statements → Errors.