Appearance
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
| Requirement | Details |
|---|---|
| PHP | 8.2 or newer (runs on 8.2, 8.3, 8.4 and 8.5) |
| WHMCS | 8.13 or newer, or 9.x |
| ionCube Loader | 13.0.2 or newer (see below) |
| PHP extensions | curl, openssl |
| SSL certificate | Required for the payment callback endpoint |
| WHMCS daily cron | Required for recurring billing (auto-charging invoices via Standing Instructions) |
| PayGlocal merchant account | A PayGlocal Merchant ID (MID) |
| RSA keys | Merchant private + PayGlocal public .pem keys, each with a Key ID (KID) |
| License | An 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
.pemfiles: 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.cofor 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
curlandopensslin PHP Info. - SSL: Ensure WHMCS operates over valid
https://without certificate warnings. - PayGlocal: Confirm active MID and GCC dashboard key generation access.
Related pages
- Installation — upload, activate, and configure
- PayGlocal key setup — generate your RSA keys
- Configuration — fill in the gateway settings
- Licensing — the two license types