# Kotani Pay

## Docs

- [Generate API Key](https://developers.kotanipay.com/v3/api-reference/authentication/generate-key.md): This endpoint is used to generate an the API Key which can be used to authorize transactions and more
- [Human Verification](https://developers.kotanipay.com/v3/api-reference/authentication/human-verify.md): Complete human verification for magic link requests that were flagged as potentially suspicious
- [Authentication Login](https://developers.kotanipay.com/v3/api-reference/authentication/login.md): Login to your integrator account. This endpoint allows you to login to your account
- [Refresh Access Token](https://developers.kotanipay.com/v3/api-reference/authentication/refresh-token.md): This endpoint is used to refresh the access token using a valid refresh token
- [Create Bulk Payment Batches](https://developers.kotanipay.com/v3/api-reference/bulk-payments/create-batches.md)
- [Get Bulk Payment Batch by ID](https://developers.kotanipay.com/v3/api-reference/bulk-payments/get-batch.md)
- [Get Batch Payments](https://developers.kotanipay.com/v3/api-reference/bulk-payments/get-batch-payments.md)
- [Get Bulk Payment Statistics](https://developers.kotanipay.com/v3/api-reference/bulk-payments/get-statistics.md)
- [Get Transaction Details](https://developers.kotanipay.com/v3/api-reference/bulk-payments/get-transaction.md)
- [Get Available Wallets](https://developers.kotanipay.com/v3/api-reference/bulk-payments/get-wallets.md)
- [Get Bulk Payment Batches](https://developers.kotanipay.com/v3/api-reference/bulk-payments/list-batches.md)
- [Get Paginated Transactions](https://developers.kotanipay.com/v3/api-reference/bulk-payments/list-transactions.md)
- [Preview Bulk Payment Batches](https://developers.kotanipay.com/v3/api-reference/bulk-payments/preview-batches.md)
- [Process Bulk Payment Batch](https://developers.kotanipay.com/v3/api-reference/bulk-payments/process-batch.md)
- [Validate CSV File](https://developers.kotanipay.com/v3/api-reference/bulk-payments/validate-csv.md)
- [Get Available Banks](https://developers.kotanipay.com/v3/api-reference/country-support/banks.md): Returns a list of all supported banks with optional filtering by currency or search term. Banks are sourced from the centralized bank data registry.
- [Get Supported Countries](https://developers.kotanipay.com/v3/api-reference/country-support/countries.md): Returns a list of all supported countries with their configurations. Supports filtering by service type, currency, country code, and active status. Data is aggregated from the Provider Registry for real-time accuracy. The isEnabled flag indicates whether the authenticated integrator has this service…
- [Get Country Details](https://developers.kotanipay.com/v3/api-reference/country-support/country-details.md): Returns comprehensive details about a specific country including supported currencies, networks, and service availability. The isEnabled flag indicates whether the authenticated integrator has each service enabled and providers attached.
- [Get Deposit Service Configuration](https://developers.kotanipay.com/v3/api-reference/country-support/deposit-services.md): Returns all countries that support deposit (onramp) services with their configurations.
- [Get Available Networks](https://developers.kotanipay.com/v3/api-reference/country-support/networks.md): Returns all active mobile money networks available in a specific country, aggregated from all providers. Indicates if network selection is required.
- [Get Withdraw Service Configuration](https://developers.kotanipay.com/v3/api-reference/country-support/withdraw-services.md): Returns all countries that support withdraw (offramp) services with their configurations.
- [Generate Invoice](https://developers.kotanipay.com/v3/api-reference/cross-border/generate-invoice.md): Generate Invoice
- [Get Invoice](https://developers.kotanipay.com/v3/api-reference/cross-border/get-invoice.md): Get Invoice
- [Pay Invoice](https://developers.kotanipay.com/v3/api-reference/cross-border/pay-invoice.md): Pay Invoice
- [Get Paid Invoice Status](https://developers.kotanipay.com/v3/api-reference/cross-border/pay-invoice-status.md): Get Paid Invoice Status
- [Create Mobile Money Customer](https://developers.kotanipay.com/v3/api-reference/customers/mobile-money/create.md): An integrator can use this endpoint to create the customers who will be either receiving or sending money using mobile money.
- [Get Mobile Money Customer](https://developers.kotanipay.com/v3/api-reference/customers/mobile-money/get.md): An integrator can use this endpoint to get the customer who will be either receiving or sending money using mobile money by passing customer key.
- [Get Customer by Phone](https://developers.kotanipay.com/v3/api-reference/customers/mobile-money/get-by-phone.md): An integrator can use this endpoint to get the customer who will be either receiving or sending money using mobile money by passing phone number.
- [List Mobile Money Customers](https://developers.kotanipay.com/v3/api-reference/customers/mobile-money/list.md): An integrator can use this endpoint to get all the customers who will be either receiving or sending money using mobile money.
- [Update Mobile Money Customer](https://developers.kotanipay.com/v3/api-reference/customers/mobile-money/update.md): An integrator can use this endpoint to update the customers who will be either receiving or sending money using mobile money.
- [Validate Bank Account](https://developers.kotanipay.com/v3/api-reference/customers/validate-bank.md): Validates a bank account number format for a given country and bank code. Returns validation status, bank information, and whether the country is supported.
- [Validate Mobile Money Account](https://developers.kotanipay.com/v3/api-reference/customers/validate-mobile-money.md): Validates a phone number in any format (with or without country code). Returns validation status, country information, formatted number, and whether the country is supported for mobile money.
- [Bank Checkout Deposit](https://developers.kotanipay.com/v3/api-reference/deposits/bank-checkout.md): Customer Completed transaction using Checkout Url
- [Bank Checkout Deposit Status](https://developers.kotanipay.com/v3/api-reference/deposits/bank-checkout-status.md): An integrator can use this endpoint to check the status of a deposit
- [Card Deposit](https://developers.kotanipay.com/v3/api-reference/deposits/card.md): Customer Completed transaction using Checkout Url
- [Card Deposit Status](https://developers.kotanipay.com/v3/api-reference/deposits/card-status.md): An integrator can use this endpoint to check the status of a deposit
- [Initiate Deposit](https://developers.kotanipay.com/v3/api-reference/deposits/initiate.md): An integrator’s customers can initiate a deposit from their respective mobile money wallets.     An STK push will be sent to the customer and the respective amount will be deducted from their mobile money wallets and deposited into the integrator’s fiat wallet
- [Deposit via Mobile Money](https://developers.kotanipay.com/v3/api-reference/deposits/mobile-money.md): An integrator’s customers can initiate a deposit from their respective mobile money wallets.     An STK push will be sent to the customer and the respective amount will be deducted from their mobile money wallets and deposited into the integrator’s fiat wallet
- [Get Deposit Mobile Money Status](https://developers.kotanipay.com/v3/api-reference/deposits/mobile-money-status.md): An integrator can use this endpoint to check the status of a deposit
- [Check Deposit Status](https://developers.kotanipay.com/v3/api-reference/deposits/status.md): An integrator can use this endpoint to check the status of a deposit
- [Create Integrator Account](https://developers.kotanipay.com/v3/api-reference/integrator/create.md): This endpoint will help you create an integrator
- [Get Integrator](https://developers.kotanipay.com/v3/api-reference/integrator/get.md): This endpoint is used to retrieve an integrator details
- [Update Webhook Configuration](https://developers.kotanipay.com/v3/api-reference/integrator/update-webhook.md): Allows an integrator to update their default webhook URL, secret, and event subscriptions.
- [API Reference](https://developers.kotanipay.com/v3/api-reference/introduction.md): Kotani Pay API endpoints for digital asset transactions using local payment channels
- [Create KYC Address](https://developers.kotanipay.com/v3/api-reference/kyc/create-address.md): This api will create a new kyc address
- [Create KYC Basic Details](https://developers.kotanipay.com/v3/api-reference/kyc/create-basic-details.md): This api will create a new kyc basic details
- [Create KYC Document](https://developers.kotanipay.com/v3/api-reference/kyc/create-document.md): This api will create a new kyc document
- [Get KYC Status](https://developers.kotanipay.com/v3/api-reference/kyc/get-status.md): This api will get kyc status
- [Get Integrator KYC Users](https://developers.kotanipay.com/v3/api-reference/kyc/list-integrator-users.md): This api will get all integrator kyc users
- [Cancel Offramp Transaction](https://developers.kotanipay.com/v3/api-reference/offramp/cancel.md): This endpoint will cancel the offramp transaction.
- [Create Offramp Request](https://developers.kotanipay.com/v3/api-reference/offramp/create.md): This endpoint will create a offramp request for a customer. If the fiat transfer fails after successful crypto receipt, an automatic refund will be initiated after 5 minutes. Use the refund-status endpoint to check refund status.
- [Get Offramp Status (by Reference ID)](https://developers.kotanipay.com/v3/api-reference/offramp/get-status.md): This endpoint will return the status of the withdrawal request.
- [Get Offramp Transactions](https://developers.kotanipay.com/v3/api-reference/offramp/list-transactions.md): This endpoint will return all offramp transactions for the integrator.
- [Get Refund Status](https://developers.kotanipay.com/v3/api-reference/offramp/refund-status.md): Get the status of an onchain refund. Refunds are automatically initiated 5 minutes after a failed transaction if the crypto was successfully received but fiat transfer failed.
- [Retry Failed Refund](https://developers.kotanipay.com/v3/api-reference/offramp/retry-refund.md): Retry a failed crypto refund for an offramp transaction. Gas/fund errors can be retried up to 10 times, other errors up to 4 times. Refunds marked for manual intervention cannot be retried through this endpoint.
- [Get Offramp Status](https://developers.kotanipay.com/v3/api-reference/offramp/status.md): This endpoint will return the status of the withdrawal request.
- [Create Onramp](https://developers.kotanipay.com/v3/api-reference/onramp/create.md): You can create an onramp request with either mobile money or bank checkout
- [Send Token to Crypto Wallet](https://developers.kotanipay.com/v3/api-reference/onramp/crypto.md): This endpoint will send token to any crypto wallet
- [Get Crypto Onramp Status](https://developers.kotanipay.com/v3/api-reference/onramp/crypto-status.md): This endpoint will be used to get the status of the transaction
- [Get Crypto Onramp Status (by Reference ID)](https://developers.kotanipay.com/v3/api-reference/onramp/get-crypto-status.md): This endpoint will be used to get the status of the transaction
- [Get Onramp Status (by Reference ID)](https://developers.kotanipay.com/v3/api-reference/onramp/get-status.md): This endpoint will be used to get the status of the transaction
- [Get Onramp Status](https://developers.kotanipay.com/v3/api-reference/onramp/status.md): This endpoint will be used to get the status of the transaction
- [Initiate Payout](https://developers.kotanipay.com/v3/api-reference/payouts/initiate.md): This api will withdraw fiat from the integrator’s fiat wallet to the customer’s mobile money wallet.
- [Check Payout Status](https://developers.kotanipay.com/v3/api-reference/payouts/status.md): This endpoint will return the status of the withdrawal request.
- [Get Fiat to Fiat Exchange Rate](https://developers.kotanipay.com/v3/api-reference/rates/fiat-to-fiat.md): An integrator can use this endpoint to get the exchange rate between two fiat currencies
- [Get All Exchange Rates](https://developers.kotanipay.com/v3/api-reference/rates/get-all-rates.md): An integrator can use this endpoint to get all the exchange rates available
- [Get Exchange Rate](https://developers.kotanipay.com/v3/api-reference/rates/get-rate.md): An integrator can use this endpoint to get the exchange rate between two currencies
- [Get Offramp Exchange Rate](https://developers.kotanipay.com/v3/api-reference/rates/offramp-rate.md): An integrator can use this endpoint to get the exchange rate between two currencies
- [Get Onramp Exchange Rate](https://developers.kotanipay.com/v3/api-reference/rates/onramp-rate.md): An integrator can use this endpoint to get the exchange rate between two currencies
- [Health Check](https://developers.kotanipay.com/v3/api-reference/system/health.md): This endpoint is used to check for the health of the application
- [Payment Providers](https://developers.kotanipay.com/v3/api-reference/system/providers.md): This Api Handles fetching of payment providers
- [Create Crypto Wallet](https://developers.kotanipay.com/v3/api-reference/wallets/crypto/create.md): The crypto wallet will contain the specified chain and coins an integrator desires to hold and one can create as many wallets as needed.
- [Get Crypto Wallet](https://developers.kotanipay.com/v3/api-reference/wallets/crypto/get.md): This endpoint will return the crypto wallet created by the integrator by passing the wallet id.
- [List Crypto Wallets](https://developers.kotanipay.com/v3/api-reference/wallets/crypto/list.md): This endpoint will return all the crypto wallets created by the integrator.
- [Create Fiat Wallet](https://developers.kotanipay.com/v3/api-reference/wallets/fiat/create.md): This endpoint will create a fiat wallet for the integrator.
- [Get Fiat Wallet](https://developers.kotanipay.com/v3/api-reference/wallets/fiat/get.md): This endpoint will return the fiat wallet created by the integrator.
- [Get Wallet by Currency](https://developers.kotanipay.com/v3/api-reference/wallets/fiat/get-by-currency.md): This endpoint will return the fiat wallet created by the integrator. Optionally filter by country using the "country" query parameter.
- [List Fiat Wallets](https://developers.kotanipay.com/v3/api-reference/wallets/fiat/list.md): This endpoint will return all the fiat wallets created by the integrator.
- [Transfer Deposit Balance](https://developers.kotanipay.com/v3/api-reference/wallets/fiat/transfer-deposit-balance.md): This endpoint will transfer the deposit balance of the fiat wallet to the main balance.
- [Update Fiat Wallet](https://developers.kotanipay.com/v3/api-reference/wallets/fiat/update.md): This endpoint will update the fiat wallet created by the integrator.
- [Bank Withdrawal Status](https://developers.kotanipay.com/v3/api-reference/withdrawals/bank-status.md): This Api Handles payout to bank, currently only supports SA Banks
- [Bank Withdrawal](https://developers.kotanipay.com/v3/api-reference/withdrawals/bank-v2.md): This Api Handles payout to bank, currently only supports SA Banks
- [Lipa na M-Pesa Withdrawal](https://developers.kotanipay.com/v3/api-reference/withdrawals/lipa-na-mpesa.md): Send money from integrator wallet to customer via Lipa na M-Pesa STK Push or to a business shortcode.
- [Mobile Money Withdrawal](https://developers.kotanipay.com/v3/api-reference/withdrawals/mobile-money.md): This api will withdraw fiat from the integrator’s fiat wallet to the customer’s mobile money wallet.
- [Mobile Money Withdrawal Status](https://developers.kotanipay.com/v3/api-reference/withdrawals/mobile-money-status.md): This endpoint will return the status of the withdrawal request.
- [Paybill Withdrawal](https://developers.kotanipay.com/v3/api-reference/withdrawals/paybill.md): Send money from integrator wallet to a Paybill number with account reference.
- [Supporting Banks](https://developers.kotanipay.com/v3/api-reference/withdrawals/supporting-banks.md): This Api Handles fetching of supporting banks
- [Development Guide](https://developers.kotanipay.com/v3/development.md): Environments, authentication, request structure, and error handling for the Kotani Pay API v3
- [Balances & Settlement](https://developers.kotanipay.com/v3/essentials/balances-and-settlement.md): How deposit and payout balances work, how to move funds between them, and how to settle your earnings
- [Error Handling](https://developers.kotanipay.com/v3/essentials/error-handling.md): HTTP status codes and error response format for the Kotani Pay API
- [Offramp Refunds](https://developers.kotanipay.com/v3/essentials/offramp-refunds.md): How Kotani Pay returns crypto to integrators when a fiat disbursement fails after on-chain receipt.
- [Rate Limits](https://developers.kotanipay.com/v3/essentials/rate-limits.md): How the Kotani Pay API rate limits requests and what to expect when you exceed them
- [Transaction Statuses](https://developers.kotanipay.com/v3/essentials/transaction-statuses.md): Understand all transaction status codes used across Kotani Pay API endpoints
- [Webhook Notifications](https://developers.kotanipay.com/v3/essentials/webhooks.md): Receive real-time notifications about transaction status updates and other events.
- [Bulk Payments Flow](https://developers.kotanipay.com/v3/flows/bulk-payments-flow.md): How to disburse funds to many recipients at once — validate a CSV, assign wallets, and track batch processing
- [Deposit Flow](https://developers.kotanipay.com/v3/flows/deposit-flow.md): How to collect payments from customers via mobile money, bank checkout, or card
- [Offramp Flow (Sell Crypto)](https://developers.kotanipay.com/v3/flows/offramp-flow.md): How to convert crypto to fiat — customer sends crypto, Kotani Pay disburses fiat via mobile money or bank
- [Onramp Flow (Buy Crypto)](https://developers.kotanipay.com/v3/flows/onramp-flow.md): How to convert fiat to crypto — customer pays via mobile money or bank, Kotani Pay sends crypto to their wallet
- [Payment Links Flow](https://developers.kotanipay.com/v3/flows/payment-links-flow.md): How to create a hosted payment page and collect payments via mobile money, bank, card, or crypto
- [Withdrawal Flow](https://developers.kotanipay.com/v3/flows/withdrawal-flow.md): How to disburse funds to customers via mobile money or bank transfer
- [API Keys](https://developers.kotanipay.com/v3/getting-started/api-keys.md): How to generate API keys from the dashboard or via the API, and the two key types
- [Accessing the Dashboard](https://developers.kotanipay.com/v3/getting-started/dashboard-login.md): How to log in to the Kotani Pay dashboard, reset your password via OTP, and navigate the interface
- [Kotani Pay API v3](https://developers.kotanipay.com/v3/overview.md)
- [Quickstart](https://developers.kotanipay.com/v3/quickstart.md)
- [Run in Postman](https://developers.kotanipay.com/v3/run-in-postman.md): Fork our complete API collection and start testing immediately

## OpenAPI Specs

- [openapi](https://developers.kotanipay.com/v3/api-reference/openapi.json)