MTN MoMo(Mobile Money) is a payment platform that enables customers to pay for goods and services using their mobile phones.
Our plugin works in the following countries: Swaziland, and South Africa for now.
The plugin enables the customer to have an option of paying for goods or services using MTN MoMo Collection API(Not Collection Widget) from a WordPress site with WooCommerce plugin installed.
The plugin is a Woocommerce Payment Gateway which adds an option on the checkout section for paying through MTN MoMo(A mobile payment platform).
PLUGIN SETUP FOR MTN MOMO SANDBOX
Testing of the plugin is possible by creating an account in the MoMo API portal.
For Eswatini/Swaziland sign up to https://momodeveloper.mtn.com/ and get the keys.
After account creation, log in to the account and subscribe to the Collection product in order to get the Primary Key, Secondary Key also known as Ocp-Apim-Subscription-Key.
When logged in, you can be able to see the Primary Key and Secondary Key after clicking on your profile.
Use the Primary Key/Secondary Key referred to as Ocp-Apim-Subscription-Key header in a sandbox API to generate the API User and API Key.
Generate the API User(Use online UUID generator to come up with a UUID value to use in the Sandbox API for generating a user)
Generate the API Key the reference ID(UUID) in the previous request for generating API user
Get more information on the API Key and API User generation HERE
Access the plugin settings here(WooCommerce ➡ Settings ➡ Payments ➡ MoMo – MTN MoMo)
Fill in the API Key, API User and Ocp-Apim-Subscription-Key(Primary Key/Secondary Key) in the plugin settings, save and start testing.
The Endpoints for Sandbox and currency are already filled by default when you install the plugin.
Note these items when testing in Sandbox:
1. No USSD Push request on your phone, therefore no deductions will be made to your account when testing in Sandbox.
2. These test phone numbers are used to test error conditions: 46733123450, 46733123451, 46733123452, 46733123453.
3. All other numbers will act like the payment was successful immediately without any USSD Push.
PLUGIN SETUP FOR MTN MOMO PRODUCTION
To receive payments, one must GO LIVE by submitting your KYC documents when logged in to MTN Developer Portal.
For Swaziland use https://momodeveloper.mtn.com/go-live to Go Live and then get the Primary Key here https://partner.mtn.co.sz:16443/
Wait for MTN to process your application and send you access to the Partner Portal and API management dashboard.
Login to your email approve by MTN Eswatini to get your Live Collection Primary key(Ocp-Apim-Subscription-Key)
Login to the MTN Partner Portal and generate API user and API key.
Purchase the Pro Version of the plugin HERE and download it from the link that will be sent to your email account.
Install the plugin by uploading the zipped file containing the plugin and activate it.
Enter Collection Primary key(Ocp-Apim-Subscription-Key), API User and API Key in the Plugin settings located here(WooCommerce ➡ Settings ➡ Payments ➡ MoMo – MTN MoMo)
Confirm the Payment Endpoint and Credential Endpoints are not for Sandbox.
Fill in the currency depending on the country you have gone live in, there are the currencies available:
EUR (Sandbox)
SZL Eswatini/Swaziland
ZAR South Africa
Save the details and start reveiving payments.
We already have some customers who have gone live with the plugin and one of them is eswatinitickets.com who are using the plugin to sell digital products.
PLUGIN CUSTOMER JOURNEY
When the customer clicks on the Pay button on the payment page, the plugin will initiate a payment authorization request to the customer.
The customer will then accept or decline the payment from the personal mobile phone and the payment can be confirmed by clicking the Complete Order button.
The order status in the online shop is then changed depending on the customer’s action(In the Pro Version).
This free version of the plugin does not change order status and does not have the functionality of checking the transaction status of the payments but the Pro Version does.
The main purpose of the free version is to test the functionality of how your website will work and it’s compatibility with your website before deciding to use it in production.
To be able to get the Pro Version please purchase the plugin on our website HERE and a download link will be sent to the email address filled in the checkout form.
How to use:
Make sure you have installed and activated WooCommerce plugin before installing and activating this plugin.
Upload Payment Gateway for MTN MoMo on WooCommerce plugin files to the wordpress plugins directory (/wp-content/plugins/), or install the plugin from the WordPress admin plugin screen.
Activate the plugin.
On the WordPress admin, navigate to WooCommerce ➡ Settings ➡ Payments ➡ MoMo – MTN MoMo Manage and fill in the fields provided in order for the plugin to work.
