---
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 is a WHMCS payment gateway, so it updates **manually** — there is no in-app updater,
no *Check for Updates* button, and no *Update Now*. You download the latest build from your
**relyweb.co client area** and overwrite the gateway files.

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

Sign in to your **relyweb.co client area** and open the Zoho Payments product to download the
latest release. Your entitlement to new versions follows your license:

* **Leased** — you can download updates for as long as your license is active.
* **Lifetime** — you keep your installed version forever; downloading a **newer** version needs an
  active **Support & Updates** plan. If it has lapsed, your current version keeps running — renew
  Support & Updates to download newer releases.

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

Then open **Setup → Payment Gateways → Zoho Payments**, confirm your settings — credentials, Data
Center, Webhook Secret, and **License Key** — are still in place, **Save Changes**, and place a test
order in **Test Mode** to confirm the widget loads and a payment is verified.

::: info Your settings are safe
Overwriting the files does not clear the settings you saved on the gateway page — those live in
WHMCS, not in the files you're replacing. Re-check them after the upload.
:::

## If an update won't apply

* Make sure every file uploaded to the correct WHMCS path and the old ones were overwritten — a
  partial upload leaves mismatched files.
* Confirm the web-server user can read the new files.
* Check your **ionCube Loader** is 13.0.2 or newer — a newer encoded build may need a matching
  loader (see [Requirements](/zoho-payments-whmcs/requirements)).
* If payments stop after the update, re-check the **License Key** and credentials, then review
  **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