PUT
/
disbursements
/
single
/
inter
/
approve
Approve Inter-Organisation Transfer
curl --request PUT \
  --url https://api.onekhusa.com/sandbox/v1/disbursements/single/inter/approve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "merchantAccountNumber": 52333818,
  "transactionReferenceNumber": "260703X9Y8Z7",
  "actionedBy": "approver@onekhusa.com"
}
'
{
  "merchantAccountNumber": 52333818,
  "transactionReferenceNumber": "260703X9Y8Z7",
  "responseCode": "S100"
}
WARNING: Once the transaction has been approved, the funds transfer process cannot be undone or stopped. You will be required to reconcile manually with the beneficiary who received funds to return the funds to your merchant account.

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"

ā€‹
actionedBy
string
required

Email of the user approving the transaction

Maximum string length: 60
Example:

"approver@onekhusa.com"

Response

200 - application/json

Success - Transaction approved

ā€‹
merchantAccountNumber
integer
Example:

52333818

ā€‹
transactionReferenceNumber
string
Example:

"260703X9Y8Z7"

ā€‹
responseCode
string
Example:

"S100"