Knowledgebase

Overview

This guide explains how to install the Snowtech MPGS (Mastercard Gateway / Suncorp) payment gateway module into WHMCS.

Requirements

• WHMCS 8.x or newer
• PHP 8.1+ (PHP 8.2+ recommended)
• cURL enabled
• ionCube Loader (only required if you are using an encoded build)
• MPGS merchant credentials from your bank:
  • Merchant ID
  • API Password
  • Gateway Hostname (e.g. suncorp.gateway.mastercard.com)
  • API Version (commonly 100)

Step 1 – Upload the Module Files

Upload the gateway file to your WHMCS installation:

/modules/gateways/mpgs.php

If supplied with your build, also upload the callback file and licensing helper:

/modules/gateways/callback/mpgs.php
/modules/gateways/mpgs/licensing.php

Recommended permissions: 0644 for files (readable by the web server).

Step 2 – Activate the Gateway in WHMCS

1. Log in to WHMCS Admin
2. Go to System Settings → Payments → Payment Gateways
3. Open the All Payment Gateways tab
4. Find MPGS (Mastercard Gateway) and click Activate

Step 3 – Save Configuration

Enter your MPGS configuration values (see the Configuration guide), then click Save Changes.

Step 4 – Confirm Currency Support

Ensure MPGS is enabled for the currencies you accept under:

System Settings → Payments → Payment Gateways → Manage Existing Gateways

Next Steps

• How to Configure the MPGS Gateway
• Testing MPGS (Sandbox / Debug Logging)
• Going Live + Cron / Recurring Billing Notes