Payment Gateway with MPGS for WooCommerce

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

1. Payment Page – Customer is redirected to the MPGS payment page (all API versions)
2. 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:

1. At checkout – Creates a payment session with order amount, currency, description, customer name/email, and return URL.
2. 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 Pacific
• https://eu-gateway.mastercard.com/ – Europe
• https://na-gateway.mastercard.com/ – North America
• https://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.

1. Go to Plugins > Add New in WordPress admin
2. Search for “Payment Gateway with MPGS for WooCommerce”
3. Click Install Now then Activate
4. Go to WooCommerce > Settings > Payments > MPGS
5. 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
6. Enable Test Mode to verify your setup, then disable it when ready to go live

1. 

   WooCommerce Payments page with MPGS gateway enabled

2. 

   MPGS gateway settings page with all configuration options including test mode, debug logging, API credentials, and checkout interaction type

3. 

   WooCommerce checkout page with Credit Card payment method selected

4. 

   MPGS Hosted Checkout secure payment form with order summary

5. 

   Completed order details with MPGS transaction receipt and order notes

2.1.0 – 2026-04-30

• Added refund and void support from WooCommerce admin
• Full refund uses VOID (DELETE) operation; partial uses REFUND (PUT)
• Validates refund amount, transaction ID presence, and order total ceiling
• Logs all refund attempts and MPGS responses to WooCommerce debug log
• Adds order note on success (receipt + amount) and failure (error code)

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