POST
/
disbursements
/
batch
/
reject
cURL
curl -X POST "https://api.onekhusa.com/sandbox/v1/disbursements/batch/reject" \
  --header "Authorization: Bearer your-jwt-token" \
  --header "Content-Type: application/json" \
  --header "Accept-Language: en" \
  --header "X-Idempotency-Key: your-idempotency-key" \
  -d '{
    "merchantAccountNumber": 35253486,
    "batchNumber": 11111111,
    "reasonForRejection": "Invalid beneficiary information",
    "rejectedBy": "admin@example.com"
  }'
"Batch number 11111111 has been rejected successfully"

Authorizations

​
Authorization
string
header
required

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

Headers

​
Accept-Language
string
default:en

Preferred language for the response

​
X-Idempotency-Key
string

A unique key to ensure idempotent requests

Body

application/json
​
merchantAccountNumber
integer
required

Required string length: 8

Required range: 10000000 <= x <= 99999999
​
reasonForRejection
string
required

Reason for rejecting the batch

​
rejectedBy
string
required

The email address of the user rejecting the batch

​
headerId
integer

A unique integer identifier that represents a batch of disbursement transactions in the system.

Required range: x > 0

Response

200 - application/json

Success Response (200 OK)

The response is of type string.

Example:

"Batch number 11111111 has been rejected successfully"