POST
/
disbursements
/
single
/
inter
/
reject
Reject Inter-Organisation Transfer
curl --request POST \
  --url https://dev.api.onekhusa.com/sandbox/v1/disbursements/single/inter/reject \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "merchantAccountNumber": 52333818,
  "transactionReferenceNumber": "260703X9Y8Z7",
  "reasonForRejection": "Invalid beneficiary account",
  "rejectedBy": "admin@onekhusa.com"
}
'
"Transaction 260703X9Y8Z7 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

Sender merchant account number (8 digits)

Required range: 10000000 <= x <= 99999999
Example:

52333818

transactionReferenceNumber
string
required

The unique transaction reference number

Example:

"260703X9Y8Z7"

reasonForRejection
string
required

Reason for rejecting the transaction

Example:

"Invalid beneficiary account"

rejectedBy
string<email>
required

Email of the rejecting user

Example:

"admin@onekhusa.com"

Response

200 - application/json

Success - Transaction rejected

The response is of type string.

Example:

"Transaction 260703X9Y8Z7 has been rejected successfully"