Help CenterHelp Center / Payments · How-to
Take UPI, card and netbanking payments through Razorpay.
Razorpay takes payments in your shop's currency. Customers pay on a separate payment page, or over your checkout page when you switch that on.
Go to Shop › Settings › Payment Gateways and select the Razorpay card to unfold it.
| Field | Required | What to enter |
|---|---|---|
| Key Id | Yes | The key id of your Razorpay API key pair. |
| Key Secret | Yes | The secret of the same key pair. Write-only. |
| Color | No | The colour of the Razorpay payment window. |
| Disable UPI | No | On: hides the UPI QR code payment option. |
| Verify Razorpay webhook signature | No | Off by default. Turn it on only after you save the Webhook Secret, otherwise every webhook is rejected. |
| Webhook Secret | No | The secret you typed when you created the webhook in the Razorpay dashboard. It is not the Key Secret. Write-only. |
| Pay on the checkout page | No | On: Razorpay Checkout opens over your website's checkout page instead of a separate payment page. |
| Saved cards | No | Needs card tokenisation activated on your Razorpay account. Ask Razorpay support before you switch it on. |
The card shows two addresses to add as webhooks in the Razorpay dashboard:
payment.authorized, payment.captured, payment.failed and order.paid. Use the same secret as Webhook Secret.The callback address shown below them is sent with every payment. There is nothing to configure for it.
Add RAZORPAY to the Payment Gateways list at the top of the tab, then select Save Settings. The card shows Switched on.
There is no switch. A test-mode Key Id, recognised by its test prefix, makes the card read Sandbox; any other key id reads Live.
Connect with test credentials first, so the card reads Sandbox. Place a test order, choose this method and pay with a test payment from the provider's own documentation. Check that the order arrives in Orders. Then replace the test credentials with live ones and confirm the pill reads Live.
In live mode Razorpay accepts payments only from websites on your account's allow-list. Add the address shown on the card and your website's domains in the Razorpay dashboard, under Account & Settings › Website and app details.
RAZORPAY and RAZORPAY(NEW) both use this card's keys, and the checkout-page switch applies to both.