Magento 2 M-Pesa Payment

Lipa Na M-Pesa Payment for Magento 2 User Guide

Table of Content 1.

2.

3.

4.

Extension Installation Configuration Lipa Na M-Pesa Payment Method in Frontend Lipa Na M-Pesa Payment Details in Backend

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

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.

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.

Lipa Na M-Pesa Payment for Magento 2

© Meetanshi

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.

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.

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.

Lipa Na M-Pesa Payment for Magento 2

© Meetanshi