---
url: /zoho-payments-whmcs/updating.md
description: >-
  How to update Zoho Payments for WHMCS — download the latest build from your
  relyweb.co client area and overwrite the gateway files. There is no in-app
  updater.
---

# Updating

Zoho Payments updates **manually** — there is no in-app updater. Download the latest release from the **relyweb.co client area** and overwrite the gateway files on your server.

## Before you update

A manual update overwrites files in place, so take a backup first — see
[Backup and restore](/zoho-payments-whmcs/backup-and-restore). At minimum, capture:

* A **WHMCS database backup** — your saved gateway settings and transaction records live here.
* A copy of the **module files you're about to overwrite**.

## Download the update

Download the latest build from your **relyweb.co client area**:

* **Leased license:** Access all updates while your subscription remains active.
* **Lifetime license:** Perpetual use of installed builds. Accessing newer versions requires an active **Support & Updates** plan.

## Install the update

Overwrite the existing gateway files with the new copies:

* `modules/gateways/zohopayments.php`
* `modules/gateways/zohopayments/` (the whole directory, including the webhook file)

After uploading files, verify the installation:

1. Navigate to **Setup → Payment Gateways → Zoho Payments**.
2. Confirm credentials, Data Center, Webhook Secret, and **License Key**.
3. Click **Save Changes**.
4. Process a test invoice in **Test Mode** to verify widget loading and payment recording.
   ::: info Settings persist across updates
   Overwriting module files does not erase gateway configuration. Credentials and settings remain stored securely in the WHMCS database.
   :::

## If an update won't apply

* **File placement:** Confirm all files were uploaded to `modules/gateways/` and overwrote previous versions completely.
* **Permissions:** Verify the web server has read permissions for all replaced files and folders.
* **ionCube Loader:** Ensure **ionCube Loader 13.0.2+** is active for your PHP version (see [Requirements](/zoho-payments-whmcs/requirements)).
* **Log review:** If transactions fail, verify your **License Key** and inspect **Utilities → Logs → Gateway Log**.

## Related pages

* [Backup and restore](/zoho-payments-whmcs/backup-and-restore) — back up before you overwrite
* [Licensing](/zoho-payments-whmcs/licensing) — how your license type affects updates
* [Configuration](/zoho-payments-whmcs/configuration) — the settings you re-check after updating
* [Troubleshooting](/zoho-payments-whmcs/troubleshooting) — resolving post-update problems