POST
/
collections
/
getTransaction
cURL
curl -X POST "https://api.onekhusa.com/sandbox/v1/collections/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": 35253486,
    "transactionReferenceNumber": "B250713MGRTW"
  }'
{
  "sourceAccountNumber": "1234567890",
  "sourceCustomerName": "Joe Doe",
  "sourceReferenceNumber": "RRAHYU200943",
  "connectorName": "Airtel Money",
  "amountSent": 75000,
  "transactionStatusCode": "S",
  "transactionStatusName": "Success",
  "transactionFee": 1000,
  "transactionReferenceNumber": "B250713MGRTW",
  "sourceCurrencyCode": "MWK",
  "transactionDescription": "Payment for services",
  "beneficiaryAccountNumber": "265999123456",
  "beneficiaryCurrencyCode": "MWK",
  "beneficiaryName": "John Phiri",
  "amountReceived": 74000,
  "transactionDate": "2024-01-15T10:30:00Z",
  "bridgeReferenceNumber": "69c7bebe-8fc3-4d0e-a827-cda444239973",
  "dateCreated": "2024-01-15T10:30:00Z",
  "transactionTypeName": "Merchant To Wallet",
  "responseCode": "DS100",
  "responseMessage": "Successful"
}

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

Unique reference number for the transaction

Example:

"B250713MGRTW"

Response

Success Response (200)

ā€‹
sourceAccountNumber
string

Account number of the source/payer

Example:

"123456789012"

ā€‹
sourceCustomerName
string

Name of the source customer

Example:

"Joe Doe"

ā€‹
connectorName
string

Name of the payment connector used

Example:

"Airtel Money"

ā€‹
sourceReferenceNumber
string

Reference number from the source

Example:

"RRAHYU200943"

ā€‹
amountSent
number

Total amount sent in the transaction

Example:

75000

ā€‹
transactionStatusCode
string

Status code of the transaction (e.g., 'S' for Success)

Example:

"S"

ā€‹
transactionStatusName
string

Human-readable status description

Example:

"Success"

ā€‹
transactionFee
number

Fee charged for the transaction

Example:

1000

ā€‹
transactionReferenceNumber
string

Unique reference number for the transaction

Example:

"B250713MGRTW"

ā€‹
sourceCurrencyCode
string

Currency code of the source amount

Example:

"MWK"

ā€‹
transactionDescription
string

Description of the transaction

Example:

"Payment for services"

ā€‹
beneficiaryAccountNumber
integer

Account number of the beneficiary/merchant

Example:

265999123456

ā€‹
beneficiaryCurrencyCode
string

Currency code of the beneficiary

Example:

"MWK"

ā€‹
beneficiaryName
string

Name of the beneficiary account

Example:

"Joe Doe"

ā€‹
amountReceived
number

Net amount received after fees (amountSent - transactionFee)

Example:

74000

ā€‹
transactionDate
string<date-time>

Date and time of the transaction

Example:

"2024-01-15T10:30:00Z"

ā€‹
bridgeReferenceNumber
string

Bridge reference number for the transaction

Example:

"69c7bebe-8fc3-4d0e-a827-cda444239973"

ā€‹
dateCreated
string<date-time>

Date and time when the transaction was created in the system

Example:

"2024-01-15T10:30:00Z"

ā€‹
transactionTypeName
string

Type/description of the transaction

Example:

"Merchant To Wallet"

ā€‹
responseCode
string

Unified response code from the payment system

Example:

"DS100"

ā€‹
responseMessage
string

Response description from the payment system

Example:

"Successful"