Mobile Money - Pay-In/Pay-Out Flow

How Mobile Money Payment Works

• You will need to add mobile money as a payment method on your app or website.
• When a user selects mobile money as their payment option (note that the process may vary slightly depending on the country, though all mobile money flows are generally similar), your form should require the following inputs: Amount, Network (e.g., MTN, Vodafone, Artel Tigo, Telecel), Customer Name.

You then send this information as a request to our API endpoint where we will handle the debiting or crediting of the mobile money user.

Here is a link to our API Docs https://docs.kotanipay.com/reference/depositmobilemoneycontroller_mobilemoney

Below is a step By Step Guide on Pay-In/Pay-Out Flow

1. Create customer if they don’t already exist
   🌐 URL:
   https://docs.kotanipay.com/reference/mobilemoneycustomercontroller_createcustomer

   

2. Access the Deposit Mobile Money endpoint and enter the customer id as well as the id
   fiat wallet the deposit will be received in (this is the pay-in flow)
   🌐 URL:
   https://docs.kotanipay.com/reference/depositmobilemoneycontroller_mobilemoney

   

To get the status of a deposit transaction you can make use of the endpoint
🌐 URL:
https://docs.kotanipay.com/reference/depositmobilemoneycontroller_getwithdrawalstatus

3. To create a payout flow, use the withdraw fiat to mobile money endpoint.
   🌐 URL: https://docs.kotanipay.com/reference/withdrawcontroller_mobilemoney

To get the status of the withdrawal transaction make use of the
Get Withdrawal Mobile Money Status endpoint, using the transaction reference.
🌐URL:
https://docs.kotanipay.com/reference/withdrawcontroller_getwithdrawalstatus