Skip to main content
Welcome to the Kotani Pay API reference. Our API enables businesses to purchase digital assets using local payment channels such as mobile money and bank transfers.

​
Welcome

Kotani Pay provides a comprehensive API platform that supports various use cases including remittance, forex arbitrage, lending, insurance, savings, social protection, business financing, and gig work. Our API documentation is built using OpenAPI specifications to provide you with:
  • Interactive API playground
  • Comprehensive endpoint documentation
  • Code examples in multiple languages
  • Real-time testing capabilities

Kotani Pay API Endpoints

View the complete OpenAPI specification

Run in Postman

Fork the complete API collection with environments

​
Test with Postman

Our comprehensive Postman collection includes all merchant-facing API endpoints organized by functionality, with built-in collection variables so you can point the same collection at sandbox or production. What’s included:
  • Complete API collection with all endpoints
  • Collection variables for switching between sandbox and production
  • Automatic request signing when KOTANI_PAY_SIGNATURE is set
  • Sample request bodies and response examples
To get started:
  1. Click the “Run in Postman” button above to fork the collection
  2. Set BASE_URL and API_KEY (and KOTANI_PAY_SIGNATURE, if your account requires request signing) in the collection’s variables
  3. Start testing endpoints immediately
API keys are generated from your Kotani Pay dashboard, not through the collection itself. Once your API_KEY variable is set, every request authenticates automatically, and if your account has request signing enabled, the collection signs each request for you as soon as KOTANI_PAY_SIGNATURE is set.

​
Base URLs

Sandbox Environment: https://sandbox-api.kotanipay.com
Production Environment: https://api.kotanipay.com

​
Authentication

All API endpoints require authentication using JWT Bearer tokens. You can obtain an access token by:
  1. Creating an integrator account
  2. Logging in to get a JWT token
  3. Generating an API key for ongoing operations

​
Getting Started

  1. Create an Integrator Account - Register your business to access the API
  2. Login - Authenticate to receive your JWT token
  3. Generate API Key - Create an API key for secure transaction processing
  4. Start Integrating - Begin making API calls to process transactions

​
Support

Need help getting started? Contact our support team at sales@kotanipay.com or visit our website at https://kotanipay.com