---
url: /zoho-payments-whmcs/uninstalling.md
description: >-
  How to remove Zoho Payments for WHMCS — deactivate the gateway to stop
  accepting payments, or delete the module files to remove it completely.
---

# Uninstalling

Uninstalling Zoho Payments involves two approaches: **deactivation** (reversible — suspends checkout while preserving configuration) or **file deletion** (permanent removal).

## Deactivate (reversible)

To stop accepting Zoho Payments without removing anything:

1. Go to **Setup → Payment Gateways**.
2. Find **Zoho Payments** in your active gateways and **deactivate** it.

Deactivation removes Zoho Payments from client checkout options immediately:

* **Preserved configuration:** Gateway credentials, API keys, and settings remain saved in WHMCS.
* **Easy resumption:** Re-enabling the gateway restores checkout without re-entering settings.
* **Safe suspension:** Ideal for temporary maintenance or gateway testing.

::: tip Temporary suspension
To suspend payments temporarily, deactivate the gateway rather than removing files. In-progress payments continue to verify and record against invoices normally.
:::

## Remove all data (irreversible)

To remove the gateway completely:

1. **Deactivate** it first, as above.
2. Delete the gateway files from your WHMCS root:
   * `modules/gateways/zohopayments.php`
   * the entire `modules/gateways/zohopayments/` directory (this includes the callback and
     webhook files)

After deleting module files:

* **Gateway list:** Zoho Payments no longer appears in **Setup → Payment Gateways**.
* **Webhook endpoint:** Inbound webhook URLs immediately return 404 responses.
* **Historical data:** Existing invoice and payment transaction records remain untouched in WHMCS.

::: warning Delete Zoho webhook
Delete the configured webhook endpoint in your **Zoho Payments dashboard** to stop Zoho from sending notifications to a removed URL.
:::

## Related pages

* [Backup and restore](/zoho-payments-whmcs/backup-and-restore) — back up before removing anything
* [Installation](/zoho-payments-whmcs/installation) — how to set it up again
* [Licensing](/zoho-payments-whmcs/licensing) — pausing by license state instead of deleting