Skip to main content
Follow these steps to start integrating with Kotani Pay’s payment platform.

​
Step 1: Create an integrator account

Create an integrator account to access the Kotani Pay API platform. Use the Create Integrator endpoint to register your business.
  1. Login to your account using the Authentication Login endpoint 2. Generate an API key using the Generate API Key endpoint 3. Store your credentials securely
Keep your API keys secure and never expose them in client-side code.

​
Step 2: Test the integration

Test your integration using our sandbox environment:Base URL: https://sandbox-api.kotanipay.ioStart with the Health Check endpoint to verify connectivity.
Try initiating a deposit using the Initiate Deposit endpoint.
  1. Create a mobile money customer
  2. Initiate a deposit request
  3. Check the deposit status
  4. Handle webhook notifications
Start with small amounts for testing!

​
Step 3: Go live

  1. Switch to the production base URL
  2. Update your API credentials for production
  3. Configure your webhook endpoints
  4. Start processing real transactions

​
Next steps

Explore our comprehensive API documentation:

API Reference

Complete API endpoint documentation

Deposits

Learn how to handle deposits

Payouts

Process payouts to customers

Webhooks

Set up real-time notifications