POST
/
disbursements
/
single
/
reject
Reject Single Disbursement
curl --request POST \
  --url https://api.onekhusa.com/sandbox/v1/disbursements/single/reject \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Merchant-Account-Number: <x-merchant-account-number>' \
  --header 'X-Organisation-Id: <x-organisation-id>' \
  --data '{
  "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 <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
ā€‹
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"