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.

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.

Скріншоти

  • 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

Встановлення

  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

Часті питання

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:

  1. Currency mismatch between MPGS account and WooCommerce store
  2. MPGS URL missing the trailing slash
  3. Wrong Merchant ID or Authentication Password
  4. 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