Going live

The final check before accepting real money: confirm the setup, prove the full flow in test mode, then flip Test Mode to live.

1. Test in test mode

Keep Test Mode set to Yes and run a complete payment.

1. Open an invoice in the client area → Pay Now.
2. Complete the payment inside the Zoho widget.
3. Confirm the invoice reaches Paid, with transaction details and fee recorded.
4. If you use Payment Links, test one and confirm the webhook marks the invoice Paid.

Watch the Gateway Log

Keep Utilities → Logs → Gateway Log open while you test — the fastest way to see whether verification and webhooks succeed.

2. Go-live checklist

• [ ] License Key entered and active — payments are blocked while it's inactive (Licensing)
• [ ] Data Center matches your Zoho account (IN or US)
• [ ] Client ID, Client Secret, and a valid Refresh Token in place
• [ ] Account ID and Widget API Key entered — the widget loads
• [ ] Webhook added in Zoho for Payment completed and Payment Link paid, with Webhook Secret matching the config
• [ ] Valid SSL certificate so the webhook endpoint is reachable
• [ ] A test-mode payment completed and reached Paid, fee recorded

Use live credentials for production

If your Zoho account uses separate credentials for test and live environments, update Client ID, Client Secret, Refresh Token, and Widget API Key before going live.

3. Switch to live

Setup → Payment Gateways → Zoho Payments → set Test Mode to No → Save Changes.

Setup → Payment Gateways → Zoho Payments

4. Verify live

Process a small live payment to confirm end-to-end processing. Verify the invoice marks Paid and processing fees log accurately. Monitor Utilities → Logs → Gateway Log during early live transactions.

If something looks off

Start with the troubleshooting page — it maps common symptoms (widget not loading, token errors, webhook not processing) to fixes.

Related pages

• Zoho OAuth setup
• Widget checkout
• Webhooks and Payment Links
• Configuration
• Licensing
• Troubleshooting