Опис
Accept credit and debit card payments on your WooCommerce store using MasterCard Payment Gateway Services (MPGS) Hosted Checkout.
All card data is handled by MPGS servers directly. No sensitive payment information touches your server, keeping you PCI compliant.
Features
- Test Mode – Switch between test and live credentials safely
- Debug Logging – Built-in WooCommerce logger for troubleshooting
- Transaction Details – Saves transaction ID, receipt, card type, and last 4 digits with each order
- HPOS Compatible – Works with WooCommerce High-Performance Order Storage
- Multiple API Versions – Supports MPGS API versions 49, 52, 55, 62, 63, and 66
- 3DS Authentication – Supports both 3DS1 and 3DS2
- Translation Ready – French translation included
Checkout Modes
- Payment Page – Customer is redirected to the MPGS payment page (all API versions)
- Lightbox – Payment form opens as a popup on your site (API v49-62 only)
Credits
Maintained by Salman Patnee. Originally created by Ali Basheer (v1.0.0-1.5.1).
External Services
This plugin connects to MasterCard Payment Gateway Services (MPGS) to process payments.
- Provider: MasterCard International Incorporated – mastercard.com
- Terms of Use: mastercard.com/terms-of-use
- Privacy Policy: mastercard.com/privacy
When and what data is sent
The plugin calls MPGS servers twice per transaction:
- At checkout – Creates a payment session with order amount, currency, description, customer name/email, and return URL.
- After payment – Verifies the transaction result using the order ID.
Merchant credentials are sent server-side only and never exposed to the browser. Card numbers, CVV, and expiry dates are never sent through this plugin – customers enter these directly on MPGS-hosted pages.
Gateway domains
https://ap-gateway.mastercard.com/– Asia Pacifichttps://eu-gateway.mastercard.com/– Europehttps://na-gateway.mastercard.com/– North Americahttps://mtf.gateway.mastercard.com/– Test/Sandbox
Your bank will tell you which domain to use.
Privacy
This plugin does not track users, store card data, use tracking cookies, or share data with anyone other than MPGS for payment processing.
Скріншоти

WooCommerce Payments page with MPGS gateway enabled 
MPGS gateway settings page with all configuration options including test mode, debug logging, API credentials, and checkout interaction type 
WooCommerce checkout page with Credit Card payment method selected 
MPGS Hosted Checkout secure payment form with order summary 
Completed order details with MPGS transaction receipt and order notes
Встановлення
- Go to Plugins > Add New in WordPress admin
- Search for “Payment Gateway with MPGS for WooCommerce”
- Click Install Now then Activate
- Go to WooCommerce > Settings > Payments > MPGS
- Enter your credentials:
- MPGS URL – Gateway URL from your bank (must end with
/) - API Version – Version 66 recommended
- Merchant ID – From your bank
- Authentication Password – Generate in MPGS admin portal under Admin > Integration Settings
- MPGS URL – Gateway URL from your bank (must end with
- Enable Test Mode to verify your setup, then disable it when ready to go live
Часті питання
-
How do I get MPGS credentials?
-
Contact your acquiring bank to set up an MPGS merchant account. They will provide your Merchant ID, gateway URL, and access to the MPGS admin portal where you generate the Authentication Password.
-
Why are my transactions failing?
-
Common causes:
- Currency mismatch between MPGS account and WooCommerce store
- MPGS URL missing the trailing slash
- Wrong Merchant ID or Authentication Password
- API version not supported by your account
Enable Debug Log in the gateway settings and check logs at WooCommerce > Status > Logs for details.
-
Does this plugin store credit card data?
-
No. Customers enter card details on MPGS-hosted pages. No card data ever reaches your server.
-
Can I use Lightbox mode?
-
Only with API versions 49-62. API version 63 and above require Payment Page (redirect) mode.
-
Does this plugin support refunds?
-
Not yet through WooCommerce. You can process refunds in your MPGS merchant portal. Refund support is planned for a future release.
-
Is this plugin HPOS compatible?
-
Yes. Version 2.0.0 supports WooCommerce High-Performance Order Storage.
-
Where do I find transaction details?
-
Open any order paid via MPGS. The Order Notes section shows the transaction receipt, transaction ID, gateway response code, and card details.
Відгуки
Для цього плагіна немає відгуків.
Учасники та розробники
“Payment Gateway with MPGS for WooCommerce” — проект з відкритим вихідним кодом. В розвиток плагіну внесли свій вклад наступні учасники:
УчасникиПерекладіть “Payment Gateway with MPGS for WooCommerce” на вашу мову.
Цікавитесь розробкою?
Перегляньте код, перегляньте сховище SVN або підпишіться на журнал розробки за допомогою RSS.
Журнал змін
2.0.0 – 2025-12-18
Major release – complete rewrite.
- Added test mode toggle for safe testing
- Added debug logging with WooCommerce logger
- Added transaction metadata storage (ID, receipt, card details, response codes)
- Added nonce verification, input sanitization, and output escaping
- Added HPOS compatibility
- Added PHP 8.2+ compatibility
- Fixed sprintf() bug causing null order descriptions
- Fixed deprecated utf8_decode() warnings on PHP 8.2+
- Renamed plugin for WordPress.org compliance
- Minimum requirements raised to WordPress 5.0, WooCommerce 4.0, PHP 7.2
1.5.1 – 2021-12-15
- Fix MSO error
1.5.0 – 2021-08-20
- Support API version 66
- Support 3DS1 and 3DS2 authentication
1.4.0 – 2020-12-10
- Added filter for session request customization
- Added transaction reference for special MID setups
1.3.0 – 2020-06-15
- Support API version 55
- Allow admin orders without customer info
- Translation support
1.2.0 – 2019-11-20
- Fix American Express JSON response handling
- Allow admin-created orders
1.1.0 – 2019-08-10
- Multisite support
- Fix redirection after payment
1.0.1 – 2019-06-05
- Option to edit payment icon
1.0.0 – 2019-05-01
- Initial release
