Magento 2 Digicel MonCash Payments

Magento 2 Digicel MonCash Payments extension integrates Magento 2 store with Digicel's MonCash payment gateway to accept secure mobile money payments from the customers.

 

Table of Content

1. Extension Installation
2. Configuration
3. Digicel MonCash Payment Method in Frontend
4. Digicel MonCash Payment Details in Backend

 

1. Extension Installation
   • For Magento Marketplace Customers
     • Create a folder structure in Magento root as app/code/Meetanshi/Moncash
     • Download and extract the zip folder and upload our extension files to the app/code/Meetanshi/Moncash via FTP.
     • 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
    • Extract the zip folder and upload our extension to the root of your Magento 2 directory via FTP.
    • 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

 

2. Configuration
   To configure the extension, login to Magento 2, move to Sales à Payment Methods à Digicel MonCash Payments - Meetanshi where you can find various settings to enable the extension.

• Enabled: Set “YES” to enable the Digicel MonCash Payments extension.
• Title: Set the title for the payment method to be displayed in the frontend.
• Show MonCash Logo: Set YES to show MonCash logo along with the payment method in the frontend.
• Sandbox Mode: Select YES to enable sandbox mode.
• Client ID: Enter client ID copied from your payment gateway settings.
• Client Secret: Enter client secret copied from your payment gateway settings.

Note: In order to integrate MonCash, you first need to perform a test in the sandbox environment. 

• • To get the Client ID and Client Secret, create an account on https://sandbox.moncashbutton.digicelgroup.com/Moncash-business/New, confirm your Email, login to your account, move to the “General Info” tab and click “New” to add a business.

 

• • Add your business details, website, return and alert URLs.
    • Website URL: https://yoursite.com
    • Return URL: https://yoursite.com/moncash/payment/success
    • Alert URL: https://yoursite.com/moncash/payment/success
       

 

• • After saving the details, click to view the business details.

 

• • On click of view button, you can view rest API details having client ID and client secret. Copy both and paste in the extension configuration under the respective fields.

 

Note: Once the testing is completed, please contact MonCash business team via email at MFS_B.Services@digicelgroup.com in order to move to production/live.

• Auto Invoice: Select YES to automate invoice generation for the orders paid using the Digicel MonCash payment method.
• Payment from Applicable Countries: Select countries to allow using this payment method.
• Additional Information: Enter the additional information to show on frontend along with the payment method.
• Sort Order: Enter Sort Order of the payment method display in the frontend.

 

 

3. MonCash Payment Method in Frontend
   Once the payment method is configured, whenever the customers add the products to cart and move to the checkout page, Digicel MonCash payment method is shown. They just select the payment method, click “Continue to Payment” to get redirected to the hosted payment page, add the payment details and complete the payment.

 

• Redirection to the MonCash Hosted Payment Page
  Once the customers get redirected to the Digicel MonCash hosted payment page, they add Digicel mobile number and pin, and click the “Pay” button.

 

• Immediately after adding the phone number and pin, the customers get OTP on the same number to confirm the payment and pay for the order.

 

• After the successful payment, customers can see payment success message along with the transaction ID. On click of the “Ok” button, they get redirected back to the merchant website.

 

• MonCash Payment Details in Customer’s My Account Section
  After the successful payment, customers can see the MonCash payment details in their My Account section.

 

4. Digicel MonCash Payment Details in Backend
   Apart from the customers, the admin can also see the payment details for the orders in the backend. Go to Sales à Orders à Order View to see the MonCash payment details along with the transaction ID.