Mastercard Payment Gateway Services (MPGS) - Magento 2
Compatible With Magento Edition
Open Source (CE): 2.3, 2.4Commerce on prem (EE): 2.3, 2.4
Commerce on Cloud (ECE): 2.3, 2.4
Overview
Mastercard Payment Gateway Services (MPGS) - Magento 2 extension adds a seamless payment method to your Magento store, allowing you to securely accept credit and debit card payments while minimizing PCI exposure. This extension enables direct payment and hosted checkout options, providing flexibility for merchants and a secure shopping experience for customers. Merchants will need an active Mastercard Payment Gateway Services account to use the extension.
This extension is also compatible with numerous local and international payment gateways, including:
- Adcb Payment Gateway
- AFS Payment Gateway (Arab Financial Services)
- Areeba Payment Gateway
- Axis Bank Payment Gateway
- Bank Alfalah Payment Gateway
- Bank Audi Payment Gateway
- Abu Dhabi Islamic Bank Payment Gateway
- Bank Of Beirut Payments
- Banque Libano-Française
- Bendigo Bank Payment Gateway
- Burgan Bank Kuwait
- Commercial Bank of Ceylon PLC
- Commercial Bank Of Kuwait
- CrediMax Payment Gateway
- HSBC Bank Payment Gateway
- Kuwait Finance House
- Global Payments MPGS
- Mashreq Bank payment Gateway
- Mauritius Commercial Bank (MCB)
- MCB eGate (Pakistan)
- National Bank Of Egypt (NBE)
- National Bank of Oman Payment Gateway (NBO)
- Network Online Payment Gateway
- NBK Payment Gateway (National Bank of Kuwait)
- Suncorp Gateway
- Banque Saudi Fransi (البنك السعودي الفرنسي)
- Doha Bank Payment Gateway
- etc
Key Benefits
Global Payment Acceptance
-
Mastercard Payment Gateway Services (MPGS) supports credit and debit card payments from global merchants, accepting cards from all major card networks like Mastercard, Visa, and local payment gateways.
-
Works with local banks across various regions, ensuring seamless payment processing.
Enhanced Security with 3D Secure
-
3D Secure V1 & V2 (EMV 3D Secure) are supported only with the Hosted Checkout option, adding an extra layer of security for online transactions.
-
Encrypted payment credentials and SSL certificates ensure sensitive customer data is protected during transactions.
Flexible Payment Options for Customers
-
Direct Payment: Customers can securely enter their payment details directly on your website.
-
Hosted Checkout: Customers are redirected to the Mastercard Payment Gateway for a secure payment process and returned to your website once the transaction is successful.
Seamless Integration with Magento 2
-
Easily integrates with Magento 2, providing a smooth and secure payment experience for customers during checkout.
-
Support for multiple store views and multiple websites, ideal for businesses with diverse online platforms.
Scalable Solution for Global Merchants
-
Supports multiple currencies, allowing you to accept payments from customers worldwide, regardless of their location or preferred currency.
-
Unlimited domain support allows you to scale your business across various platforms with one license.
Key Features
Comprehensive Payment Gateway Support
-
Supports all major banks and payment processors worldwide, including HSBC, Kuwait Finance House, Mashreq Bank, and more, making it ideal for global merchants.
-
Compatible with a wide range of local and international payment gateways, allowing flexible payment solutions.
3D Secure Authentication
-
3D Secure V1 & V2 (EMV 3D Secure) are fully supported for Hosted Checkout, providing enhanced fraud protection and secure online payments.
-
Real-time 3D Secure authentication helps reduce chargebacks and ensures safe transactions.
Multiple Payment Methods
-
Direct Payment: Customers can enter their payment details directly on your site, creating a smooth checkout process.
-
Hosted Checkout: Redirects customers to a secure payment page hosted by the Mastercard Payment Gateway, then returns them to your site after payment completion.
Transaction and Payment Management
-
Automatically capture new sales and authorize payments directly on your Magento store.
-
Refund Online feature enables merchants to issue refunds directly from the backend of the store.
Invoice Generation and Webhook Notifications
-
Automatically generates invoices for successful transactions, improving your store’s operational efficiency.
-
Webhook notifications inform you of any failures or delays in transaction processing, ensuring accurate tracking and updates.
Multi-Store and Multi-Currency Support
-
Supports multiple websites and multiple store views, enabling you to manage payments for different markets and products.
-
Multiple currency support allows merchants to cater to international customers and offer global payment solutions.
Unlimited Domain and Website Support
-
Unlimited domains are supported with just a single license, providing flexibility for businesses with multiple online stores or platforms.
Support, Updates & Licensing
- The extension includes 12 months of free technical support. If you encounter any issues related to installation, configuration, or compatibility, our support team will assist you to ensure the extension works correctly with your Magento 2 store.
- The extension also includes free updates for 12 months, ensuring compatibility with new Magento 2 versions and ongoing improvements.
- The source code is 100% open-source and unencrypted, allowing developers to review, customize, and extend the functionality as needed.
- A single license can be used on unlimited domains and websites.
- All extensions are covered by a 30-day money-back guarantee.
Installation
Follow the steps below to install the Mastercard Payment Gateway Services (MPGS) extension on your Magento 2 store.
1. Extract the extension files into the following directory:
app/code/PL/Mpgs/
2. Open a terminal and navigate to your Magento root directory, then run the following commands:
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy -f
php bin/magento cache:clean
After completing these steps, the extension will be available in the Magento Admin Panel for configuration.
How to configure the payment module using Mastercard Payment Gateway Services (MPGS)
Test Environment
If you would like to see how the Mastercard Payment Gateway Services (MPGS) works with Magento 2, please contact our team to request a demo or access the test environment.
Email: sales@polacin.com
The following test credit card numbers can be used in the test environment for development and testing purposes only.
Standard Test Data – All Supported Regions
Mastercard: 5123450000000008 Expiry Date: 01 / 39 3-D Secure Enrolled: Y
Mastercard: 2223000000000007 Expiry Date: 01 / 39 Secure Enrolled: Y
Mastercard: 5111111111111118 Expiry Date: 01 / 39 Secure Enrolled: N
Mastercard: 2223000000000023 Expiry Date: 01 / 39 Secure Enrolled: N
Visa: 4508750015741019 Expiry Date: 01 / 39 3-D Secure Enrolled: Y
Visa: 4012000033330026 Expiry Date: 01 / 39 3-D Secure Enrolled: N
Release Notes
Version 2.3.3 – August 3, 2025
-
Compatible with API version 100 (latest)
Version 2.3.2 – October 2, 2024
-
Fixed prefix order issue
-
Added Test Mode option
-
Compatible with API version 84 or later
Version 2.3.1 – August 31, 2024
-
Fixed payment gateway URL issue
Version 2.3.0 – June 3, 2024
-
Compatible with API version 80 or later
-
Added customer details (firstname, lastname, email, phone) to payment request for EMV 3D Secure requirements
Version 2.2.4 – January 3, 2024
-
Fixed maximum character limits for address fields
-
Fixed issues with valid Arabic characters in the address fields being submitted
Version 2.2.3 – October 12, 2023
-
Added CSP whitelist
-
Compatible with API version 75
Version 2.2.2 – May 25, 2023
-
Added price format for Omani Rial (OMR) and National Bank of Oman Payment Gateway
-
Show error code and error description if payment credentials are incorrect
Version 2.2.1 – February 8, 2023
-
Updated API version to 69
Version 2.2.0 – January 10, 2023
-
Added Webhook notifications for better transaction tracking
Version 2.1.1 – August 12, 2022
-
Compatible with API version 63 or later
Version 2.1.0 – July 12, 2022
-
Added notification when a new version is available
-
Show error message if payment configuration is incorrect
-
General stability improvements
Version 2.0.8 – September 9, 2021
-
Added parameters for Direct Payment integration
Version 2.0.7 – May 29, 2021
-
Added Authorize and Refund Online for both Direct Payment and Hosted Checkout
-
Stability improvements
Version 2.0.6 – November 12, 2020
-
Compatible with API version 56 or later
Version 2.0.5 – April 17, 2020
-
Stability improvements
-
Fixed bugs for Hosted Checkout with Magento 2.3.4
Version 2.0.4 – April 19, 2019
-
Stability improvements
-
Encrypted API Password for better security
Version 2.0.3 – February 20, 2019
-
Fixed Offline Refund issue for Hosted Checkout Payment
Version 2.0.2 – October 22, 2018
-
Bug fixes and stability improvements
-
Added order.reference
-
Fixed Total Due issue
Version 2.0.1 – March 20, 2017
-
Stable version release
FAQ
Our client is from Kuwait, so he wants surety that this will work for Kuwait and Kuwait currency as well. Is your extension compatible with the NBK payment gateway?
Is MPGS extension compatible with the Taiwanese MasterCard API endpoint?
I want to implement the Bank Alfalah payment method and just want to confirm is it safe and is it easily configurable based on the Bank Alfalah provided credentials like merchant id, operator id, password, endpoint?
Customers
Many websites trust our Mastercard Payment Gateway Services (MPGS) extension for secure and seamless payment processing. Here are just a few of our valued customers:
- 12345.ae
- alfuhod.com
- buynespresso.com
- esajee.com
- hsbookstore.com
- generation.com.pk
- egygamer.com
- sidrack.com
- wantitbuyit.com
- yarlolai.com
- humaadnan.com
- fhsofficial.com
- overclockers.ae
- priceguru.mu
- mr-bricolage.fr
- niahome.ae
- blackrabbit.com.au
- thepbcos.com
- shareefcorner.sa
- hmpresent.net
- shophive.com
- tatayab.com
- ahmarket.com
- etc.
Reviews
- Worked with Polacin since 2019 in my…Worked with Polacin since 2019 in my magento store where I have an MPGS gateway.
They helped me in the setup and troubleshooting to get started.
Also great with upgrades to latest API as per bank requirements when I need it.
I am confident in their expertise and recommend them.Posted on
- Excellent PluginPerfection at its best. Working smooth with Mashreq Bank Dubai
Posted on
- Good MPGS integrationGood job for the MPGS payment integration with Magento 2. It ensures secure payments in my website, the 3D secure also works
Posted on
- Great plugin and supportNo problems so far, charges credit cards via the payment gateway.
Support is responsive and helps without issuesPosted on
- Incredibly helpfulPolacin MPGS extension works seamlessly on my website, providing customers with a hassle-free purchasing experience. It's been incredibly helpful.
Posted on
- Great overall experienceI'm using this plugin for our store since from 2018 and so far i don't face any issues. I highly recommend this plugin to anyone who is looking to allow payment via master/visa cards.
Posted on
- 5 Star extensionThank you for updating this payment extension. No issues so far after 2 months in use, i have enabled payer authentication and it's working well
Posted on
- Customer support is fantasticCustomer support is fantastic! I had some questions about getting it set up correctly and they provided fantastic, quick replies to each one of my questions! Also, the extension functioned exactly how I needed it to. Highly recommended!!
Posted on
- Worth purchasing itThanks the team for installing this module and helping me to configure the payment credentials. It's working perfectly for my website as well as 3DS2. Highly recommended!
Posted on
- Polacin extension 5 starsOur team has tested the changes that you have made on the site and everything seems to be working well with 3d secure v2.
Thank you for providing us with the support.Posted on
- Excellent Support on Upgrade of Payment…Excellent Support on Upgrade of Payment Gateway Extension for 3ds2 ( pls note that 3ds1 will be permanently deactivated by Master card by October 2022)
Posted on
- Excellent extension for MCB merchant accountThis extension works very well on my website. Ran into a few minor glitches after the installation but the support has been great and I have received prompt responses every single time.
Posted on
- Great support and serviceI faced a small glitch but still give you five stars because you gave me quick fix. It's working perfectly now. Thank you so much for customizing the module
Posted on
- Very Responsive SupportVery responsive support. They save my day. This Extension is exactly what i need.
Good Work Guys!
Thanks.Posted on
- Worked out of the boxThe Hosted Checkout integration worked out of the box as expected with onestepcheckout. This was just what we were looking for and performs perfectly, that's great.
ThanksPosted on
- Great moduleThis module was exactly what I was looking for and I have good experience buying module from Polacin. Just get one year for the Support/Updates Period. Keep up the good work.
Posted on
- Great SupportI'm rating 5* for your plugin and support. It's working perfectly :)
Thanks for your great support again. I really appreciate your help.Posted on
- Amazing workThanks Linh for your kind support, i'm enabling the Hosted Checkout method now, it's working perfectly on my website.I trust your work.
Posted on
- Superior quality and supportThe Hosted Checkout Payment integration with Mastercard Payment Gateway Services absolutely meets our expectations. There was a request to contact support and our ticket has been quickly resolved. That's great.
Posted on
- work like a charmI have got the updated extension and it is working like a charm.Thanks a lot for the great support
Posted on
- I appreciate you working on thisI will try a transaction and making site go live tomorrow but from what it looks like it works. Thanks for your help and hopefully
Posted on
- Extremely valuable extensionThis extension had a few minor issues when I first installed it. Very minor! Working with Polacin support, they were quickly resolved and are working as advertised.
Good work Polacin keep it up :)Posted on
- Great assistanceI contacted the developer to help work around the Composer issue before my hosting company changed their restriction and received great assistance and fast responses. The extension works perfectly, i am very satisfied.
Posted on
- Exceptional customer service!You are an angel!!! Thank you!!!
Posted on
- Works perfectly with Combank MPGS Payment gatewayThank you Polacin for providing me awesome plugin, it's working perfectly with my bank payment gateway. Giving you five starts for this plugin because it's so amazing and saving my business time
Posted on
- Excellent Extension & ServiceLinh Support is awesome, He did everything in 1-2 days time with quick responses and its perfectly integrated without any bugs on our website, Surely recommended for every website providing mastercard pg service
Posted on
- good solutionI want to make a review for this plugin because Linh (Polacin Support) was enthusiasm and replied quickly. He helped me to install and configured payment details. The payment plugin is useful, thank you for providing me a good solution.
Posted on
- working perfectlyThank you for your payment solution, it saved my time and was useful in my business. Importantly it's working perfectly with my website
I make sure that will recommend my partners to use this extension when i know they are having MPGS merchant.Posted on
- Great extensionThis MPGS extension has been working great with my stores. Everything is satisfying, from the extension functions and its quality to the developer support. Thanks a lot
Posted on
- Excellent!!!I don’t usually leave reviews but I must say the support was very helpful in assisting us with some questions which I’m sure were very basic.. still learning this stuff! Your MPGS payment module is Excellent!!!
Posted on
- Great support great pluginI had a few questions because I didn’t know how to install and configure the plugin. The team support connected to me through skype, that was helpful... it's a good payment gateway integration. Thanks for your support.
Posted on
- Great overall experienceIt's always a pleasure working with Polacin as a great extensions provider. They always keep up with the times and MPGS extension is an excellent example of a high-quality payment method with useful features.
Posted on
- awesome extensionThis extension works awesome. There customer support is also hands down one of the best. I had a conflict with another plugin and they were on top of it helping me fix my issues. Thanks guys! Highly recommended.
Posted on
- Awesome PluginNow i'm still using MPGS - Direct Payment integration without any issues, also working great with AUD I'm very satisfied. Thanks a bunch
Posted on
- ExcellentI contacted the support guys and I got instant response and help, this extension it's really good and the Polacin team as well.
Posted on
- FABULOUS supportFABULOUS support! i got an issue related to magneto 2 extension installation, the team already helped me to do that. Now it's working great for my test site. will go live soon. Thanks for your help
Posted on
- Excellent Service and PluginI have to commend the service you get from Polacin. They always reply to emails straight away.
The plugin is amazing, it works.Posted on
- Excellent moduleGreat module from a team that really supports its extension with technical support should there be any issues. I highly recommend this product to anyone looking to allow payment processing within their web site.
Posted on
- Excellent support - great moduleWorks out of the box with very little set up. I just put the credentials in configuration section. Polacin support is very helpful
Posted on











