POST
/
disbursements
/
single
/
reject
cURL
curl -X POST "https://dev.api.onekhusa.com/sandbox/v1/disbursements/single/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,
    "transactionReferenceNumber": "D250713MGGGY",
    "reasonForRejection": "Invalid beneficiary account number format",
    "rejectedBy": "admin@example.com"
  }'
"Transaction 250625PJQ89C has been rejected successfully"

Authorizations

ā€‹
Authorization
string
header
required

Bearer authentication header of the form Bearer Token, Where accessToken is the access token used to authenticate the request.

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
Example:

35253486

ā€‹
transactionReferenceNumber
string
required

The unique transaction reference number

Example:

"D250713MGGGY"

ā€‹
reasonForRejection
string
required

Detailed reason for rejecting the transaction

Example:

"Invalid beneficiary account number format"

ā€‹
rejectedBy
string
required

The email address of of the person rejecting the transaction

Example:

"admin@example.com"

Response

200 - application/json

Success Response (200 OK)

The response is of type string.

Example:

"Transaction 250625PJQ89C has been rejected successfully"