---
url: /zoho-payments-whmcs/settings.md
description: >-
  A field-by-field reference for every Zoho Payments for WHMCS gateway setting,
  with defaults and where each value comes from, plus where to find the Gateway
  Log.
---

# Settings reference

Every Zoho Payments setting lives on the gateway form at **Setup → Payment Gateways → Zoho
Payments**. This page is a quick reference to all nine fields with their defaults. For step-by-step
guidance on filling them in, see [Configuration](/zoho-payments-whmcs/configuration).

## Gateway fields

| Field | What to enter | Default |
| --- | --- | --- |
| **Account ID** | Your Zoho Payments Account ID | *(empty)* |
| **Widget API Key** | API key from the Zoho Developer Space (used for the payment widget) | *(empty)* |
| **Client ID** | OAuth Client ID from the Zoho Developer Console | *(empty)* |
| **Client Secret** | OAuth Client Secret | *(empty)* |
| **Refresh Token** | Generated with the **"Click Here to Generate Token"** helper link | *(empty)* |
| **Data Center** | `IN` (India / .in) or `US` (United States / .com) | `IN` |
| **Webhook Secret** | Secret from Zoho Payments webhook settings — the field also shows your Webhook URL | *(empty)* |
| **Test Mode** | `Yes` = sandbox/testing; `No` = live | `No` |
| **License Key** | Your Zoho Payments license key from relyweb.co | *(empty)* |

::: tip Refresh token and webhook secret
You don't type the **Refresh Token** by hand — save your Client ID and Client Secret first, then
use the **"Click Here to Generate Token"** helper link. The **Webhook Secret** field also displays
the Webhook URL to register in Zoho:
`https://yourdomain.com/modules/gateways/zohopayments/webhooks/paylink_webhook.php`
:::

## Test Mode and Data Center

Two fields change how and where the gateway talks to Zoho:

* **Data Center** must match the region of your Zoho account — **IN** for `.in`, **US** for
  `.com`. The default is **IN**. Your OAuth app and Account ID must belong to the same region.
* **Test Mode** defaults to **No** (live). Set it to **Yes** while testing, then back to **No**
  to accept real payments. See the [Going live guide](/zoho-payments-whmcs/guides/going-live).

## Where to see gateway activity {#gateway-log}

Zoho Payments records its activity in the **Gateway Log**, at **Utilities → Logs → Gateway Log**.
This is where you check what happened when a payment, token refresh, or webhook doesn't behave as
expected — for example a rejected webhook, an OAuth token problem, or a payment that was blocked
while the license was inactive. Start troubleshooting here before changing settings.

## Related pages

* [Configuration](/zoho-payments-whmcs/configuration) — each field explained in order
* [Zoho OAuth setup](/zoho-payments-whmcs/guides/zoho-oauth) — app, refresh token, webhook
* [Widget checkout](/zoho-payments-whmcs/features/widget-checkout) — how customers pay
* [Troubleshooting](/zoho-payments-whmcs/troubleshooting) · [Error reference](/zoho-payments-whmcs/errors)
* [Licensing](/zoho-payments-whmcs/licensing) — Leased vs Lifetime and your key