POST
/
disbursements
/
single
/
getTransaction
Get Single Disbursement Transaction
curl --request POST \
  --url https://api.onekhusa.com/sandbox/v1/disbursements/single/getTransaction \
  --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": 35253486,
  "transactionReferenceNumber": "D250713MGGGY"
}'
{
  "merchantAccountName": "ABC Company Ltd",
  "merchantAccountNumber": 35253486,
  "sourceReferenceNumber": "QKAHXD200923",
  "beneficiaryAccountNumber": "9876543210",
  "beneficiaryName": "John Phiri",
  "connectorName": "Standard Bank",
  "transactionAmount": 1000000,
  "currencyCode": "MWK",
  "transactionStatusCode": "S",
  "transactionStatusName": "Successful",
  "transactionFee": 1000,
  "transactionReferenceNumber": "D250713MGGGY",
  "transactionDescription": "Salary payment",
  "transactionDate": "2025-01-15",
  "transactionType": "Disbursement",
  "responseCode": "DS100",
  "responseMessage": "Transaction completed successfully",
  "processedDate": "2024-01-15"
}

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

Required string length: 8

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

35253486

ā€‹
transactionReferenceNumber
string
required

The unique transaction reference number

Example:

"D250713MGGGY"

Response

200 - application/json

Success Response (200 OK)

ā€‹
merchantAccountName
string

The name of the merchant account

Example:

"ABC Company Ltd"

ā€‹
merchantAccountNumber
integer

A unique identifier for the merchant account.

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

35253486

ā€‹
sourceReferenceNumber
string

A unique identifier for the source of the transaction.

Example:

"QKAHXD200923"

ā€‹
beneficiaryAccountNumber
string

The account number or phone number where the disbursement will be sent.

Example:

"9876543210"

ā€‹
beneficiaryName
string

The full name of the person or entity receiving the disbursement payment.

Example:

"John Phiri"

ā€‹
connectorName
string

The name of the payment connector

Example:

"Standard Bank"

ā€‹
transactionAmount
number

The amount of money to be disbursed.

Example:

1000000

ā€‹
currencyCode
string

A three-letter ISO 4217 code that identifies the currency used in the transaction

Example:

"MWK"

ā€‹
transactionStatusCode
string

The current status of the transaction.

Example:

"S"

ā€‹
transactionStatusName
string

A brief description of the transaction status.

Example:

"Successful"

ā€‹
transactionFee
number

Fee charged for the transaction

Example:

1000

ā€‹
transactionReferenceNumber
string

A unique identifier for the transaction, used for tracking and reference purposes.

Example:

"D250713MGGGY"

ā€‹
transactionDescription
string

A brief description of the transaction purpose.

Example:

"Salary payment"

ā€‹
transactionDate
string<date>

The date when the transaction was initiated

Example:

"2025-01-15"

ā€‹
transactionType
string

The type/description of the transaction

Example:

"Disbursement"

ā€‹
responseCode
string

A unified response code from the payment processor

Example:

"DS100"

ā€‹
responseMessage
string

Response message from the payment processor

Example:

"Transaction completed successfully"

ā€‹
processedDate
string<date>

The date when the transaction was processed

Example:

"2024-01-15"