Skip to content

Requirements

Verify your server and PayGlocal account prerequisites before installing the gateway. Most requirements match standard WHMCS environments, alongside the PayGlocal credentials.

Server and software

RequirementDetails
PHP8.2 or newer (runs on 8.2, 8.3, 8.4 and 8.5)
WHMCS8.13 or newer, or 9.x
ionCube Loader13.0.2 or newer (see below)
PHP extensionscurl, openssl
SSL certificateRequired for the payment callback endpoint
WHMCS daily cronRequired for recurring billing (auto-charging invoices via Standing Instructions)
PayGlocal merchant accountA PayGlocal Merchant ID (MID)
RSA keysMerchant private + PayGlocal public .pem keys, each with a Key ID (KID)
LicenseAn active PayGlocal license

Terms you'll meet

A KID is the Key ID that identifies one of your RSA keys in PayGlocal's dashboard.

The ionCube Loader

PayGlocal requires the standard ionCube Loader PHP extension used by WHMCS.

  • Minimum version: ionCube Loader 13.0.2 or newer.
  • PHP compatibility: PHP 8.2 uses loader 13.0.2; PHP 8.3 uses 14.4.0; 15.x loaders are supported.
  • Unified build: One encoded package runs across all supported PHP and loader versions.

PayGlocal will not run without ionCube

If the ionCube Loader is missing or older than 13.0.2, the encoded gateway files won't run — activation fails and no payments are processed. Enable ionCube Loader 13.0.2 or newer for your PHP version (your host can do this in seconds) and try again.

What you need from PayGlocal

This gateway talks to PayGlocal on your behalf, so a few things must come from your PayGlocal onboarding before it can work:

  • A PayGlocal merchant account with an active Merchant ID (MID).
  • A pair of RSA keys as .pem files: merchant private key and PayGlocal public key, each with its Key ID (KID). See the key setup guide.

Keep both .pem files in a directory outside your web root, readable only by the web-server user.

Why a license

  • Payment processing: An active license key enables gateway transactions.
  • Configuration: Enter the key in Setup → Payment Gateways → PayGlocal.
  • Network access: Server requires outbound HTTPS to relyweb.co for validation.

See Licensing for details.

How to check

  • PHP & ionCube: Check Utilities → System → PHP Info (or php -v) for PHP 8.2+ and ionCube 13.0.2+.
  • Extensions: Verify curl and openssl in PHP Info.
  • SSL: Ensure WHMCS operates over valid https:// without certificate warnings.
  • PayGlocal: Confirm active MID and GCC dashboard key generation access.

Documentation for the Relyweb app catalogue.