Getting started in the Kopo Kopo Sandbox

Sandbox environment

The Sandbox environment is a complete replica of the Kopo Kopo production environment, supporting all of the same API endpoints. Applications should be tested against the Sandbox environment before being used in production.

Differences from production environment

  • The Sandbox contains only test data and is completely separate from your production account.
  • All API endpoints have a base URL of instead of
  • Actual money is not sent or received as part of test transactions.
  1. Real financial data should never be used in the Sandbox.

Transaction behavior in the Sandbox

  • Transactions in the Sandbox do not exist in the real world and are just simulations

Sandbox setup

To set up your Sandbox account, you need to have a merchant account with Kopo Kopo and all we ask for is the valid email address that you use with your Kopo Kopo account. Once you agree to the Kopo Kopo Developer Terms and Service, you will receive an email asking to verify your email address.

Please note: Failure to verify your email will result in a 401 HTTP status for all API calls with an error code of InvalidAccountStatus.

After email verification, your Sandbox account will be created and you’ll be redirected to our Sandbox Dashboard at Here you can view your client id, client secret and api key and generate an OAuth access token. Koop Kopo will also associate a funding source, add Ksh 1000 to the account balance, and create an application.

Create your Sandbox account

Next Steps

Once you have a valid Sandbox account, you can start making calls to the API. To simplify development, learn about configuring and using our SDKs. You can also jump straight into the API docs or continue to our guides for step by step instructions for your appropriate funds flow.