Title: Pay with MTN MoMo in WooCommerce Author: ClickOn GmbH Published: February 7, 2021 Last modified: December 1, 2022 --- Search plugins ![](https://ps.w.org/pay-with-mtn-momo-woocommerce/assets/banner-772x250.png?rev =2827150) This plugin **hasn’t been tested with the latest 3 major releases of WordPress**. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress. ![](https://ps.w.org/pay-with-mtn-momo-woocommerce/assets/icon.svg?rev=2470497) # Pay with MTN MoMo in WooCommerce By [ClickOn GmbH](https://profiles.wordpress.org/mstonys/) [Download](https://downloads.wordpress.org/plugin/pay-with-mtn-momo-woocommerce.1.0.6.zip) * [Details](https://tzm.wordpress.org/plugins/pay-with-mtn-momo-woocommerce/#description) * [Reviews](https://tzm.wordpress.org/plugins/pay-with-mtn-momo-woocommerce/#reviews) * [Installation](https://tzm.wordpress.org/plugins/pay-with-mtn-momo-woocommerce/#installation) * [Development](https://tzm.wordpress.org/plugins/pay-with-mtn-momo-woocommerce/#developers) [Support](https://wordpress.org/support/plugin/pay-with-mtn-momo-woocommerce/) ## Description _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](https://momodeveloper.mtn.com/signup) 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](https://momodeveloper.mtn.com/go-live) 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](https://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 * EUR (Sandbox only, no real payments) * GHS Ghana / Ghanaian Cedi * UGX Uganda / Ugandan Shilling * XAF Cameroon / Central African CFA franc * RWF Rwanda / Rwandan Franc * XOF Benin / West African CFA franc * XOF Ivory Coast / West African CFA franc * XAF Congo Brazza / Central African CFA franc * SZL Eswatini/Swaziland / Swazi Lilangeni * GNF Guinea-Conakry / Guinean Franc * ZMW Zambia / Zambian Kwacha * ZAR South Africa / South African Rand * LRD Liberia / Liberian dollar & USD * NRN Nigeria / Naira ** IMPORTANT Do not forget to select your country and the currency in WooCommerce settings ** ### DEMO eShop – in Sandbox mode No real payments can be done, eShop currency EUR [demo.momo.clickon.ch](https://demo.momo.clickon.ch) ### How to get Support You have several ways to request support for this plugin: * You can send us an Email to momo-plugin@clickon.ch 🙋📧 * Submit your question to the plugin discussion board on wordpress.com 🙋🗣️ * Visit [MTN MoMo Skype forums](https://momodeveloper.mtn.com/contact-support) ( ask for `Mindaugas`) 🙋😋 We will be more than happy to help you! 👍 ### Disclaimer ClickOn GmbH, the company behind this plugin and MTN MoMo Gateway, are not affiliated with MTN or WooCommerce. Please keep this in mind. 😎 This is a free plugin with** Free** gateway package, upgrade to **Pro** for more features, drop us an Email to _momo-plugin@clickon.ch_ ### Privacy policy Please check our [Privacy policy](https://www.clickon.ch/momo-gateway-privacy-policy) and see how we are handling your private data like name, phone numbers, Email address and any other data. ## Screenshots [⌊WooCommerce Shop demo purchase with MTN MoMo⌉⌊WooCommerce Shop demo purchase with MTN MoMo⌉[ WooCommerce Shop demo purchase with MTN MoMo [⌊Plugin settings, Live setup⌉⌊Plugin settings, Live setup⌉[ Plugin settings, Live setup [⌊Plugin settings, Sandbox setup⌉⌊Plugin settings, Sandbox setup⌉[ Plugin settings, Sandbox setup ## Installation This section describes how to install the plugin and get it working. 1. Unzip `pay-with-mtn-momo-woocommerce.zip` to the `/wp-content/plugins/` directory, or install from the WordPress Plugins Directory. 2. Activate the plugin through the ‘Plugins’ menu in WordPress 3. Configure plugin under WooCommerce->Payments, look for _MTN MoMo_ ## FAQ ### Do you have a demo website? Yes, it is here [demo.momo.clickon.ch](https://demo.momo.clickon.ch), no real payments can be done, eShop currency _EUR_ ### Do you have a Live demo? No yet. We are working on it. However, you can check https://kivea.net for inspiration 😎 ### Which phone number the MoMo request is sent? We are sending the MoMo Pay request to the phone number provided on the checkout form. The format is 256XXXXXXXXX, where 256 is country code. ### How can we do real payments? To accept real aka Live payments you must be approved by MTN, the process is called“ Go Live” you can read about it here https://momodeveloper.mtn.com/go-live Remember it will require you do submit the KYC documents, your passport copy etc. it is quite some paper work, so please seek legal advice! ### What is the phone number format to use during the checkout? We are sending MoMo requests to the phone number provided during the checkout, so it must follow a certain format, for example: * 237698936XXX – Cameroon * 233204701XXX – Ghana * 256700908XXX – Uganda * 268782XXXXX – Eswatini * 24206422XXXX – Congo B No “+” in front and always with the country code! ### For Rwanda is it possible to use momodeveloper.mtn.com to get Sandbox primary key? In case you are in Rwanda you should use a dedicated portal at https://momodeveloper. mtn.co.rw, however if you set your WooCommerce Country / State to anything but Rwanda you can use Sandbox Primary key from https://momodeveloper.mtn.com Recently there were many reports that https://momodeveloper.mtn.co.rw Portal is not very stable, so we do advice to use https://momodeveloper.mtn.com instead. ## Reviews ![](https://secure.gravatar.com/avatar/ba177144eac24cd1ff07709e5e5666706bef65c6ffd85477816e6489521d2e75? s=60&d=retro&r=g) ### 󠀁[very good](https://wordpress.org/support/topic/seems-nice-but-no-access/)󠁿 [wbuser](https://profiles.wordpress.org/parfait0202/) January 24, 2023 3 replies good ![](https://secure.gravatar.com/avatar/eb1a3c2c4bf9e481bff31d6d68423a0059f70d25bdc1106f6796114a612bd27c? s=60&d=retro&r=g) ### 󠀁[Thanks to the developer](https://wordpress.org/support/topic/thanks-to-the-developer-4/)󠁿 [ebright](https://profiles.wordpress.org/ebright/) January 13, 2023 I am someone who is interested in having the abilities of running an ecommerce website where clients will be able to pay using MoMo. I am not a programmer and that's why I approached the developer for help. I am moved by the time he took answering all my questions and guiding me with steps to take. I received all the support I needed and in a very short time. He is always available. I also like the fact that this plugin is consistently updated. Thank you. ![](https://secure.gravatar.com/avatar/0805ffb92be9d3fac9dc319588e45d430eab721c58a775fd1c3c776da3799486? s=60&d=retro&r=g) ### 󠀁[WOW… This the best MTN MoMo Plugin ever…](https://wordpress.org/support/topic/wow-this-the-best-mtn-momo-plugin-ever/)󠁿 [isaackamis2](https://profiles.wordpress.org/isaackamis2/) December 13, 2022 2 replies It took me almost 10 min to install and start using it on our website gumaho.com Awesome support, I recommend Pay with MTN MoMo in WooCommerce to my friends and and local developer community. Thank you ![](https://secure.gravatar.com/avatar/be3050ecd85249a3deb9e93f268ecce5ad4a324403bc07ed7297505be6698693? s=60&d=retro&r=g) ### 󠀁[Great plugin, great support](https://wordpress.org/support/topic/great-plugin-great-support-1694/)󠁿 [primepress](https://profiles.wordpress.org/primepress/) December 1, 2022 Currently using this plugin as a momo payment gateway for ecommerce websites in Eswatini ![](https://secure.gravatar.com/avatar/baf55d78a6b40e96024411193d2adfef37df261fb1e2fd7f62c0e295a18175a4? s=60&d=retro&r=g) ### 󠀁[Best MTN MoMo Plugin for WooCommerce. Free! Easy Setup! Works Excellently!](https://wordpress.org/support/topic/free-plugin-and-works-excellently/)󠁿 [liberianmusicstore](https://profiles.wordpress.org/liberianmusicstore/) May 7, 2022 I'm using this plugin from Liberia and it's working so well. Very Easy to setup. This is the best MTN MoMo plugin for WooCommerce. And yes, it is Free! ![](https://secure.gravatar.com/avatar/ab78e9d61aed71bcd8dc5916d6b7f70253e19d6dd10158f8603e8568874fe165? s=60&d=retro&r=g) ### 󠀁[The best and only MTN MOMO woocommerce plugin](https://wordpress.org/support/topic/the-best-and-only-mtn-momo-woocommerce-plugin/)󠁿 [nahasco](https://profiles.wordpress.org/nahasco/) May 7, 2022 Plugin support is quick and effective. Great developer! [ Read all 18 reviews ](https://wordpress.org/support/plugin/pay-with-mtn-momo-woocommerce/reviews/) ## Contributors & Developers “Pay with MTN MoMo in WooCommerce” is open source software. The following people have contributed to this plugin. Contributors * [ ClickOn GmbH ](https://profiles.wordpress.org/mstonys/) [Translate “Pay with MTN MoMo in WooCommerce” into your language.](https://translate.wordpress.org/projects/wp-plugins/pay-with-mtn-momo-woocommerce) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/pay-with-mtn-momo-woocommerce/), check out the [SVN repository](https://plugins.svn.wordpress.org/pay-with-mtn-momo-woocommerce/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/pay-with-mtn-momo-woocommerce/) by [RSS](https://plugins.trac.wordpress.org/log/pay-with-mtn-momo-woocommerce/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.6 * WordPress 6.1 support added and WooCommerce 7.1 * Add support for Nigerian Naira NGN and MTN Nigeria * Uses WordPress AJAX call to get payment status, more secure * Delay checkout in Sandbox * Checkout warning message in Sandbox #### 1.0.5 * WordPress 6.0 support added * Fixes order with floating point amounts like 0.2 USD etc. * Fixes for Liberia to support both USD and LRD currencies #### 1.0.4 * Removed request count * Better handling of WordPress multisite instalations #### 1.0.3 * Fixed setup issues for AWS Lightsail * Fixed XAF currency support in Cameroon and Congo Brazza #### 1.0.2 * Documentation updated * Fixed REST callback, `permission_callback` added * Deprecation warnings removed #### 1.0.1 * Tested with WordPress 5.7 * Fixed PHP notices * Support for Rwanda portal momodeveloper.mtn.co.rw #### 1.0.0 * Our first version with MTN MoMo Live and Sandbox, Collection API is fully supported ## Meta * Version **1.0.6** * Last updated **4 ⵉⵙⴳⴳⵯⴰⵙⵏ ago** * Active installations **100+** * WordPress version ** 5.0 or higher ** * Tested up to **6.1.15** * PHP version ** 7.0 or higher ** * Language * [English (US)](https://wordpress.org/plugins/pay-with-mtn-momo-woocommerce/) * Tags * [momo](https://tzm.wordpress.org/plugins/tags/momo/)[mtn](https://tzm.wordpress.org/plugins/tags/mtn/) [MTN MoMo](https://tzm.wordpress.org/plugins/tags/mtn-momo/)[payment](https://tzm.wordpress.org/plugins/tags/payment/) [payment gateway](https://tzm.wordpress.org/plugins/tags/payment-gateway/) * [Advanced View](https://tzm.wordpress.org/plugins/pay-with-mtn-momo-woocommerce/advanced/) ## Ratings 5 out of 5 stars. * [ 19 5-star reviews ](https://wordpress.org/support/plugin/pay-with-mtn-momo-woocommerce/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/pay-with-mtn-momo-woocommerce/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/pay-with-mtn-momo-woocommerce/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/pay-with-mtn-momo-woocommerce/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/pay-with-mtn-momo-woocommerce/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/pay-with-mtn-momo-woocommerce/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/pay-with-mtn-momo-woocommerce/reviews/) ## Contributors * [ ClickOn GmbH ](https://profiles.wordpress.org/mstonys/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/pay-with-mtn-momo-woocommerce/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://www.clickon.ch)