---
url: /payglocal-whmcs/requirements.md
description: >-
  What your server and PayGlocal account need before you install PayGlocal for
  WHMCS — PHP, WHMCS, ionCube, a merchant account and the RSA keys it uses.
---

# 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 |

::: info 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.

::: danger 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](/payglocal-whmcs/guides/payglocal-keys).

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](/payglocal-whmcs/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.

## Related pages

* [Installation](/payglocal-whmcs/installation) — upload, activate, and configure
* [PayGlocal key setup](/payglocal-whmcs/guides/payglocal-keys) — generate your RSA keys
* [Configuration](/payglocal-whmcs/configuration) — fill in the gateway settings
* [Licensing](/payglocal-whmcs/licensing) — the two license types