---
url: /zoho-payments-whmcs/guides/zoho-oauth.md
description: >-
  Connect WHMCS to Zoho Payments — create a server-based OAuth app, generate a
  refresh token, add your Account ID and Widget API Key, and register the signed
  webhook.
---

# Zoho OAuth setup

Connect WHMCS to your Zoho Payments account. Work top to bottom — each step feeds the next.

**Prerequisites:** the gateway activated ([Installation](/zoho-payments-whmcs/installation)) and access to the Zoho Developer Console for your data centre.

::: info Match your data centre
Use the **same Zoho data centre** throughout: India uses `api-console.zoho.in`; US uses `api-console.zoho.com`. Set the matching **Data Center** (`IN` or `US`) in gateway settings.
:::

## 1. Create a server-based OAuth app

In the **Zoho Developer Console** for your region, create a **Server-based Application**:

* Record the generated **Client ID** and **Client Secret**.
* Add the authorized redirect URI required by the helper link.

::: tip Keep the console tab open
You'll return here to re-generate the refresh token or check the redirect URI.
:::

## 2. Enter Client ID and Client Secret in WHMCS

**Setup → Payment Gateways → Zoho Payments** → paste the **Client ID** and **Client Secret** → **Save Changes**. Saving first is required so the helper link can use them.

![The gateway credential fields in WHMCS](/zoho-payments-whmcs/img/zoho-payments-zoho-oauth-credentials.png)
*Setup → Payment Gateways → Zoho Payments*

## 3. Generate the refresh token

1. Click the *"Click Here to Generate Token"* helper link.
2. Authorise the app with Zoho when prompted.
3. Paste the returned token into **Refresh Token**.
4. Click **Save Changes**.

The gateway automatically refreshes access tokens without requiring re-authorization.

::: warning Token errors?
Verify **Client ID** and **Client Secret**, confirm the **redirect URI** is registered in the Developer Console, and ensure **Data Center** matches your console region.
:::

## 4. Add your Account ID and Widget API Key

Enter your **Account ID** and **Widget API Key** from the Zoho Developer Space. These credentials initialize the [checkout widget](/zoho-payments-whmcs/features/widget-checkout).

## 5. Register the webhook

In your Zoho Payments dashboard, add a webhook with:

* **Webhook URL:** `https://yourdomain.com/modules/gateways/zohopayments/webhooks/paylink_webhook.php`
* **Events:** **Payment completed** and **Payment Link paid**

Copy Zoho's webhook **secret** into the **Webhook Secret** field in WHMCS → **Save Changes**. Full detail: [Webhooks and Payment Links](/zoho-payments-whmcs/features/webhooks-and-payment-links).

## Verify

Turn on **Test Mode** and run a test payment. When it works end to end, follow the [going live guide](/zoho-payments-whmcs/guides/going-live).

## Related pages

* [Going live](/zoho-payments-whmcs/guides/going-live)
* [Widget checkout](/zoho-payments-whmcs/features/widget-checkout)
* [Webhooks and Payment Links](/zoho-payments-whmcs/features/webhooks-and-payment-links)
* [Configuration](/zoho-payments-whmcs/configuration)
* [Troubleshooting](/zoho-payments-whmcs/troubleshooting)