---
url: /cashfree-acellemail/configuration.md
description: >-
  Configure the Cashfree plugin on one page — the License, Service Configuration
  and Webhook Configuration cards, the Sandbox toggle and shared credentials.
---

# Configuration

Everything both gateways need lives on one page: **Admin → Plugins → Cashfree → Settings** (admin login required). Configure it **once** — **Cashfree** and **Cashfree Subscription** read the same credentials.

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

## License

Paste your **License Key** → **Save Settings**. A status badge shows the result:

| Badge | Meaning |
| --- | --- |
| **Active** | *"License is active. Both Cashfree (direct payment) and Cashfree Subscription gateways are enabled."* |
| **Not configured** | No key entered yet |
| **Invalid — payment gateway is disabled** | *"License is not active. Cashfree gateways will not appear in Payment Gateway options until a valid license is entered and saved."* |

The check runs locally in the background against relyweb.co; brief outages are tolerated. If the badge slips, re-enter and re-save. See [Licensing](/cashfree-acellemail/licensing).

## Service Configuration

The Cashfree credentials both gateways share, from **Cashfree Dashboard → Developers → API Keys** ([Get your API keys](/cashfree-acellemail/guides/get-api-keys)).

| Field | What to enter |
| --- | --- |
| **App ID (x-client-id)** | Your client ID. Help: *"From x-client-id in your Cashfree Dashboard → Developers → API Keys."* Test keys begin with `TEST` |
| **Secret Key (x-client-secret)** | Your secret (password field). Also the fallback for webhook signature verification when no Webhook Secret is set |
| **Webhook Secret** *(endpoint-specific, optional)* | From **Cashfree Dashboard → Developers → Webhooks → your endpoint → Secret Key** (webhook version 2025-01-01 or newer). Blank verifies with your Secret Key |
| **Sandbox mode** | Ticked → test base URL `https://sandbox.cashfree.com/pg`; unticked → live production |

::: warning Match keys to Sandbox mode
Cashfree selects environments via the checkbox, not the key format:

* **Sandbox ticked:** Use Test keys (App ID starting with `TEST`).
* **Sandbox unticked:** Use live Production keys.
* **Mismatch:** Results in authentication failures at checkout.
  :::

## Webhook Configuration

A **reference** card showing the values to paste into Cashfree. Your webhook endpoint:

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

Follow [Configure webhooks](/cashfree-acellemail/guides/configure-webhooks) to add the endpoint on both the *Payment Gateway* and *Subscriptions* tabs.

## Save and next

Click **Save Settings** after any change. With an Active license, both gateways become available in **Admin → Payment Gateways**.

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

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