---
url: /relypay-whmcs/guides/cashfree.md
description: >-
  Set up Cashfree in RelyPay for WHMCS — enter your App ID and Secret Key, pick
  a checkout mode, enable test mode for the sandbox, register webhooks, and test
  the connection.
---

# Connect Cashfree

Cashfree offers full Indian method coverage — UPI, Cards, Net Banking, Wallets, Pay Later,
EMI and PayPal — with a choice of redirect or popup checkout. Connect it on the
**Addons → RelyPay → Providers** page.

![The Cashfree configuration card in RelyPay](/relypay-whmcs/img/relypay-cashfree-config.png)
*Addons → RelyPay → Providers → Cashfree*

## Credentials you will need

On the Cashfree card, fill in these fields exactly:

| Field | Where to find it |
| --- | --- |
| **App ID** | From Cashfree Dashboard → Developers → API Keys |
| **Secret Key** | From Cashfree Dashboard → Developers → API Keys |

Both values come from the same **Developers → API Keys** screen in the Cashfree Dashboard.

## Options

* **Test Mode** — toggle. *Enable for sandbox testing.* Turn this on to point RelyPay at
  Cashfree's sandbox while you trial the integration, and turn it off for live payments.
* **Checkout Mode** — choose **Redirect (Full Page)** or **Popup (Modal)**.
  *How the checkout is displayed.* Redirect sends the customer to a full Cashfree page;
  Popup keeps them on your site in a modal.

## Register the webhook

1. On the Cashfree card in RelyPay, copy the **webhook URL** shown.
2. In the Cashfree Dashboard, add that URL as your webhook/notification endpoint.
3. Subscribe to these events:

| Event | Required? |
| --- | --- |
| `PAYMENT_SUCCESS_WEBHOOK` | Required |
| `PAYMENT_FAILED_WEBHOOK` | Required |
| `PAYMENT_USER_DROPPED_WEBHOOK` | Optional |

::: warning SSL required
The webhook URL must be HTTPS. Cashfree will not deliver events to an insecure endpoint,
and RelyPay verifies each callback's signature.
:::

## Sandbox testing

With **Test Mode** enabled, use your Cashfree sandbox App ID and Secret Key to place trial
payments without moving real money. When you are satisfied, switch to your production keys
and disable Test Mode.

## Test it

1. Click **Test Connection** on the Cashfree card to confirm your keys reach Cashfree.
2. Enable Cashfree and save.
3. Place a test payment through a RelyPay [sub-gateway](/relypay-whmcs/features/sub-gateways)
   that Cashfree can serve, and confirm the result appears in the
   [transaction log](/relypay-whmcs/features/transactions) with **Cashfree** as the provider.

## Related

* [Configuration overview](/relypay-whmcs/configuration)
* [Routing](/relypay-whmcs/features/routing)