Pay with MTN MoMo in WooCommerce

MTN MoMo is a mobile payment system which is available in Uganda, Ghana, Cameroon, Zambia, Swaziland, Rwanda, Ivory Coast, Benin, Guinea-Conakry, Congo Brazza and Nigeria

💥 November 2022 💥 also available in Nigeria 🇳🇬
💥 January 2022 💥 also available in South Africa 🇿🇦 and Liberia 🇱🇷

This plugin allows you to collect payments on your WooCommerce eShop using MTN MoMo in 13 countries 🇬🇭🇨🇲🇺🇬🇿🇲🇸🇿🇷🇼🇨🇮🇧🇯🇬🇳🇨🇬🇿🇦🇱🇷🇳🇬

You must have WooCommerce because we developed this plugin as a WooCommerce payment gateway 🚀

This is a fully functioning plugin not a demo version. It works in both Sandbox (development mode) and in Live (production mode).

Please keep in mind that MoMo Sandbox has several limitations imposed by MTN, see them here:

• Sandbox is not requesting real money, means no USSD request on your phone. no matter how hard you try 😂
• In the Sandbox you can only use EUR currency and certain test numbers from Sweden 🇸🇪 🥶
• Sandbox is not able to callback your application, to notify about payment status. This one is a sad limitation. 😞
• Test phones numbers to test for error conditions are limited to 46733123450, 46733123451, 46733123452, 46733123453
• Only this number will be able to “pay” after 30 seconds 46733123454 😎
• All other numbers will act like the payment was successful immediately!

How to use

1. Install and activate WooCommerce plugin before activating this plugin
2. Select EUR as your WooCommerce currency if you want to test in Sandbox
3. Select your target currency if you have done KYC process with MTN (see below for more)
4. Install and activate this plugin
5. Enter your Merchant name, MTN phone number and Email to receive notifications
6. Continue to the next step, see below

Plugin setup for MTN MoMo Sandbox – no real payments 🤮

1. Visit MoMo API Developer portal and sign-up 📧
2. Enable Collection API (NOT the Collection Widget API please)
3. Get Sandbox Collection Primary key and enter it in the Plugin settings
4. Test payments in Sandbox you can only use EUR currency

IMPORTANT for Rwanda use https://momodeveloper.mtn.co.rw to sign-up and get the keys!

Plugin setup for MTN MoMo Live – with real payments 💰😎

1. Visit MoMo API Developer portal and submit your KYC documents 📝📝📝
2. ⌛ Wait for the MTN to process your application and send you access to the Partner Portal and API management dashboard ⌛
3. Login to the momoapi.mtn.com and get your Live Collection Primary key 🔑
4. Login to the MTN Partner Portal and generate API user and API key 🔑
5. Enter Collection Primary key, API user and API key in the Plugin settings
6. Accept payments! 💰💰💰

IMPORTANT for Rwanda use https://momodeveloper.mtn.co.rw/go-live to go Live! Get Collection Primary key here https://momoapi.mtn.co.rw
Recently we got many reports that https://momodeveloper.mtn.co.rw Portal is not stable, so we advice to use https://momodeveloper.mtn.com instead.
Please check the Rwanda FAQ below for more information.

Supported currencies

Read the full description on the official page →