OneKhusa is a secure and reliable payment gateway powered by NATSWITCH and licensed by the Reserve Bank of Malawi to enable merchants, PSPs, and organisations to send and receive money through direct integration using RESTful JSON APIs. This is the centre of all API endpoints available for the OneKhusa platform, and currently, we support electronic funds transfer (EFT) between banks and Mobile Money Operators in Malawi.

​
Environments

Our testing environment, referred to as “sandbox”, is set up to test API calls without affecting production environment data. To use our APIs, you are required to register your sandbox to test transactions for both disbursements (payouts) and collections (accept payments) on our OneKhusa web portal. Click here to sign up. Use the following base URLs when making requests to the API endpoints: 
http://dev.app.onekhusa.com/sandbox/v1
When you are satisfied with the test results using the sandbox, you can activate your production environment in the OneKhusa web portal by submitting KYC details for compliance as required by our regulator.

​
Our Authentication Approach

OneKhusa authenticates your API requests using your active merchant account’s API keys, which come in pairs of:
Key TypeDescription
API KeyUse this to authenticate API requests from your client apps and this can be publicly accessible in your web or mobile app’s client-side code.
API SecretUse this to authenticate API requests from your client server. Don’t expose this key on a website or embed it in a mobile application.
Don’t expose this key on a website or embed it in a mobile application.

​
Notable Essentials

Most of our APIs require additional parameters associated with your merchant sandbox or production environment as follows:
This parameter uniquely identifies your organisation, and you can get this value in the OneKhusa web portal under the Settings -> Profile menu.
This parameter uniquely identifies a merchant within your organisation. To get this value, you can find it under the switching merchant or Merchants menu.