---
url: /cashfree-acellemail/settings.md
description: >-
  A field-by-field reference of the Cashfree plugin settings in AcelleMail — the
  License card and its status badges, Service Configuration credentials, Sandbox
  mode, and the Webhook Configuration card.
---

# Settings

Every option for both Cashfree gateways lives on one page: **Admin → Plugins → Cashfree →
Settings** (you must be logged in as an admin). The two gateways — **Cashfree** (direct payment)
and **Cashfree Subscription** — share everything set here. This page describes each field; for a
guided walkthrough of connecting your account, see [Configuration](/cashfree-acellemail/configuration).

![The Cashfree settings page in AcelleMail](/cashfree-acellemail/img/cashfree-settings-overview.png)
*Admin → Plugins → Cashfree → Settings*

## License card

Enter and check your license here.

| Field | What it is |
| --- | --- |
| **License Key** | Your key from relyweb.co. Placeholder *"Enter your license key from relyweb.co"*. |

A status badge shows the current state:

* **Active** — the license is valid. You'll see: *"License is active. Both Cashfree (direct
  payment) and Cashfree Subscription gateways are enabled."*
* **Not configured** — no key entered yet.
* **Invalid — payment gateway is disabled** — the key is not valid, so neither gateway appears.

When the license is not Active you'll see: *"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 as a background check against relyweb.co; brief outages are tolerated — re-enter and re-save
to restore. See [Licensing](/cashfree-acellemail/licensing) for details.

## Service Configuration

Your Cashfree credentials, from **Cashfree Dashboard → Developers → API Keys**. Both gateways use
them.

| Field | What it is |
| --- | --- |
| **App ID (x-client-id)** \* | Your `x-client-id`. Placeholder *"TEST... or your production App ID"*. Help: *"From x-client-id in your Cashfree Dashboard → Developers → API Keys."* |
| **Secret Key (x-client-secret)** \* | Your `x-client-secret` (masked password field). Also used as a fallback for webhook signature verification when no endpoint-specific webhook secret is set. |
| **Webhook Secret (endpoint-specific, optional)** | From Cashfree Dashboard → Developers → Webhooks → your endpoint → Secret Key (v2025-01-01+). Leave blank to verify with the Secret Key. |
| **Sandbox mode — use the Cashfree test environment** | Checkbox. Tick during testing (uses `https://sandbox.cashfree.com/pg`); untick for live. |

::: warning The environment is set by the checkbox, not the key format
Use **Test** keys (App ID begins with `TEST`) with **Sandbox ticked**; use **Production** keys with
Sandbox unticked. See [Get your API keys](/cashfree-acellemail/guides/get-api-keys).
:::

## Webhook Configuration

A reference card showing the values you paste into Cashfree. It lists:

* **Endpoint URL** — `https://YOUR_DOMAIN/cashier/cashfree/webhooks`
* **Webhook version** — `2025-01-01`
* **Events** — payment and subscription events to subscribe to
* **IP whitelist** — the Cashfree IPs to allow on port 443

Copy these into your dashboard as described in
[Configure webhooks](/cashfree-acellemail/guides/configure-webhooks).

## Save Settings

Click **Save Settings** to apply. With a valid, Active license, saving auto-creates both gateways in
**Admin → Payment Gateways** — no manual "Add" step needed.

## Related pages

* [Configuration](/cashfree-acellemail/configuration)
* [Get your API keys](/cashfree-acellemail/guides/get-api-keys)
* [Configure webhooks](/cashfree-acellemail/guides/configure-webhooks)
* [Licensing](/cashfree-acellemail/licensing)
* [Error reference](/cashfree-acellemail/errors)