OneKhusa is a secure, robust and reliable payment gateway using ISO8583, ISO20022 backbone to exchange messages enabling merchants, PSPs, and organisations to send and receive money through direct integration using simplified RESTful JSON APIs. OneKhusa is licensed as Payment System Operator (PSO) provided by the regulator (central bank). This is the centre of all API endpoints available on the OneKhusa platform, and currently, we support electronic funds transfer (EFT) between banks, Mobile Money Operators, SACCOs, MFIs and Digital Wallets participating on the national switch.

​
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: 
https://api.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 yourc client server.
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.