What Flutterwave does
The Flutterwave app lets buyers pay with their phone wallet: MTN MoMo, M-Pesa and the other wallets Flutterwave supports in each country. Flutterwave's payment page can also offer cards. The buyer picks Mobile Money at checkout, goes to Flutterwave's secure page, and approves the payment on their phone.
Countries
Flutterwave works in Kenya, Tanzania, Uganda, Zambia, Rwanda, Ghana, Nigeria, Côte d'Ivoire, Cameroon, Senegal and Burkina Faso.
Flutterwave only accepts payments in the local currency of each country. A market priced in USD in a country that uses XOF, for example, cannot use it. The app does not list these markets when you connect a market.
Connecting a market
- Open Apps, find Flutterwave, and click Install.
- Open the app, click Connect a market, pick the market, then open the Connection tab.
- Enter your Secret key from your Flutterwave dashboard. No account yet? The app links to flutterwave.com to create one. The eye icon shows what you typed.
- Click Connect. Storeep checks the keys with Flutterwave before saving, so a typo shows up now and not at a customer's checkout.
Keys are never shown again after saving. To change a key, enter the new one. Leave a field empty to keep the saved key.
Copy the Callback URL shown in the app and add it as the webhook URL in your Flutterwave dashboard. It lets Storeep confirm an order even when the buyer does not come back to your store after paying.
Test mode
Turn on Test mode and use your Flutterwave test secret key to try a payment without real money. The key must match the switch: test keys start with FLWSECK_TEST, and saving a test key with test mode off, or a live key with it on, shows an error.
Full payment or deposit
In What the customer pays online, choose how much the buyer pays by phone:
- The whole order: nothing is left to collect on delivery.
- The delivery fee: the buyer pays the shipping cost now and the rest in cash on delivery.
- A fixed amount: for example 2,000 FCFA now, the rest on delivery.
- A share of the order: a percentage between 1 and 99.
A small deposit filters out fake orders and cuts refused deliveries, while buyers who prefer cash still pay most of the order on delivery. If the order has free shipping, or the deposit is larger than the order, the buyer simply pays the whole order online.
How orders are confirmed
A Mobile Money order is saved as abandoned until Flutterwave confirms the payment. Storeep confirms it as soon as Flutterwave reports the payment, even if the buyer closes the page. While the buyer still has to approve on their phone, the thank you page asks them to do so.
- Full payment: the order becomes Done and is marked Paid, like card payments.
- Deposit: the order becomes pending and follows your normal cash on delivery flow. The order page shows Deposit paid, the amount paid online, the amount To collect on delivery, and Flutterwave's payment reference.
Courier apps that send your delivery partner an amount to collect receive only what is left to pay, so the buyer is never asked for money they already paid. If you use a courier app that sends product prices, check with your delivery partner that the deposit is taken off. In WhatsApp order messages, the Amount to collect tag shows the same amount.
Using more than one Mobile Money app
You can install other Mobile Money apps (CinetPay, pawaPay, Flutterwave, Moneroo, Papi and Cartflox) and connect them to the same market. The checkout then shows one Mobile Money choice for each, followed by its name, for example Mobile Money (Flutterwave), and each one keeps its own keys and deposit setting.
Fees
On the Starter plan, Storeep charges 0.5% of the whole order on Mobile Money orders, with no minimum. Paid plans pay no fee on Mobile Money orders, and these orders do not count toward the plan limits. Flutterwave charges its own fees on top.
Frequently asked questions
- Why does Mobile Money not show at checkout? The market the buyer is shopping in must be connected and activated in the Flutterwave app, and the market currency must be one Flutterwave accepts there.
- How do I stop using Flutterwave in a market? Turn off Activate in that market's settings to hide it, or select the market and click Disconnect to delete its keys.