BulkPaymentSubmit
POST
https://test.api.neotek.sa/b2b-unified/va/v1/bulk-paymentsSandbox URL · in Production call https://api.neotek.sa
Sends a batch of payments out of a VA.
There is no single VA payment endpoint. ARB does not offer one, so for a single payment submit a batch containing one item.
Body:
| Parameter | Required | Description |
|---|---|---|
bankCode | Required | always RJHISARI |
fileReference | Required | your batch identifier, alphanumeric, up to 35 characters |
payments | Required | the payment items, at least one |
schemeId | Optional | required only if you have several schemes |
msgReference | Optional | generated if omitted |
Each item in payments:
| Parameter | Required | Description |
|---|---|---|
transactionReference | Required | unique per transaction, alphanumeric, up to 35 characters |
paymentType | Required | INTERNAL, DOMESTIC or INTERNATIONAL |
amount | Required | decimal, minimum 0.01 |
currency | Required | ISO 4217 code |
debtorIban | Required | the VA the money leaves |
debtorName | Required | up to 35 characters |
beneficiaryAccountIban | Required | IBAN or account number |
beneficiaryName | Required | up to 35 characters |
beneficiaryBankBic | Required | 8 characters, head office |
executionDate | Optional | YYYY-MM-DD, defaulting to today |
beneficiaryAddress | Optional | up to 140 characters |
description | 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/bulk-payments' \ --header 'authorization: Bearer <ACCESS_TOKEN>' \ --header 'content-type: application/json' \ --data '{ "bankCode": "RJHISARI", "fileReference": "VAPAY20260513001", "payments": [ { "transactionReference": "TXN001", "paymentType": "DOMESTIC", "amount": "5000.00", "currency": "SAR", "debtorIban": "SA4580000204000010006087", "debtorName": "Acme Trading Co", "beneficiaryAccountIban": "SA1080000012345678901003", "beneficiaryName": "Ahmed Hassan", "beneficiaryBankBic": "RJHISARI" } ] }'Response — fileReference comes back with the scheme appended, and that composite value is what BulkPaymentStatus expects
JSON
{ "success": true, "code": "PAYMENT_ACCEPTED", "message": "Bulk payment accepted for processing", "fileReference": "VAPAY20260513001~SCHEME001", "statusMessage": "Your payment is being processed and can be enquired after 30 minutes", "paymentStatus": "PAYMENT_STATUS_ACCEPTED"}Future-dated payments are accepted. Same-day SARIE transfers submitted late in the day may be deferred to the next business day.
Errors — every B2B failure carries a category that determines the HTTP status; see Statements → Errors.