Deskripzioa

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)

Pro Version

Everything above stays free, forever. MPGS Pro adds payment operations tooling on top:

Transaction Log Viewer – Every gateway event in your dashboard (WooCommerce > MPGS Logs). No FTP, no raw log files.
Card Surcharge – Pass processing fees to the customer. Fixed or percentage, with per-country rates.
Authorize & Capture – Hold funds at checkout, capture the full or a partial amount from the order screen when you ship.
Branded Checkout – Your logo, website, and contact details on the MPGS payment page.
Payment Alerts – Instant email or webhook notifications for successful, failed, and refunded payments.

Upgrade from the plugin’s Upgrade link on the Plugins page. Learn more on the plugin page.

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 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.

Pantaila-argazkiak

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 Payments page with MPGS gateway enabled

Instalazioa

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
Enable Test Mode to verify your setup, then disable it when ready to go live

MEG

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?

Yes, since version 2.1.0. Refund directly from the WooCommerce order screen – a full refund voids the transaction, a partial amount issues an MPGS refund.

What is the difference between free and Pro?

The free version is a complete, fully functional MPGS gateway – secure hosted checkout, 3DS, refunds, test mode, debug logging. Pro adds operational tools: an in-admin transaction log viewer, card surcharges, authorize/capture (hold funds now, capture on fulfillment), branded checkout, and payment alerts.

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.

Berrikuspenak

faisal95bd 2026(e)ko ekainaren 9(a) 1 reply

Works perfectly

farhannaseem 2026(e)ko ekainaren 4(a) 2 replies

Very kind and supportive team. I had an issue with payment page redirecting. I addressed them about it and they resolved in an hour.

Irakurri 2 berrikuspenak

Laguntzaileak eta Garatzaileak

“Payment Gateway with MPGS for WooCommerce” software librea da. Ondoko pertsonek egin dizkiote ekarpenak plugin honi.

Itzul zaitez Payment Gateway with MPGS for WooCommerce zure hizkuntzara.

Garapena interesatzen zaizu?

Araka kodea, begiratu SVN biltegia edo harpidetu garapen erregistrora RSS bidez.

Aldaketen loga

3.1.1 – 2026-07-11

New: dismissible admin notice announcing the optional Pro version to free users
Improved: redesigned the Pro section on the Getting Started page for clearer, more scannable features
Fixed: “See Pro Features” now links straight to the Pro features section

3.1.0 – 2026-07-04

Pro: Branded Checkout – show your logo, website, contact details, and address on the MPGS Hosted Checkout payment page
Pro: Payment Alerts – instant email or JSON webhook notifications for successful, failed, and refunded payments

3.0.1 – 2026-07-04

The update opt-in notice now also announces the new optional Pro features
Added a Pro section teaser on the gateway settings page (free plan only)
Plugin deletion now removes all stored options, so a reinstall starts fresh

3.0.0 – 2026-07-04

Introduced optional Pro version (via Freemius). The free plugin is unchanged: same secure hosted checkout, refunds, and settings – no features removed, no account required.
Added a Getting Started page (features, setup steps, quick links) shown once after first activation and reachable from the Plugins row
Added a dismissible review reminder with Remind Me Later / Don’t Show Again controls
Pro: Transaction Log Viewer – rolling in-admin log of gateway events at WooCommerce > MPGS Logs
Pro: Card Surcharge – fixed or percentage fee when paying by card, with per-country overrides
Pro: Authorize & Capture – authorize at checkout, capture full or partial amounts from the order screen
Added Freemius SDK for licensing and optional usage opt-in (no data is collected without explicit consent)
Developer: new action hooks mpgs_payment_success, mpgs_payment_failed, mpgs_refund_processed, mpgs_log_entry; new filters mpgs_credentials_for_currency, mpgs_payment_action

2.2.0 – 2026-06-25

Added an MPGS Transaction Details meta box on the order edit screen (receipt, transaction ID, card brand, last 4, type, gateway response, API version)
Added a “View in MPGS Portal” link built from the configured service host and merchant ID
Customers now see human-readable decline messages mapped from MPGS gateway codes (e.g. insufficient funds, expired card) instead of raw status strings
Logs the full MPGS API error response body to the WooCommerce debug log for support troubleshooting
Added config-mistake hints to the debug log (missing trailing slash on MPGS URL; HTTP 401/403 auth failures)

2.1.1 – 2026-06-02

Added WooCommerce Cart/Checkout Blocks support; gateway now appears on block-based checkout
Declared cart_checkout_blocks compatibility
No change to payment processing — block checkout reuses the existing hosted-checkout redirect flow

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

Excellent

Woocommerce MPGS