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