Appearance
Configuration
Once RelyPay is activated and licensed, the next job is to connect at least one payment provider. Everything happens on one screen: Addons → RelyPay → Providers. You enter each provider's credentials, test the connection, and paste RelyPay's webhook URL into the provider's own dashboard so payment results come back to WHMCS automatically.
Addons → RelyPay → Providers
The Providers page
Each of the five providers — Razorpay, Cashfree, PhonePe, PayGlocal and Zoho Payments — has its own card with an enable/disable state, a set of credential fields, and a Test Connection control. You only need to configure the providers you actually intend to route payments to, but configuring more than one lets routing spread traffic and fall back automatically.
To connect a provider:
- Open Addons → RelyPay → Providers and pick the provider.
- Enter its credentials (see the summary table below, and the per-provider guides).
- Enable the provider.
- Click Test Connection to confirm the credentials reach the provider.
- Copy the webhook URL RelyPay shows and paste it into the provider's dashboard, then subscribe to the listed events.
Test the connection first
Test Connection verifies your credentials with the provider before any customer ever reaches checkout. If it fails, fix the keys before enabling the provider for live traffic.
Credentials at a glance
Each provider needs a different set of credentials. Use this table to see what you will be asked for, then follow the linked guide for exact field labels, where to find each value, and any provider-specific options.
| Provider | Key credentials | Notable options | Guide |
|---|---|---|---|
| Razorpay | Key ID, Key Secret, Webhook Secret | Payment Action (Capture / Authorize) | Razorpay |
| Cashfree | App ID, Secret Key | Test Mode, Checkout Mode (Redirect / Popup) | Cashfree |
| PhonePe | Client ID, Client Secret, Client Version | Payment Mode (Redirect / Iframe), Sandbox Mode | PhonePe |
| PayGlocal | Merchant ID, private/public key paths & IDs | Test Mode; powers recurring on international cards | PayGlocal |
| Zoho Payments | Account ID, API Key, OAuth Client ID, Client Secret, Refresh Token | Data Center, Webhook Secret, Test Mode | Zoho |
Webhooks, in plain English
A webhook is how a provider tells RelyPay what happened to a payment — captured, failed, or cancelled — even if the customer closes the browser before returning. Without a webhook, a paid invoice might not be marked paid.
Setting one up is the same idea for every provider:
- On the provider's config page in RelyPay, find the webhook URL RelyPay shows you.
- Paste that URL into the provider's dashboard where it asks for a webhook or callback endpoint.
- Subscribe to the events RelyPay lists for that provider. Required events must be enabled; optional ones give you richer status in the transaction log.
- Save it in the provider dashboard.
Each provider guide lists that provider's exact events and marks which are required.
SSL is required
Webhook endpoints must be served over HTTPS. Make sure your WHMCS install has a valid SSL certificate before you register a webhook — providers will refuse to deliver events to an insecure URL, and RelyPay verifies every callback's signature.
Every callback is verified
RelyPay cryptographically signature-verifies every provider callback, and duplicate callbacks are ignored, so a payment is never processed twice.
After you connect a provider
- Enable the sub-gateways your customers should see under Setup → Payment Gateways.
- Decide which provider takes each payment on the Routing page — by currency, amount, percentage split, or fallback.
- Review the full Settings reference for global options such as default gateways and sync.