POST
/
disbursements
/
single
/
add
Add Single Disbursement Transaction API
curl --request POST \
  --url https://api.onekhusa.com/sandbox/v1/disbursements/single/add \
  --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": 38353798,
  "beneficiaryName": "John Phiri",
  "connectorId": 550044,
  "beneficiaryAccountNumber": "1234568",
  "transactionDescription": "Salary Payment",
  "transactionAmount": 45000,
  "sourceReferenceNumber": "QKAHXD200923",
  "capturedBy": "johndoe@example.com"
}'
"Funds transferred successfully to the beneficiary"

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

The merchant's account number

Example:

37463669

ā€‹
beneficiaryName
string
required

The recipient's name

Example:

"John Phiri"

ā€‹
connectorId
integer
required

ID of the payment connector to use. See Get Connectors for the full list of available connector IDs.

Example:

550044

ā€‹
beneficiaryAccountNumber
string
required

The recipient's account number

Example:

"1234568"

ā€‹
transactionDescription
string
required

Description of the transaction

Example:

"Salary Payment"

ā€‹
transactionAmount
number
required

The amount to be disbursed

Example:

45000

ā€‹
sourceReferenceNumber
string
required

Reference number from the source system

Example:

"QKAHXD200923"

ā€‹
capturedBy
string<email>
required

Email address of the user who captured/created the transaction.

Example:

"johndoe@example.com"

Response

200 - text/plain

200-OK

The response is of type string.

Example:

"Funds transferred successfully to the beneficiary"