---
url: /cashfree-acellemail/configuration.md
description: >-
  A guided walkthrough of the Cashfree plugin settings — the License, Service
  Configuration and Webhook Configuration cards, plus the Sandbox toggle and
  shared credentials.
---

# Configuration

Everything the Cashfree gateways need lives on one page: **Admin → Plugins → Cashfree → Settings**
(you must be logged in as an admin). You configure it **once** — both the **Cashfree** and **Cashfree
Subscription** gateways read the same credentials, so there is no per-gateway setup. This page walks
you through each of the three cards on that screen and what to enter.

![The Cashfree settings page with its three cards](/cashfree-acellemail/img/cashfree-configuration-cards.png)
*Admin → Plugins → Cashfree → Settings*

## License

The first card is where you paste your license key and confirm it is valid.

Enter your **License Key** and click **Save Settings**. A status badge shows the result:

* **Active** — you're good. The card confirms: *"License is active. Both Cashfree (direct payment)
  and Cashfree Subscription gateways are enabled."*
* **Not configured** — you haven't entered a key yet.
* **Invalid — payment gateway is disabled** — the key isn't valid, so the gateways stay hidden. The
  card explains: *"License is not active. Cashfree gateways will not appear in Payment Gateway
  options until a valid license is entered and saved."*

The license check runs locally in the background against relyweb.co; brief outages are tolerated. If
the badge ever slips, re-enter and re-save your key to restore it. See
[Licensing](/cashfree-acellemail/licensing) for the full picture.

## Service Configuration

This card holds the Cashfree credentials that both gateways share. You get all of these from
**Cashfree Dashboard → Developers → API Keys** — see
[Get your API keys](/cashfree-acellemail/guides/get-api-keys).

* **App ID (x-client-id)** — your Cashfree client ID. The field help reads *"From x-client-id in your
  Cashfree Dashboard → Developers → API Keys."* Test keys begin with `TEST`.
* **Secret Key (x-client-secret)** — your Cashfree secret, entered as a password. It is *also used as
  a fallback for webhook signature verification* when you haven't set an endpoint-specific Webhook
  Secret.
* **Webhook Secret (endpoint-specific, optional)** — from **Cashfree Dashboard → Developers →
  Webhooks → your endpoint → Secret Key** (webhook version 2025-01-01 or newer). Leave it blank to
  verify webhooks with your Secret Key instead.
* **Sandbox mode — use the Cashfree test environment** — a checkbox that decides which Cashfree
  environment the plugin talks to. Ticked, it uses the test base URL `https://sandbox.cashfree.com/pg`;
  unticked, it uses live production.

::: warning The checkbox chooses the environment — not the key format
Cashfree does not switch environments based on your key format. You must match them yourself: use
**Test keys** (App ID begins `TEST`) with **Sandbox ticked**, and **Production keys** with **Sandbox
unticked**. Mismatching them causes an authentication failure at checkout.
:::

## Webhook Configuration

The third card is a **reference** panel. It shows the exact endpoint URL to paste into Cashfree, the
webhook version, the events to enable and the Cashfree IPs to whitelist — so you can copy them
straight into your dashboard. Your webhook endpoint is:

```
https://YOUR_DOMAIN/cashier/cashfree/webhooks
```

Setting up webhooks correctly is what lets Cashfree confirm payments and subscription events back to
AcelleMail. Follow [Configure webhooks](/cashfree-acellemail/guides/configure-webhooks) to add the
endpoint on both the *Payment Gateway* and *Subscriptions* tabs.

## Save and next steps

Whenever you change anything on this page, click **Save Settings**. After a successful save with an
Active license, both gateways are available in **Admin → Payment Gateways**. From here:

* Wire up [webhooks](/cashfree-acellemail/guides/configure-webhooks).
* Map your recurring plans in [Set up subscriptions](/cashfree-acellemail/guides/set-up-subscriptions).
* See the [Settings reference](/cashfree-acellemail/settings) for a field-by-field summary.

## Related pages

* [Get your API keys](/cashfree-acellemail/guides/get-api-keys)
* [Configure webhooks](/cashfree-acellemail/guides/configure-webhooks)
* [Set up subscriptions](/cashfree-acellemail/guides/set-up-subscriptions)
* [Settings reference](/cashfree-acellemail/settings)
* [Licensing](/cashfree-acellemail/licensing)