POST
/
disbursements
/
single
/
reject
Reject Single Disbursement
curl --request POST \
  --url https://dev.api.onekhusa.com/sandbox/v1/disbursements/single/reject \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --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 , where is your access token.

Headers

​
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"