API updates

This section highlights the new releases and improvements for OneKhusa API

Batch Disbursements

  • Changed from string response to object response for Reject Batch, Approve Batch, Review, Cancel Batch and Transfer Funds endpoints as follows:
{ 
  "MerchantAccountNumber": 12345678, 
  "BatchNumber": 123456, 
  "CurrencyCode": "MWK", 
  "BatchStatusCode": "A", 
  "ContentType": "CSV", 
  "DataSource": "File", 
  "NumberOfSuccessfulEntries": 1200, 
  "TotalAmountOfSuccessfulEntries": 52000500.00 
} 
  • Added download batch errors endpoint to download errors identified during batch processing either through Upload Batch File or Upload Batch JSON endpoints.

Fake Data

{ 
  "transactionReferenceNumber": "CBPC73IQ5U2E", 
  "beneficiaryAccountNumber": 12346198, 
  "beneficiaryName": "MERCHANT SANDBOX", 
  "beneficiaryCurrencyCode": "MWK", 
  "sourceAccountNumber": "5271306", 
  "sourceCustomerName": "ANGEL BAULENI", 
  "sourceReferenceNumber": "JF260209114N", 
  "sourceCurrencyCode": "MWK", 
  "connectorName": "National Bank of Malawi", 
  "amountSent": 50000.00, 
  "amountReceived": 49500.00, 
  "transactionFee": 500.00, 
  "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", 
  "dateCreated": "2026-02-09T15:12:52.8020476+02:00", 
  "responseCode": "S100", 
  "responseMessage": "Successful transaction" 

} 

C# SDK Release

OneKhusa has officially released the SDK for C# programming language to aid developers to integrate seamlessly with the payment gateway APIs. For more details about the SDK, click here