---
url: /razorpay-acellemail/configuration.md
description: >-
  Walk through the Razorpay plugin's two settings cards in AcelleMail — the
  License card and the Service Configuration card (Key ID, Key Secret and
  Webhook Secret) shared by both gateways.
---

# Configuration

All of the Razorpay gateway's setup lives on one page: **Admin → Plugins → Razorpay → Settings**
(admin login required). It has **two cards** — **License** and **Service Configuration** — and the
values you enter here are shared by both the direct **Razorpay** gateway and the **Razorpay
Subscription** gateway. You configure everything once; there is nothing to set per gateway.

![The Razorpay settings page with both cards](/razorpay-acellemail/img/razorpay-configuration-cards.png)
*Admin → Plugins → Razorpay → Settings*

## The License card

Paste your key into **License Key** and save. A status badge tells you where you stand:

* **Active** (green) — "License is active. Both Razorpay (direct payment) and Razorpay Subscription
  gateways are enabled."
* **Not configured** — no key entered yet.
* **Invalid — payment gateway is disabled** — the key did not validate: "License is not active.
  Razorpay gateways will not appear in Payment Gateway options until a valid license is entered and
  saved."

The license is confirmed by a local background check against relyweb.co; brief outages are tolerated,
and re-saving restores the check. See [Licensing](/razorpay-acellemail/licensing) for details.

## The Service Configuration card

These are your credentials from **Razorpay Dashboard → API Keys**, shared by both gateways:

| Field | What to enter |
| --- | --- |
| **API Key ID** \* | Your Razorpay Key ID — placeholder `rzp_live_...`; "Your Razorpay Key ID (starts with `rzp_live_` or `rzp_test_`)." |
| **API Key Secret** \* | The matching secret (password field). "Keep this confidential — never expose it in client-side code." |
| **Webhook Secret** *(optional)* | From **Razorpay Dashboard → Webhooks** — "Used to verify incoming webhook requests." |

The **Webhook URL** is shown inline next to the Webhook Secret so you can copy it straight into the
Razorpay dashboard:

```
https://YOUR_DOMAIN/cashier/razorpay/webhooks
```

When you are done, click **Save Settings**.

::: info Environment is chosen by the key prefix
There is **no Sandbox checkbox**. The plugin runs in test or live mode based purely on which key you
paste: `rzp_test_...` for test, `rzp_live_...` for live. Swapping the keys switches environments — no
toggle to remember.
:::

To get your keys, see [Get your API keys](/razorpay-acellemail/guides/get-api-keys). To wire up event
delivery and set the matching Webhook Secret in both places, see
[Configure webhooks](/razorpay-acellemail/guides/configure-webhooks). To enable recurring billing,
[Set up subscriptions](/razorpay-acellemail/guides/set-up-subscriptions). For a field-by-field list,
see the [Settings reference](/razorpay-acellemail/settings).

## Related pages

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