Appearance
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.
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 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/webhooksWhen you are done, click Save Settings.
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. To wire up event delivery and set the matching Webhook Secret in both places, see Configure webhooks. To enable recurring billing, Set up subscriptions. For a field-by-field list, see the Settings reference.