{"id":135982,"date":"2021-02-07T21:01:32","date_gmt":"2021-02-07T21:01:32","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/mtn-momo-for-woocommerce\/"},"modified":"2022-12-01T16:07:41","modified_gmt":"2022-12-01T16:07:41","slug":"pay-with-mtn-momo-woocommerce","status":"publish","type":"plugin","link":"https:\/\/frp.wordpress.org\/plugins\/pay-with-mtn-momo-woocommerce\/","author":13657982,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.6","stable_tag":"1.0.6","tested":"6.1.10","requires":"5.0","requires_php":"7.0","requires_plugins":"","header_name":"MTN MoMo for WooCommerce","header_author":"mstonys","header_description":"Accept payments over MTN MoMo in WooCommerce","assets_banners_color":"ffe062","last_updated":"2022-12-01 16:07:41","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/www.clickon.ch","header_plugin_uri":"https:\/\/www.clickon.ch","header_author_uri":"https:\/\/profiles.wordpress.org\/mstonys\/","rating":5,"author_block_rating":0,"active_installs":100,"downloads":14021,"num_ratings":18,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"mstonys","date":"2021-03-03 23:44:12"},"1.0.1":{"tag":"1.0.1","author":"mstonys","date":"2021-03-28 15:05:46"},"1.0.2":{"tag":"1.0.2","author":"mstonys","date":"2021-06-17 08:31:22"},"1.0.3":{"tag":"1.0.3","author":"mstonys","date":"2021-08-24 16:07:34"},"1.0.4":{"tag":"1.0.4","author":"mstonys","date":"2022-05-05 21:55:49"},"1.0.5":{"tag":"1.0.5","author":"mstonys","date":"2022-05-07 10:55:02"},"1.0.6":{"tag":"1.0.6","author":"mstonys","date":"2022-12-01 16:07:41"}},"upgrade_notice":{"1.0.1":"<ul>\n<li>Tested with Wordpress 5.7<\/li>\n<li>Fixed PHP notices<\/li>\n<li>Support for Rwanda portal momodeveloper.mtn.co.rw<\/li>\n<\/ul>","1.0.0":"<ul>\n<li>Our first version with MTN MoMo Live and Sandbox, Collection API is fully supported<\/li>\n<\/ul>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":18},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":2470497,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":2470497,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":2470497,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":2827150,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":2827150,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1","1.0.2","1.0.3","1.0.4","1.0.5","1.0.6"],"block_files":[],"assets_screenshots":{"screenshot-1.gif":{"filename":"screenshot-1.gif","revision":2470497,"resolution":"1","location":"assets","locale":"","width":1014,"height":1334},"screenshot-2.png":{"filename":"screenshot-2.png","revision":2470497,"resolution":"2","location":"assets","locale":"","width":2060,"height":1384},"screenshot-3.png":{"filename":"screenshot-3.png","revision":2470497,"resolution":"3","location":"assets","locale":"","width":2050,"height":1338}},"screenshots":{"1":"WooCommerce Shop demo purchase with MTN MoMo","2":"Plugin settings, Live setup","3":"Plugin settings, Sandbox setup"}},"plugin_section":[],"plugin_tags":[161051,37360,187426,507,6593],"plugin_category":[45],"plugin_contributors":[196003],"plugin_business_model":[],"class_list":["post-135982","plugin","type-plugin","status-publish","hentry","plugin_tags-momo","plugin_tags-mtn","plugin_tags-mtn-momo","plugin_tags-payment","plugin_tags-payment-gateway","plugin_category-ecommerce","plugin_contributors-mstonys","plugin_committers-mstonys"],"banners":{"banner":"https:\/\/ps.w.org\/pay-with-mtn-momo-woocommerce\/assets\/banner-772x250.png?rev=2827150","banner_2x":"https:\/\/ps.w.org\/pay-with-mtn-momo-woocommerce\/assets\/banner-1544x500.png?rev=2827150","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/pay-with-mtn-momo-woocommerce\/assets\/icon.svg?rev=2470497","icon":"https:\/\/ps.w.org\/pay-with-mtn-momo-woocommerce\/assets\/icon.svg?rev=2470497","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/pay-with-mtn-momo-woocommerce\/assets\/screenshot-1.gif?rev=2470497","caption":"WooCommerce Shop demo purchase with MTN MoMo"},{"src":"https:\/\/ps.w.org\/pay-with-mtn-momo-woocommerce\/assets\/screenshot-2.png?rev=2470497","caption":"Plugin settings, Live setup"},{"src":"https:\/\/ps.w.org\/pay-with-mtn-momo-woocommerce\/assets\/screenshot-3.png?rev=2470497","caption":"Plugin settings, Sandbox setup"}],"raw_content":"<!--section=description-->\n<p><em>MTN MoMo<\/em> is a mobile payment system which is available in <em>Uganda, Ghana, Cameroon, Zambia, Swaziland, Rwanda, Ivory Coast, Benin, Guinea-Conakry, Congo Brazza and Nigeria<\/em><\/p>\n\n<p>\ud83d\udca5 November 2022 \ud83d\udca5 also available in Nigeria \ud83c\uddf3\ud83c\uddec\n\ud83d\udca5 January 2022 \ud83d\udca5 also available in South Africa \ud83c\uddff\ud83c\udde6 and Liberia \ud83c\uddf1\ud83c\uddf7<\/p>\n\n<p>This plugin allows you to collect payments on your WooCommerce eShop using <em>MTN MoMo<\/em> in 13 countries \ud83c\uddec\ud83c\udded\ud83c\udde8\ud83c\uddf2\ud83c\uddfa\ud83c\uddec\ud83c\uddff\ud83c\uddf2\ud83c\uddf8\ud83c\uddff\ud83c\uddf7\ud83c\uddfc\ud83c\udde8\ud83c\uddee\ud83c\udde7\ud83c\uddef\ud83c\uddec\ud83c\uddf3\ud83c\udde8\ud83c\uddec\ud83c\uddff\ud83c\udde6\ud83c\uddf1\ud83c\uddf7\ud83c\uddf3\ud83c\uddec<\/p>\n\n<p>You must have <strong>WooCommerce<\/strong> because we developed this plugin as a <em>WooCommerce payment gateway<\/em> \ud83d\ude80<\/p>\n\n<p>This is a <strong>fully functioning plugin<\/strong> not a <em>demo version<\/em>. It works in both <em>Sandbox<\/em> (development mode) and in <em>Live<\/em> (production mode).<\/p>\n\n<p>Please keep in mind that MoMo Sandbox has several <code>limitations<\/code> imposed by MTN, see them here:<\/p>\n\n<ul>\n<li>Sandbox is not requesting <em>real money<\/em>, means no <strong>USSD request<\/strong> on your phone. no matter how hard you try \ud83d\ude02<\/li>\n<li>In the Sandbox you can only use <em>EUR<\/em> currency and certain test numbers from Sweden \ud83c\uddf8\ud83c\uddea \ud83e\udd76<\/li>\n<li>Sandbox is not able to callback your application, to notify about payment status. This one is a sad limitation. \ud83d\ude1e<\/li>\n<li>Test phones numbers to test for <strong>error conditions<\/strong> are limited to <code>46733123450<\/code>, <code>46733123451<\/code>, <code>46733123452<\/code>, <code>46733123453<\/code><\/li>\n<li>Only this number will be able to \"pay\" after 30 seconds <code>46733123454<\/code> \ud83d\ude0e <\/li>\n<li>All other numbers will act like the <strong>payment was successful immediately<\/strong>!<\/li>\n<\/ul>\n\n<h3>How to use<\/h3>\n\n<ol>\n<li>Install and activate <em>WooCommerce<\/em> plugin before activating this plugin<\/li>\n<li>Select <strong>EUR<\/strong> as your WooCommerce currency if you want to test in Sandbox<\/li>\n<li>Select <strong>your target currency<\/strong> if you have done KYC process with MTN (see below for more)<\/li>\n<li>Install and activate this plugin<\/li>\n<li>Enter your Merchant name, MTN phone number and Email to receive notifications<\/li>\n<li>Continue to the next step, see below<\/li>\n<\/ol>\n\n<h3>Plugin setup for MTN MoMo Sandbox - no real payments \ud83e\udd2e<\/h3>\n\n<ol>\n<li>Visit <a href=\"https:\/\/momodeveloper.mtn.com\/signup\">MoMo API Developer portal<\/a> and sign-up \ud83d\udce7<\/li>\n<li>Enable <strong>Collection API<\/strong> (NOT the Collection Widget API please)<\/li>\n<li>Get Sandbox <em>Collection Primary key<\/em> and enter it in the <strong>Plugin settings<\/strong><\/li>\n<li>Test payments in Sandbox you can <strong>only use EUR currency<\/strong><\/li>\n<\/ol>\n\n<p><strong>IMPORTANT for Rwanda<\/strong> use <code>https:\/\/momodeveloper.mtn.co.rw<\/code> to sign-up and get the keys!<\/p>\n\n<h3>Plugin setup for MTN MoMo Live - with real payments \ud83d\udcb0\ud83d\ude0e<\/h3>\n\n<ol>\n<li>Visit <a href=\"https:\/\/momodeveloper.mtn.com\/go-live\">MoMo API Developer portal<\/a> and submit your KYC documents \ud83d\udcdd\ud83d\udcdd\ud83d\udcdd<\/li>\n<li>\u231b Wait for the MTN to process your application and send you access to the Partner Portal and API management dashboard \u231b<\/li>\n<li>Login to the <a href=\"https:\/\/momoapi.mtn.com\">momoapi.mtn.com<\/a> and get your Live <em>Collection Primary key<\/em> \ud83d\udd11<\/li>\n<li>Login to the <strong>MTN Partner Portal<\/strong> and generate <em>API user<\/em> and <em>API key<\/em> \ud83d\udd11<\/li>\n<li>Enter <em>Collection Primary key<\/em>, <em>API user<\/em> and <em>API key<\/em> in the <strong>Plugin settings<\/strong><\/li>\n<li>Accept payments! \ud83d\udcb0\ud83d\udcb0\ud83d\udcb0<\/li>\n<\/ol>\n\n<p><strong>IMPORTANT for Rwanda<\/strong> use <code>https:\/\/momodeveloper.mtn.co.rw\/go-live<\/code> to go Live! Get <em>Collection Primary key<\/em> here <code>https:\/\/momoapi.mtn.co.rw<\/code>\nRecently we got many reports that https:\/\/momodeveloper.mtn.co.rw Portal is not stable, so we advice to use https:\/\/momodeveloper.mtn.com instead. \nPlease check the Rwanda FAQ below for more information.<\/p>\n\n<h3>Supported currencies<\/h3>\n\n<ul>\n<li>EUR (Sandbox only, no real payments)<\/li>\n<li>GHS Ghana \/ Ghanaian Cedi<\/li>\n<li>UGX Uganda \/ Ugandan Shilling<\/li>\n<li>XAF Cameroon \/ Central African CFA franc<\/li>\n<li>RWF Rwanda \/ Rwandan Franc<\/li>\n<li>XOF Benin \/ West African CFA franc<\/li>\n<li>XOF Ivory Coast \/ West African CFA franc<\/li>\n<li>XAF Congo Brazza \/ Central African CFA franc<\/li>\n<li>SZL Eswatini\/Swaziland \/ Swazi Lilangeni<\/li>\n<li>GNF Guinea-Conakry \/ Guinean Franc<\/li>\n<li>ZMW Zambia \/ Zambian Kwacha<\/li>\n<li>ZAR South Africa \/ South African Rand<\/li>\n<li>LRD Liberia \/ Liberian dollar &amp; USD<\/li>\n<li>NRN Nigeria \/ Naira<\/li>\n<\/ul>\n\n<p>** IMPORTANT Do not forget to select your country and the currency in WooCommerce settings **<\/p>\n\n<h3>DEMO eShop - in Sandbox mode<\/h3>\n\n<p>No real payments can be done, eShop currency EUR <a href=\"https:\/\/demo.momo.clickon.ch\">demo.momo.clickon.ch<\/a><\/p>\n\n<h3>How to get Support<\/h3>\n\n<p>You have several ways to request support for this plugin:<\/p>\n\n<ul>\n<li>You can send us an Email to momo-plugin@clickon.ch \ud83d\ude4b\ud83d\udce7<\/li>\n<li>Submit your question to the plugin discussion board on wordpress.com \ud83d\ude4b\ud83d\udde3\ufe0f<\/li>\n<li>Visit <a href=\"https:\/\/momodeveloper.mtn.com\/contact-support\">MTN MoMo Skype forums<\/a> (ask for <code>Mindaugas<\/code>) \ud83d\ude4b\ud83d\ude0b<\/li>\n<\/ul>\n\n<p>We will be more than happy to help you! \ud83d\udc4d<\/p>\n\n<h3>Disclaimer<\/h3>\n\n<p>ClickOn GmbH, the company behind this plugin and MTN MoMo Gateway, are not affiliated with MTN or WooCommerce. Please keep this in mind. \ud83d\ude0e\nThis is a free plugin with <strong>Free<\/strong> gateway package, upgrade to <strong>Pro<\/strong> for more features, drop us an Email to <em>momo-plugin@clickon.ch<\/em><\/p>\n\n<h3>Privacy policy<\/h3>\n\n<p>Please check our <a href=\"https:\/\/www.clickon.ch\/momo-gateway-privacy-policy\">Privacy policy<\/a> and see how we are handling your private data like name, phone numbers, Email address and any other data.<\/p>\n\n<!--section=installation-->\n<p>This section describes how to install the plugin and get it working.<\/p>\n\n<ol>\n<li>Unzip <code>pay-with-mtn-momo-woocommerce.zip<\/code> to the <code>\/wp-content\/plugins\/<\/code> directory, or install from the WordPress Plugins Directory.<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n<li>Configure plugin under WooCommerce-&gt;Payments, look for <em>MTN MoMo<\/em><\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='do%20you%20have%20a%20demo%20website%3F'><h3>Do you have a demo website?<\/h3><\/dt>\n<dd><p>Yes, it is here <a href=\"https:\/\/demo.momo.clickon.ch\">demo.momo.clickon.ch<\/a>, no real payments can be done, eShop currency <em>EUR<\/em><\/p><\/dd>\n<dt id='do%20you%20have%20a%20live%20demo%3F'><h3>Do you have a Live demo?<\/h3><\/dt>\n<dd><p>No yet. We are working on it. However, you can check https:\/\/kivea.net for inspiration \ud83d\ude0e<\/p><\/dd>\n<dt id='which%20phone%20number%20the%20momo%20request%20is%20sent%3F'><h3>Which phone number the MoMo request is sent?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id='how%20can%20we%20do%20real%20payments%3F'><h3>How can we do real payments?<\/h3><\/dt>\n<dd><p>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\nRemember it will require you do submit the KYC documents, your passport copy etc. it is quite some paper work, so please seek legal advice!<\/p><\/dd>\n<dt id='what%20is%20the%20phone%20number%20format%20to%20use%20during%20the%20checkout%3F'><h3>What is the phone number format to use during the checkout?<\/h3><\/dt>\n<dd><p>We are sending MoMo requests to the phone number provided during the checkout, so it must follow a certain format, for example:<\/p>\n\n<ul>\n<li>237698936XXX - Cameroon<\/li>\n<li>233204701XXX - Ghana<\/li>\n<li>256700908XXX - Uganda<\/li>\n<li>268782XXXXX - Eswatini<\/li>\n<li>24206422XXXX - Congo B<\/li>\n<\/ul>\n\n<p>No \"+\" in front and always with the country code!<\/p><\/dd>\n<dt id='for%20rwanda%20is%20it%20possible%20to%20use%20momodeveloper.mtn.com%20to%20get%20sandbox%20primary%20key%3F'><h3>For Rwanda is it possible to use momodeveloper.mtn.com to get Sandbox primary key?<\/h3><\/dt>\n<dd><p>In case you are in Rwanda you should use a dedicated portal at https:\/\/momodeveloper.mtn.co.rw, however if you\nset your WooCommerce Country \/ State to anything but Rwanda you can use Sandbox Primary key from https:\/\/momodeveloper.mtn.com<\/p>\n\n<p>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.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.6<\/h4>\n\n<ul>\n<li>Wordpress 6.1 support added and WooCommerce 7.1<\/li>\n<li>Add support for Nigerian Naira NGN and MTN Nigeria<\/li>\n<li>Uses Wordpress AJAX call to get payment status, more secure<\/li>\n<li>Delay checkout in Sandbox<\/li>\n<li>Checkout warning message in Sandbox<\/li>\n<\/ul>\n\n<h4>1.0.5<\/h4>\n\n<ul>\n<li>Wordpress 6.0 support added<\/li>\n<li>Fixes order with floating point amounts like 0.2 USD etc.<\/li>\n<li>Fixes for Liberia to support both USD and LRD currencies<\/li>\n<\/ul>\n\n<h4>1.0.4<\/h4>\n\n<ul>\n<li>Removed request count<\/li>\n<li>Better handling of Wordpress multisite instalations<\/li>\n<\/ul>\n\n<h4>1.0.3<\/h4>\n\n<ul>\n<li>Fixed setup issues for AWS Lightsail<\/li>\n<li>Fixed XAF currency support in Cameroon and Congo Brazza<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Documentation updated<\/li>\n<li>Fixed REST callback, <code>permission_callback<\/code> added<\/li>\n<li>Deprecation warnings removed<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Tested with Wordpress 5.7<\/li>\n<li>Fixed PHP notices<\/li>\n<li>Support for Rwanda portal momodeveloper.mtn.co.rw  <\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Our first version with MTN MoMo Live and Sandbox, Collection API is fully supported<\/li>\n<\/ul>","raw_excerpt":"Accept secure MTN Mobile Money aka MoMo payments on your WooCommerce web store or eShop.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/frp.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/135982","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/frp.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/frp.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/frp.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=135982"}],"author":[{"embeddable":true,"href":"https:\/\/frp.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/mstonys"}],"wp:attachment":[{"href":"https:\/\/frp.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=135982"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/frp.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=135982"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/frp.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=135982"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/frp.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=135982"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/frp.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=135982"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/frp.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=135982"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}