Configuration

All of Zoho Payments' settings live on one native WHMCS page: Setup → Payment Gateways → Zoho Payments. There's no separate addon area — you fill in the nine fields on this form, click Save Changes, and the gateway is ready. This page walks through each field in the order you'll work through them, so you know exactly what to enter and where it comes from.

Setup → Payment Gateways → Zoho Payments

Where things come from

The Account ID and Widget API Key come from your Zoho Payments account and Developer Space; the Client ID, Client Secret and Refresh Token come from your OAuth app in the Zoho Developer Console; the Webhook Secret comes from your Zoho webhook settings; and the License Key comes from relyweb.co. The Zoho OAuth setup guide shows how to obtain the Zoho values.

Account ID

Enter your Zoho Payments Account ID. Together with the Widget API Key, this tells the embedded widget which Zoho Payments account should collect the payment. Copy it from your Zoho Payments account.

Widget API Key

The API key from your Zoho Developer Space, used to load the payment widget on the invoice page. If the widget doesn't appear at checkout, this key and the Account ID are the first two values to double-check.

Client ID

The OAuth Client ID from the app you created in the Zoho Developer Console. This identifies your integration to Zoho when it requests access. Save the form after entering this and the Client Secret so the token helper can use them.

Client Secret

The OAuth Client Secret that pairs with your Client ID. Keep it private — it's the credential that lets your integration authenticate with Zoho.

Refresh Token

The long-lived token that keeps the gateway connected to Zoho without you signing in again. You don't type this by hand — after saving your Client ID and Client Secret, click the "Click Here to Generate Token" helper link in the settings, authorise the app with Zoho, and the refresh token is returned for you to save here. The gateway uses it to refresh its access automatically.

Generate it once

You only generate the refresh token once. If you change your OAuth app or revoke access in Zoho, regenerate it with the same helper link. Full steps are in the Zoho OAuth setup guide.

Data Center

Choose the Zoho data centre your account lives in:

• IN — India (.in)
• US — United States (.com)

This must match the data centre where you created your Zoho account and OAuth app. The default is IN. If you authorise against the wrong region, the token and API calls won't line up.

Webhook Secret

The secret from your Zoho Payments webhook settings. Paste it here so the gateway can verify that Payment Link notifications genuinely came from Zoho. This field also shows your Webhook URL — the address you register in Zoho:

https://yourdomain.com/modules/gateways/zohopayments/webhooks/paylink_webhook.php

Add that URL as a webhook in your Zoho Payments dashboard, subscribe it to the Payment completed and Payment Link paid events, then copy the secret Zoho provides back into this field.

Secrets must match

The value here must match the secret shown in Zoho's webhook settings exactly, and the URL must be reachable over valid SSL. A mismatch means notifications are rejected and Payment Link invoices won't update on their own.

Test Mode

Controls whether payments run against Zoho's sandbox or live environment.

• Yes — sandbox/testing. Use this while you verify checkout end to end.
• No — live. Real payments are accepted.

The default is No. Always test with Yes first, then switch to No for launch — see the Going live guide.

License Key

Your Zoho Payments license key from relyweb.co. This is what enables payment processing. With an active key, payments are accepted and recorded normally; if the key is missing or inactive, new payments are blocked until you renew or re-enter it. See Licensing for the Leased and Lifetime options.

After filling in the fields, click Save Changes. For defaults at a glance, see the Settings reference.

Related pages

• Settings reference — every field with its default
• Zoho OAuth setup — create the app and refresh token
• Widget checkout — how customers pay
• Installation — the full setup sequence
• Licensing — Leased vs Lifetime and your key