POST
/
disbursements
/
single
/
add
Add Single Disbursement Transaction API
curl --request POST \
  --url https://dev.api.onekhusa.com/sandbox/v1/disbursements/single/add \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "merchantAccountNumber": 38353798,
  "beneficiaryName": "John Phiri",
  "connectorId": 550044,
  "beneficiaryAccountNumber": "1234568",
  "transactionDescription": "Salary Payment",
  "transactionAmount": 45000,
  "sourceReferenceNumber": "QKAHXD200923",
  "capturedBy": "johndoe@example.com"
}
'
{
  "merchantAccountNumber": 37463669,
  "transactionReferenceNumber": "251220XF152G",
  "responseCode": "S100"
}

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

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 - application/json

200-OK

ā€‹
merchantAccountNumber
integer
Example:

37463669

ā€‹
transactionReferenceNumber
string
Example:

"251220XF152G"

ā€‹
responseCode
string
Example:

"S100"