Skip to content
Help
Payments

How do I accept Mobile Money with Papi?

Install the Papi app to accept MVola, Orange Money and Airtel Money in Madagascar with one Papi account, and take the whole order or only a deposit online, with the rest paid in cash on delivery.

4 min read

What Papi does

The Papi app lets buyers pay with their phone wallet: MVola, Orange Money and Airtel Money, all in one Papi account. The buyer picks Mobile Money at checkout, goes to Papi's secure page, and approves the payment on their phone.

Countries

Papi works in Madagascar.

Papi 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

  1. Open Apps, find Papi, and click Install.
  2. Open the app, click Connect a market, pick the market, then open the Connection tab.
  3. Enter your API key from your Papi dashboard. No account yet? The app links to papi.mg to create one. The eye icon shows what you typed.
  4. Click Connect. Storeep checks the keys with Papi 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.

Papi receives the callback address with each payment, so there is nothing to add in your Papi dashboard.

Test mode

Turn on Test mode to try a payment without real money: Papi uses the same API key and runs the payment as a test. Turn test mode off before selling.

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. Papi does not accept payments under 300 Ar, so a smaller deposit is raised to 300 Ar.

How orders are confirmed

A Mobile Money order is saved as abandoned until Papi confirms the payment. Storeep confirms it as soon as Papi 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 Papi'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 (Papi), 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. Papi 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 Papi app, and the market currency must be one Papi accepts there.
  • How do I stop using Papi 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.

Still need help?

Write to us and we will answer you.

Contact us