M-Pesa is the largest mobile network operators in Kenya and Tanzania. Safaricom, by Vodafone, launched M-Pesa payment gateway which is a mobile money phone-based transfer, and financing service. Meetanshi has developed Magento 2 M-Pesa Payment extension that integrates Magento 2 store with this payment gateway's API, Lipa Na M-Pesa and C2B M-Pesa Based on the business requirements, the merchants can choose the API integration in Magento 2 store that will facilitate real-time payment notifications, easy reconciliation, low cost, and secure payment process.

1. Lipa Na M-Pesa Payment for Magento 2 © Meetanshi
Lipa Na M-Pesa Payment for Magento 2
User Guide
Table of Content
1. Extension Installation
2. Configuration
3. Lipa Na M-Pesa Payment Method in Frontend
4. Lipa Na M-Pesa Payment Details in Backend

2. Lipa Na M-Pesa Payment for Magento 2 © Meetanshi
1. Extension Installation
• For Magento Marketplace Customers
o Create a folder structure in Magento root as app/code/Meetanshi/Lipa
o Download and extract the zip folder and upload our extension files to the
app/code/Meetanshi/Lipa via FTP.
o Login to your SSH and run below commands step by step:
▪ php bin/magento setup:upgrade
▪ For Magento version 2.0.x to 2.1.x - php bin/magento setup:static-content:deploy
▪ For Magento version 2.2.x & above - php bin/magento setup:static-content:deploy –f
▪ php bin/magento cache:flush
• For Meetanshi Customers
o Extract the zip folder and upload our extension to the root of your Magento 2 directory via
FTP.
o Login to your SSH and run below commands step by step:
▪ php bin/magento setup:upgrade
▪ For Magento version 2.0.x to 2.1.x - php bin/magento setup:static-content:deploy
▪ For Magento version 2.2.x & above - php bin/magento setup:static-content:deploy –f
▪ php bin/magento cache:flush

3. Lipa Na M-Pesa Payment for Magento 2 © Meetanshi
2. Configuration
For configuring the extension, log in to Magento 2, move to Sales → Payments Methods →
Lipa Na M-Pesa Payment - Meetanshi where you can find various settings to enable the
extension.
• Enabled: Set “YES” to enable the payment method.
• Title: Set the title of the payment method to be displayed in the frontend.
• Show M-Pesa Logo: Set YES to show M-Pesa logo along with the payment method in the
frontend.
• Sandbox Mode: Select YES to enable sandbox mode.
• ShortCode: Enter Shortcode provided by M-Pesa while registration with Safaricom.
• Pass Key: Enter Pass Key provided by M-Pesa while registration with Safaricom.
o Login to Safaricom and move to credentials where you can find both the Lipa Na M-Pesa
Online ShortCode and Lipa Na M-Pesa Online PassKey.

4. Lipa Na M-Pesa Payment for Magento 2 © Meetanshi
• Consumer Key: Enter consumer key provided by M-Pesa while registration with Safaricom.
• Consumer Secret: Enter consumer secret provided by M-Pesa while registration with
Safaricom.
o Login to Safaricom and move to My Apps. Select your app and click on “Keys” tab where
you can find both the consumer key and consumer secret.
• URL for Request Payment: Payment request URL will be pre-filled on extension installation.
• Access Token URL: Access token URL will be pre-filled on extension installation.
• Register URL: Register URL will be pre-filled on extension installation.
• Payment from Applicable Countries: Select countries to allow using this payment method.
• Debug: Select YES to enable debug.
• Instructions: Enter instructions to show along with the payment method in the frontend.
• Sort Order: Enter Sort Order of the payment method display in the frontend.

5. Lipa Na M-Pesa Payment for Magento 2 © Meetanshi

6. Lipa Na M-Pesa Payment for Magento 2 © Meetanshi
3. Lipa Na M-Pesa Payment Method in Frontend
Once the payment method is configured, Lipa Na M-Pesa Payment method is shown on the
checkout page in the frontend while checking out the products. Just select the Lipa Na M-Pesa
Payment method, add M-Pesa mobile number and click “Place Order” to confirm the payment
and place order successfully.

7. Lipa Na M-Pesa Payment for Magento 2 © Meetanshi
• Lipa Na M-Pesa Payment Details in “My Account” section
Once the order is placed, the Lipa Na M-Pesa Payment details are shown in the Account
dashboard, in “My Orders” tab which includes payment method name, merchant request ID,
checkout request ID, and response description.

8. Lipa Na M-Pesa Payment for Magento 2 © Meetanshi
4. Lipa Na M-Pesa Payment Details in Backend
Apart from the frontend, the admin can also view Lipa Na M-Pesa Payment details in the Sales >
Orders > Order View section in the backend. It displays the payment details like payment
method name, merchant request ID, checkout request ID, response description, and lipa
number.