---
url: /relypay-whmcs/requirements.md
description: >-
  What your server and WHMCS install need before you run RelyPay — PHP, WHMCS,
  the ionCube Loader, SSL, PHP extensions, a payment-provider account and an
  active license, with how to check each one.
---

# Requirements

Verify that your server environment satisfies the requirements below before installing RelyPay. An active **ionCube Loader** is mandatory to execute encoded module files.

## 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 |
| **Admin access** | A **Full Administrator** account; the addon must be granted access to your admin role |
| **ionCube Loader** | 13.0.2 or newer (see below) |
| **PHP extensions** | `curl`, `openssl`, `json`, `zip`, `mbstring` |
| **SSL certificate** | Required for provider webhook endpoints |
| **A provider account** | At least one of Razorpay, Cashfree, PhonePe, PayGlocal or Zoho Payments |
| **License** | An active RelyPay license |

## The ionCube Loader

RelyPay requires the standard **ionCube Loader** PHP extension used by WHMCS:

* **Module compatibility:** Executes encoded addon files.
* **Built-in support:** Standard on most WHMCS hosting environments.

Install **ionCube Loader 13.0.2 or newer** matching your active PHP version:

* **PHP 8.2:** Loader 13.0.2+
* **PHP 8.3 / 8.4 / 8.5:** Loader 14.4.0+ or 15.x
* **Cross-version build:** A single RelyPay package supports all compatible PHP and loader releases.

::: danger RelyPay will not run without ionCube
If the loader is missing or outdated, PHP halts with: `This product requires the ionCube PHP Loader`. Request that your web host enables **ionCube Loader 13.0.2 or newer** for your PHP runtime.
:::

## Why a provider account and SSL

Live payment processing and asynchronous callbacks require:

* **Provider account:** At least one active account with Razorpay, Cashfree, PhonePe, PayGlocal, or Zoho Payments.
* **HTTPS endpoint:** Valid SSL certificate on your WHMCS domain to receive encrypted provider webhooks.

## Why Full Administrator access

WHMCS controls addon module access by **administrator role**:

* **Role assignment:** Grant access to **Full Administrator** (and other designated payment management roles) during activation.
* **Access Denied resolution:** If RelyPay pages display **Access Denied**, update permissions under **Configuration → System Settings → Administrator Roles**.

## Why a license

RelyPay requires an active license. You enter your key after activation — see
[Installation](/relypay-whmcs/installation) — and manage it later under
**Addons → RelyPay → Global Settings → License Information**. See
[Licensing](/relypay-whmcs/licensing) for how the license types work.

## How to check

You don't need to guess at any of this:

* **PHP version and extensions** — open **Utilities → System → PHP Info** in the WHMCS admin, or
  ask your host. Confirm PHP 8.2+ and that `curl`, `openssl`, `json`, `zip` and `mbstring` are
  loaded.
* **ionCube Loader** — the same **PHP Info** page lists the ionCube Loader and its version if it
  is installed. If you can't find it, it isn't enabled.
* **WHMCS version** — shown in the WHMCS admin footer, and under **Help → System Health Status**.
* **SSL** — load your storefront and confirm the address bar shows `https://` with a valid
  certificate.

::: tip Ready to install?
Once your server checks out, head to [Installation](/relypay-whmcs/installation) for the
step-by-step activation walkthrough.
:::