BlockAndUnblock
POST
https://test.api.neotek.sa/b2b-unified/va/v1/remitters/{remitterId}/blockSandbox URL · in Production call https://api.neotek.sa
POST
https://test.api.neotek.sa/b2b-unified/va/v1/remitters/{remitterId}/unblockSandbox URL · in Production call https://api.neotek.sa
The account-level master switch. Blocking disables all credit and debit transactions on a VA; unblocking re-enables them. The two calls take the same request and return the same response — only the path differs.
A transaction needs both this switch and its specific channel enabled to go through.
Path parameters:
| Parameter | Required | Description |
|---|---|---|
remitterId | Required | the VA identifier |
Body:
| Parameter | Required | Description |
|---|---|---|
bankCode | Required | always RJHISARI |
remitterIban | Required | the VA IBAN from the create response, 24 characters |
schemeId | Optional | required only if you have several schemes |
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/{remitterId}/block' \ --header 'authorization: Bearer <ACCESS_TOKEN>' \ --header 'content-type: application/json' \ --data '{ "bankCode": "RJHISARI", "remitterIban": "SA4580000204000010006087" }'Response
JSON
{ "success": true, "code": "SUCCESS", "message": "Virtual account blocked successfully", "remitterId": "CUST001", "remitterIban": "SA4580000204000010006087", "schemeId": "SCHEME001", "msgReference": "BLK001"}Errors — every B2B failure carries a category that determines the HTTP status; see Statements → Errors.