POST
/
collections
/
getTransaction
cURL
curl -X POST "https://dev.api.onekhusa.com/sandbox/v1/collections/getTransaction" \
  --header "Authorization: Bearer your-jwt-token" \
  --header "Content-Type: application/json" \
  --header "Accept-Language: en" \
  -d '{
    "merchantAccountNumber": 35253486,
    "transactionReferenceNumber": "B250713MGRTW"
  }'
{
  "beneficiary": {
    "accountNumber": 12346198,
    "accountName": "MERCHANT SANDBOX",
    "amountReceived": 49500,
    "currencyCode": "MWK"
  },
  "source": {
    "accountNumber": "5271306",
    "customerName": "ANGEL BAULENI",
    "amountSent": 50000,
    "currencyCode": "MWK",
    "sourceReferenceNumber": "JF260209114N",
    "connectorId": 212188,
    "connectorName": "National Bank of Malawi"
  },
  "transaction": {
    "transactionReferenceNumber": "CBPC73IQ5U2E",
    "transactionFee": 500,
    "transactionDescription": "Fake Merchant Account Topup",
    "transactionDate": "2026-02-09T15:12:52.8020476+02:00",
    "valueDate": "2026-02-09T15:12:52.8020476+02:00",
    "transactionCode": "BAM",
    "transactionTypeName": "Account To Merchant",
    "transactionStatusCode": "S",
    "transactionStatusName": "Success",
    "bridgeReferenceNumber": "019c4288-9342-7ebd-a947-6d97d4da77ed",
    "responseCode": "S100",
    "responseMessage": "Successful transaction"
  }
}

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

Body

application/json
merchantAccountNumber
integer
required

Required string length: 8

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

35253486

transactionReferenceNumber
string
required

Unique reference number for the transaction

Example:

"B250713MGRTW"

Response

200 - application/json

Success Response (200 OK)

beneficiary
object
source
object
transaction
object