CreateVirtualAccount
POST
https://test.api.neotek.sa/b2b-unified/va/v1/remittersSandbox URL · in Production call https://api.neotek.sa
Creates one VA within a scheme and returns the bank-assigned IBAN and BBAN.
Body:
| Parameter | Required | Description |
|---|---|---|
bankCode | Required | always RJHISARI |
remitterId | Required | your own identifier, alphanumeric, up to 16 characters |
remitterName | Required | display name, up to 100 characters |
maximumAmount | Required | the cap for CAP schemes, a high value for non-CAP. Range 0 to 9999999999999.99 |
schemeId | Optional | required only if you have several schemes |
startDate | Optional | defaults to today |
expiryDate | Optional | the VA never expires if omitted |
msgReference | Optional | generated if omitted |
notifications | Optional | see below |
notifications enables SMS or email alerts for VA activity. At least one of email or mobile is required when the block is present:
| Parameter | Required | Description |
|---|---|---|
enabled | Required | turns notifications on or off |
language | Optional | ARABIC or ENGLISH, defaulting to ENGLISH |
email | Conditional | the address to notify |
mobile | Conditional | a Saudi mobile in +9665XXXXXXXX form |
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' \ --header 'authorization: Bearer <ACCESS_TOKEN>' \ --header 'content-type: application/json' \ --data '{ "bankCode": "RJHISARI", "remitterId": "CUST001", "remitterName": "Acme Trading Co", "maximumAmount": 50000.00, "notifications": { "enabled": true, "language": "ENGLISH", "email": "finance@acme.com", "mobile": "+966512345678" } }'Response
JSON
{ "success": true, "code": "SUCCESS", "message": "Virtual account created successfully", "remitterId": "CUST001", "iban": "SA4580000204000010006087", "bban": "204000010006087", "maximumAmount": "50000.00", "msgReference": "REF123ABC", "schemeId": "SCHEME001"}iban and bban are bank-assigned and immutable. They cannot be changed through UpdateVirtualAccount.
Errors — every B2B failure carries a category that determines the HTTP status; see Statements → Errors.