31 March 2026 - OneKhusa Payment Gateway

API updates

This section highlights the new releases and improvements for OneKhusa API

Accept payments

Changed the response body structure for Get Payment as follows

{
  "beneficiary": {
    "accountNumber": 12346198,
    "accountName": "MERCHANT SANDBOX",
    "amountReceived": 49500.00,
    "currencyCode": "MWK"
  },
  "source": {
    "accountNumber": "5271306",
    "customerName": "ANGEL BAULENI",
    "amountSent": 50000.00,
    "currencyCode": "MWK",
    "sourceReferenceNumber": "JF260209114N",
    "connectorId": 212188,
    "connectorName": "National Bank of Malawi"
  },
  "transaction": {
    "transactionReferenceNumber": "CBPC73IQ5U2E",
    "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",
    "responseCode": "S100",
    "responseMessage": "Successful transaction"
  }
}

Fake Data

Changed the response body structure for Merchant Account Topup as follows

 {
  "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"
  }
}

Fake Data

Changed the response body structure for Simulate Accept Request To Pay as follows

{
  "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": "Payment Transaction",
    "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",
    "dateCreated": "2026-02-09T15:12:52.8020476+02:00"
  }
}

C# SDK

These changes are available in OneKhusa.SDK 2026.1.5.3 version.

Accept payments

Changed the response payload structure for Get Payment endpoint, refer to the transaction object under API Reference/Accept Payments above.

Fake Data

Changed the response body structure for Mock Accept Payment endpoint, refer to the transaction object under API Reference/Fake Data above.
Changed the response body structure for Mock Accept Request-To-Pay Payment endpoint, refer to the transaction object under API Reference/Fake Data above.

Merchant Portal

These changes are available in OneKhusa merchant portal.

Onboarding

Added a feature to allow merchants and organisations to submit KYC details for regulatory compliance.
Added a feature to track the onboarding application status.
Added a feature to enable merchants and organizations to sign the merchant agreement electronically.

Webhook Notifications

Added a feature to view webhook payloads received/processed for disbursements and collections.

​API updates

​Accept payments

​Fake Data

​Fake Data

​C# SDK

​Accept payments

​Fake Data

​Merchant Portal

​Onboarding

​Webhook Notifications

API updates

Accept payments

Fake Data

Fake Data

C# SDK

Accept payments

Fake Data

Merchant Portal

Onboarding

Webhook Notifications