WP Manifestindependent plugin directory
manifest / ecommerce / wc-recurring-mpgs

WC Recurring MPGS

WC Recurring MPGS (MasterCard Payment Gateway Services for WooCommerce) with hosted checkout and recurring payments foundation.

by Tarek Nabil · github.com/tareknabil/wc-recurring-mpgs · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/tareknabil/wc-recurring-mpgs/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/tareknabil/wc-recurring-mpgs ↗

WooCommerce payment gateway integration for MPGS hosted checkout.

Current Features

  • Hosted checkout session creation via MPGS API.
  • Redirect payment flow to MPGS hosted payment page.
  • Secure callback handling using:
    • callback nonce validation,
    • order key validation,
    • payment method validation,
    • server-side order verification (Retrieve Order API).
  • Payment finalization with order updates:
    • successful payment completion,
    • failed verification handling,
    • transaction/result metadata persistence.
  • Refund support from WooCommerce admin:
    • full refund as VOID request,
    • partial refund as REFUND request,
    • provider response validation and order notes.
  • WooCommerce Blocks checkout integration.
  • Classic WooCommerce checkout/pay-for-order integration.
  • Optional debug logging to WooCommerce logs.

Requirements

  • WordPress 6.0+
  • WooCommerce 8.0+
  • PHP 7.4+

Configuration

Configure the gateway in:

  • WooCommerce -> Settings -> Payments -> WC Recurring MPGS

Required settings:

  • Service Host (base gateway URL, for example https://epayment.areeba.com/)
  • Merchant ID
  • API Password
  • Checkout API Version

Optional settings:

  • Merchant Name
  • Merchant Address Line 1
  • Merchant Address Line 2
  • Debug Log

Implemented Payment Flow

  1. Customer places order with WC Recurring MPGS.
  2. Plugin creates an MPGS checkout session.
  3. Customer is redirected to hosted checkout.
  4. MPGS returns to plugin callback URL.
  5. Plugin verifies the order state from MPGS and updates order status.

Testing

Current automated test setup includes:

  • Unit tests for API client behavior.
  • Unit tests for hosted checkout payload construction.
  • Integration tests for gateway payment/callback/refund behavior.

Run tests:

  • npm run test:unit
  • npm run test:integration
  • npm run test:all