POST
/
disbursements
/
batch
/
addJson
cURL
curl -X POST 'https://api.onekhusa.com/sandbox/v1/disbursements/batch/addJson' \
  --header 'accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer your-jwt-token' \
  --header 'X-Organisation-Id: FYH0NTVW0DXK' \
  --header 'X-Merchant-Account-Number: 35253486' \
  --header 'Accept-Language: en' \
  -d '{
  "header": {
    "merchantAccountNumber": 35253486,
    "isBatchScheduled": true,
    "scheduledDate": "2025-09-19T12:47:31.183Z",
    "capturedBy": "admin@example.com"
  },
  "transactions": [
    {
      "beneficiaryName": "John Phiri",
      "connectorId": 550044,
      "beneficiaryAccountNumber": "12345678",
      "transactionDescription": "Salary Payment",
      "transactionAmount": 45000,
      "sourceReferenceNumber": "QKAHXD200923"
    }
  ]
}'
"Batch has been queued for processing"

Authorizations

ā€‹
Authorization
string
header
required

Bearer authentication header of the form Bearer <Token>, where <Token> is your access token.

Headers

ā€‹
X-Organisation-Id
string
required

The organization identifier

ā€‹
X-Merchant-Account-Number
string
required

The merchant account number

ā€‹
Accept-Language
string
default:en

Preferred language for the response

Body

application/json

Request payload for adding bulk disbursements via JSON

ā€‹
header
object
required

Bulk JSON header information

ā€‹
transactions
object[]
required

Array of transaction objects (max 50,000)

Maximum length: 50000

Response

200 - application/json

Success Response (200 OK)

The response is of type string.

Example:

"Batch has been queued for processing"