---
url: /relypay-whmcs/configuration.md
description: >-
  Connect your payment providers to RelyPay — enable each provider, test the
  connection, and wire up webhooks so payment results flow back into WHMCS.
---

# 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.

![The RelyPay Providers page listing all five providers](/relypay-whmcs/img/relypay-configuration-providers.png)
*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](/relypay-whmcs/features/routing)
spread traffic and fall back automatically.

To connect a provider:

1. Open **Addons → RelyPay → Providers** and pick the provider.
2. Enter its credentials (see the summary table below, and the per-provider guides).
3. **Enable** the provider.
4. Click **Test Connection** to confirm the credentials reach the provider.
5. Copy the webhook URL RelyPay shows and paste it into the provider's dashboard, then
   subscribe to the listed events.

::: tip 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](/relypay-whmcs/guides/razorpay) |
| **Cashfree** | App ID, Secret Key | Test Mode, Checkout Mode (Redirect / Popup) | [Cashfree](/relypay-whmcs/guides/cashfree) |
| **PhonePe** | Client ID, Client Secret, Client Version | Payment Mode (Redirect / Iframe), Sandbox Mode | [PhonePe](/relypay-whmcs/guides/phonepe) |
| **PayGlocal** | Merchant ID, private/public key paths & IDs | Test Mode; powers recurring on international cards | [PayGlocal](/relypay-whmcs/guides/payglocal) |
| **Zoho Payments** | Account ID, API Key, OAuth Client ID, Client Secret, Refresh Token | Data Center, Webhook Secret, Test Mode | [Zoho](/relypay-whmcs/guides/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:

1. On the provider's config page in RelyPay, find the **webhook URL** RelyPay shows you.
2. Paste that URL into the provider's dashboard where it asks for a webhook or callback
   endpoint.
3. **Subscribe to the events** RelyPay lists for that provider. Required events must be
   enabled; optional ones give you richer status in the [transaction log](/relypay-whmcs/features/transactions).
4. Save it in the provider dashboard.

Each provider guide lists that provider's exact events and marks which are required.

::: warning 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.
:::

::: info 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](/relypay-whmcs/features/sub-gateways) your customers should see
  under **Setup → Payment Gateways**.
* Decide which provider takes each payment on the [Routing](/relypay-whmcs/features/routing)
  page — by currency, amount, percentage split, or fallback.
* Review the full [Settings reference](/relypay-whmcs/settings) for global options such as
  default gateways and sync.

## Where to go next

* [Razorpay setup guide](/relypay-whmcs/guides/razorpay)
* [Cashfree setup guide](/relypay-whmcs/guides/cashfree)
* [PhonePe setup guide](/relypay-whmcs/guides/phonepe)
* [PayGlocal setup guide](/relypay-whmcs/guides/payglocal)
* [Zoho Payments setup guide](/relypay-whmcs/guides/zoho)
* [Routing](/relypay-whmcs/features/routing) · [Settings reference](/relypay-whmcs/settings)