POST
/
disbursements
/
batch
/
getTransaction
cURL
curl -X POST "https://api.onekhusa.com/sandbox/v1/disbursements/batch/getTransaction" \
      --header "Authorization: Bearer your-jwt-token" \
      --header "Content-Type: application/json" \
      --header "X-Organisation-Id: FYH0NTVW0DXK" \
      --header "X-Merchant-Account-Number: 35253486" \
      --header "Accept-Language: en" \
      -d '{
        "merchantAccountNumber": 12345,
        "transactionReferenceNumber": "25092631JFIW"
      }'
{
  "merchantAccountNumber": 12345,
  "merchantAccountName": "MERCHANT SANDBOX",
  "beneficiaryName": "SUSAN KAPONDA",
  "connectorId": 212188,
  "connectorName": "National Bank of Malawi",
  "beneficiaryAccountNumber": "002125457",
  "transactionAmount": 50000,
  "transactionReferenceNumber": "25092631JFIW",
  "sourceReferenceNumber": "QKAHXD100013",
  "transactionDescription": "MTUKULA PAKHOMO FOR APR2025",
  "currencyCode": "MWK",
  "transactionStatusCode": "S",
  "transactionStatusName": "Successful",
  "transactionFee": 1000,
  "responseCode": "",
  "responseMessage": "",
  "processedDate": "2025-10-30"
}

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 unique identifier of the merchant account.

Required range: x > 0
ā€‹
transactionReferenceNumber
integer
required

The unique reference number assigned to the transaction.

Required range: x > 0

Response

Success Response (200)

ā€‹
merchantAccountNumber
string

The unique identifier of the merchant account.

ā€‹
merchantAccountName
string

The name of the merchant account.

ā€‹
transactionReferenceNumber
string

Reference number used to track and identify the transaction.

ā€‹
transactionDescription
string

Brief explanation of the transaction purpose.

ā€‹
transactionAmount
number

Amount of money being disbursed in this transaction.

ā€‹
transactionStatusCode
string

Status code of the transaction.

ā€‹
transactionStatusName
string

Human-readable description of the transaction status.

ā€‹
transactionFee
number

Fee charged for processing the transaction.

ā€‹
batchNumber
integer

Identifier of the batch to which this transaction belongs.

ā€‹
beneficiaryName
string

Full name of the person or entity receiving the funds.

ā€‹
beneficiaryAccountNumber
string

Account or phone number where the disbursement will be sent.

ā€‹
connectorId
integer

Unique identifier of the payment connector handling this transaction. See Get Connectors for the full list of available connector IDs.

ā€‹
connectorName
string

Name of the payment connector handling this transaction.

ā€‹
sourceReferenceNumber
string

Reference number from the source system or origin of the transaction.

ā€‹
currencyCode
string

Three-letter ISO 4217 currency code for the transaction amount.

ā€‹
responseCode
string

Response code from the processing system.

ā€‹
responseMessage
string

Response message from the processing system.

ā€‹
processedDate
string<date>

Date when the transaction was processed.