Overview
Back to topMastercard Inc. is the second-largest payment-processing corporation worldwide. It offers a range of payment transaction processing and other related payment services. By connecting individuals, businesses, and organizations in more than 210 countries and territories today, we're unlocking opportunities for more people in more places for generations. Payments through this module are processed securely via the Mastercard Payment Gateway. This ensures that card data is managed in compliance with all legal requirements. The gateway monitors every transaction and handles sensitive payment data on PCI Level 1 certified servers, simplifying PCI compliance for your business.
Compatibility
Extension’s latest version supports GraphQl and is compatible with Magento version 2.4.6
Customer Information Shared with Gateway
This module shares the following customer information with the gateway:
- Customer Billing and Shipping Address
- Customer Name
- Customer Phone Number
- Customer Email Address
- Cart Line Items (optional)
Mastercard Payment Module Features
The Mastercard Payment Module is packed with tools to make payment processing easier and safer for your business. Here's a quick look at its main features:
1. Payment Methods - Defines the types of payment options supported, which are:
- Card payments
Easily and securely accept both credit and debit card payments. This feature works with all major card brands, making it simple and reliable for your customers to pay. - Google Pay (Supported in Hosted Checkout Only)
With Google Pay, customers can quickly and easily pay on the hosted checkout page. To enable this option, ensure your Merchant Identification (MID) is configured for Google Pay. This makes payments smooth and hassle-free, allowing customers to complete transactions with just a few taps. - PayPal (Supported in Hosted Checkout Only)
With PayPal, customers can make payments quickly and effortlessly through the hosted checkout page. To use this option, ensure that your Merchant Identification (MID) is set up for PayPal transactions. Once enabled, this feature provides a seamless and hassle-free payment experience, allowing customers to complete their purchases with just a few simple taps. - Automated Clearing House (ACH)
ACH payments let customers pay directly from their bank accounts through electronic transfers, making bank-to-bank payments easy and fast.
2. Checkout and Payment Integration - These features focus on methods of collecting payment details from customers:
- Hosted Checkout
This feature lets your customers enter their payment details on a readymade secure checkout page provided directly by Mastercard. It keeps sensitive information safe while giving your customers a smooth and hassle-free payment experience. - Hosted Payment Session
This feature lets you customize the layout and design of your payment page to match your brand, while still meeting strict PCI security standards. It makes managing security easier without compromising the user experience.
3. Fraud Prevention and Security - These features enhance security and protect against fraud:
- Address Verification Service (AVS)
AVS helps prevent fraud by checking the billing address provided during a payment to make sure it matches the one on file with the cardholder's bank. This helps confirm that the person making the payment is the actual cardholder. To use AVS, it must be activated on your Merchant Identification (MID). - 3D Secure v1
3D Secure (3DS1) adds an extra step to verify the cardholder during online transactions. This helps prevent unauthorized payments by asking the cardholder to confirm their identity. Before using this feature, make sure it's enabled on your Merchant Identification (MID). - 3D Secure v2
3DS2 in the Mastercard Gateway, is the latest version of the security protocol, designed to enhance security in online purchases while providing frictionless checkouts to payers who are considered low risk by the Access Control Server (ACS). The ACS determines the risk using information provided by the merchant, browser fingerprinting, and previous interactions with the payer. Please note that this needs to be activated on your Merchant Identification (MID) before you can use it. - Tokenization
Tokenization improves security by replacing sensitive card or account details (like your 16-digit Card number or Bank Account Number or Routing Number) with a unique, encrypted token which is created by MPGS and sent to the merchant. This token can be used for future transactions, keeping your card information safe and private. To use Tokenization, it must be activated on your Merchant Identification (MID).
4. Transaction Management - These features support the processing and management of transactions:
- Capture Payments
This feature lets you manually process payments for authorized orders directly from your system. It gives you more control over how payments are handled. - Void Transaction
The void transaction feature lets you cancel an order before it's invoiced or completed. This option is usually available for 'Authorize Only' transactions, where the funds are reserved but not yet charged or billed. - Full Refunds
You can refund the entire amount of the transaction back to the customer's account. This is helpful when a complete order needs to be canceled or returned. - Partial Refunds
This feature lets you refund only part of an order, giving the customer the specific amount they are entitled to.
5. Headless Capabilities - This feature provides headless functionality:
- REST & GraphQL API
The Mastercard Magento Plugin connects with Mastercard's Payment Service APIs to help you process payments smoothly. It also supports Headless Magento integration, which separates the front-end and back-end systems. This allows you to easily customize the user experience, whether you're using React, Angular, or another front-end technology.
The Headless Magento architecture, paired with GraphQL, creates a flexible and responsive user interface. This makes it easier to add new features and payment options as they come up, ensuring that your payment solution stays up-to-date and can grow with your needs.
Documentation
Click here to access the documentation
System Requirements
The latest release of the plugin has the following system requirements:
- PHP version 8.3 or higher is mandatory.
- Magento version 2.4.7 or later is required. However, we strongly recommend using the latest available version for optimal performance.
Installation
Please refer to this guide.
Configuration
Configuration Steps
Please follow these steps to configure the module:
- Login to the Magento Admin dashboard.
- Go to Stores > Configuration > Sales > Payment Methods
- Expand OTHER PAYMENT METHODS, then Mastercard Payment Gateway Services.
- Fill in the configuration details.
- Click Save Config to store the configuration.
- Follow Magento instructions and clean the application cache, to make sure that the new payment method is immediately available in your online store.
Configuration details
Under the Mastercard Payment Gateway Services options group, you can configure the payment options - Hosted Checkout, Hosted Payment Session, and Automated Clearing House (ACH). Each of these options can be configured individually. For detailed instructions on how to set up each option, please refer to the Configuration page in the Wiki.
Disclaimer!
Starting from version 2.4.5, the plugin will collect analytics data, including the plugin download count from GitHub and the active installation count. The Active count, Store Name, Store URL, and the Country configured in the Magento 2 Admin page will be captured once the Test Mode is set as No and the API Username and API Password are saved in the configuration page.
Support
For customer support: https://mpgsfgs.atlassian.net/servicedesk/customer/portals
Technical Specifications
Back to topSeller profile
Seller contact
Current Version
2.4.6
Adobe Commerce platform compatibility
Adobe Commerce (cloud): 2.4 (current)
Adobe Commerce (on-prem): 2.4 (current)
Magento Open Source: 2.4 (current)
Type
Stable Build
Updated
09 April, 2025
Categories
Extensions, Payments & Security, Payment Integration
Quality Report
Back to topAll tests were conducted on the latest versions of Adobe Commerce that existed for the compatible release lines at the moment of the extension submission. Latest versions of all other software were used, as applicable.
Release Notes
Back to top2.4.6:
- Compatible with Adobe Commerce (cloud) : 2.4
- Compatible with Adobe Commerce (on-prem) : 2.4
- Compatible with Magento Open Source : 2.4
- Stability: Stable Build
-
Description:
Introduced a 'Place Order' button to redirect customers to the Gateway payment page.
2.4.5:
- Compatible with Adobe Commerce (cloud) : 2.4
- Compatible with Adobe Commerce (on-prem) : 2.4
- Compatible with Magento Open Source : 2.4
- Stability: Stable Build
-
Description:
- Added PayPal (Supported in Hosted Checkout Only).
- The plugin will capture the download count from GitHub and track active installations, including Store Name, Store URL, and Country, once the Test Mode is set as No and the API Username and API Password are saved.
- Resolved an issue where line items were not correctly displayed in the Redirected Payment Page.
- Minor bug fixes.
2.4.4:
- Compatible with Adobe Commerce (cloud) : 2.4
- Compatible with Adobe Commerce (on-prem) : 2.4
- Compatible with Magento Open Source : 2.4
- Stability: Stable Build
-
Description:
Mastercard API upgraded to version 100.
Added a new "Funding Status" parameter for orders placed through Hosted Checkout and Hosted Session.
Fixed Minor bug fixes.
2.4.3:
- Compatible with Adobe Commerce (cloud) : 2.4
- Compatible with Adobe Commerce (on-prem) : 2.4
- Compatible with Magento Open Source : 2.4
- Stability: Stable Build
-
Description:
Refund added for ACH.
ACH orders will be processed based on webhooks.
2.4.2:
- Compatible with Adobe Commerce (cloud) : 2.4
- Compatible with Adobe Commerce (on-prem) : 2.4
- Compatible with Magento Open Source : 2.4
- Stability: Stable Build
-
Description:
Mastercard API upgraded to version 84.
Introduced Checkout Form Type – Redirect to Payment Page in Hosted Checkout Integration Model.
Void Transaction – status updated to “Canceled”.
Fixed the Pay button amount refresh issue in Hosted Checkout.
2.3.6:
- Compatible with Adobe Commerce (cloud) : 2.4
- Compatible with Adobe Commerce (on-prem) : 2.4
- Compatible with Magento Open Source : 2.4
- Stability: Stable Build
-
Description:
Mastercard API version upgraded to 81.
Module is now compatible with Magento version 2.4.6 p6.
Implemented a notification feature to alert the admin whenever a new version is launched on GitHub/Marketplace.
Hosted Session – The VATO option will only be supported when 3DS is disabled.
ACH will not support the VATO payment option as it does not allow capturing the amount.
2.3.5:
- Compatible with Adobe Commerce (cloud) : 2.4
- Compatible with Adobe Commerce (on-prem) : 2.4
- Compatible with Magento Open Source : 2.4
- Stability: Stable Build
-
Description:
Mastercard API version upgraded to 73
Module is now compatible with Magento version 2.4.6 and higher
Added compatibility with PHP 8
Hosted checkout form visibility changed to embedded form rather than lightbox
Enhanced GraphQL Support
Minor bug fixes
2.3.1:
- Compatible with Adobe Commerce (cloud) : 2.4
- Compatible with Adobe Commerce (on-prem) : 2.4
- Compatible with Magento Open Source : 2.4
- Stability: Stable Build
-
Description:
Added compatibility with PHP 8.
The module is now compatible with Magento version 2.4.4 and higher.
Support
Back to topThe best place to start if you need help with a specific extension is to contact the developer. All Adobe Commerce developers have both a contact email and a support email listed.
Contact Vendor