MTN MoMo
Mobile money
- Where
- Cameroon, Republic of the Congo, Côte d'Ivoire, Benin
- Amount range
- 100–1,000,000 XAF · XOF
- Payer does
- Push to the handset · Redirect and return
- Money back
- Payout
Payment methods
A checkout that only offers cards loses most of a market where cards are the exception. IdealBox takes mobile money, cards and PayPal behind one request — and the list grows without you shipping anything.
Catalogue
Each method resolves through one of six flows. Your integration branches on the flow, never on the provider — which is why enabling a new one costs you nothing.
Mobile money
Mobile money
Card
PayPal
Apple Pay
Modelled, with no corridor behind it yet.
Google Pay
Modelled, with no corridor behind it yet.
Mobile money
Mobile money
Mobile money
Mobile money
Bank account
Modelled, with no corridor behind it yet.
Flows
The response to a payment tells you which of these you are in, and what to render. That is the entire client-side contract.
DEVICE_PUSHThe customer gets a USSD or in-app prompt and enters their PIN. Nothing happens in the browser — most mobile money runs this way.
REDIRECTThe browser goes to the provider — a 3-D Secure challenge, a Wave page, a PayPal login — and comes back to your return URL.
OTP_CHALLENGEThe provider issues a code the customer reads out. You collect it and submit it to confirm the payment.
DIRECTThe instrument is already authorised — a tokenised card. It resolves on the first call.
QR_DISPLAYRender the code we return and the customer scans it with their wallet app. Useful in person and on desktop.
VOUCHER_INSTRUCTIONShow the customer where to send funds and the reference to quote. We match the inbound transfer and resolve the payment.
Coverage
Country is data here, not a code change — a market is rows in a capability table, which is why this list grows without an API version.
| Country | Method | Amount range | Pay out |
|---|---|---|---|
| CameroonXAF | Mobile money | 100–1,000,000 | Yes |
| Republic of the CongoXAF | Mobile money | 100–1,000,000 | Yes |
| Côte d'IvoireXOF | Mobile money | 100–1,000,000 | Yes |
| BeninXOF | Mobile money | 100–1,000,000 | Yes |
| CameroonXAF | Card | 300–5,000,000 | Collect only |
| CameroonXAF | PayPal | 600–5,000,000 | Collect only |
One call returns exactly the methods that can take this amount, in this currency, in this country — including limits and whether refunds are supported. Build your checkout from the response and a newly enabled method shows up without a deploy.
curl "https://secure.idealbox.org/v1/providers?country=CM¤cy=XAF&amount=500000" \
-H "Authorization: Bearer ib_sk_test_4f2a9c1e8b7d6053"Directions
Collections and disbursements are both first-class from day one. Your balance is a liability on our ledger, and you decide when to withdraw it.
Charge a customer on any supported method. Full and partial refunds where the provider allows them.
Send money to a third party — a driver, a seller, a supplier — over mobile money or a bank transfer.
Move your own cleared balance to a bank or mobile money account. Per-wallet withdrawal blocking when you need it.
One-time or reusable hosted links, for when you would rather not build a checkout at all.
// Coming with phase 5. The envelope is the same in reverse: an amount in
// minor units, a currency, and a destination the corridor supports.
const payout = await idealbox.disbursements.create({
amount: '250000',
currency: 'XOF',
reference: 'driver-payout-88',
destination: {
methodType: 'MOBILE_MONEY',
country: 'SN',
phoneNumber: '+221770000000',
},
});Create an account, take a test key and run a payment end to end in minutes. Going live is a different key, not a different integration.
No setup fee. No monthly minimum on Start.