UpdateVirtualAccount
PUT
https://test.api.neotek.sa/b2b-unified/v1/va/v1/remitters/{remitterId}Sandbox URL · in Production call https://api.neotek.sa
Updates a VA's mutable fields.
This is a full replacement, not a partial update. Send every field with its current value: anything omitted reverts to its default. maximumAmount is required, so a request without it is rejected, and 0 stops the VA receiving funds entirely.
Path parameters:
| Parameter | Required | Description |
|---|---|---|
remitterId | Required | the VA identifier, up to 16 digits |
Body:
| Parameter | Required | Description |
|---|---|---|
bankCode | Required | always RJHISARI |
remitterName | Required | display name, up to 100 characters. Always required |
maximumAmount | Required | send the current value to keep it unchanged, as a string |
schemeId | Optional | required only if you have several schemes |
startDate | Optional | send the current value to keep it unchanged |
expiryDate | Optional | send the current or a new value |
msgReference | Optional | generated if omitted |
notifications | Optional | send the current values to keep them unchanged |
Headers:
| Parameter | Required | Description |
|---|---|---|
authorization | Required | Bearer <ACCESS_TOKEN> |
content-type | Required | application/json |
cURL
curl -X PUT 'https://test.api.neotek.sa/b2b-unified/v1/va/v1/remitters/{remitterId}' \ --header 'authorization: Bearer <ACCESS_TOKEN>' \ --header 'content-type: application/json' \ --data '{ "bankCode": "RJHISARI", "remitterName": "Riyadh Retail Co (Updated)", "maximumAmount": "75000.00" }'Response — the same shape as CreateVirtualAccount. remitterId, iban and bban are immutable and cannot be changed.
Errors — every B2B failure carries a category that determines the HTTP status; see Statements → Errors.