API ReferenceIntegrationsKnowledge Base


Apart from allowing you to configure and customize your checkout page, the Settings option allows you to setup webhooks and generate API keys.

Following are the three tabs available in the Settings option and the actions you can perform in each of them:


The Configuration tab allows you to customize your checkout theme, enable or disable flash checkout, change the speed at which the refunds should be processed and change your email notification preferences.

Change your Checkout Theme#

Following are the customizations allowed on your checkout page:

  • Change the color on your checkout page.
  • Upload your company logo.

Click Theme Color to change the color of your checkout page. Colors can be chosen from a pop-out window.

Click Choose File to upload your company logo.

Click Save Changes.

Flash Checkout#

Flash Checkout is the easiest way to allow your customers to securely save their credit and/or debit card details with Razorpay, thereby reducing transaction time.

Customers need to authenticate themselves only once on their mobile devices. Authentication is done using PCI DSS compliant technology to ensure that all the card information is stored with maximum possible security.

After the one-time authentication, customer's saved cards are available for use to accept payments online via Razorpay. This allows for much simpler and faster transactions.

You can enable or disable flash checkout from the Configuration tab. Flash checkout is enabled by default. Click Disable Flash Checkout to disable it.

Watch the short animation below for more details.

As Razorpay is PCI DSS compliant, all the card information is securely saved in our servers.

Change the Default Refund Speed#

The speed at which the refunds should be processed by Razorpay can be configured in this setting. This gives you a greater control and visibility of refunds, thereby reducing unnecessary support conversations.

By default, all the refunds will be processed normally and will take 5-7 working days to reach your customers. You can select the Instant Refund option for all your payments to be refunded instantly.

Normal Refund
The payments are refunded within 5-7 working days. For details about the speed parameter, you can refer our API Reference Guide.
Instant Refund
The payments are refunded instantaneously (within an hour upto a maximum of 1 working day). There will be a small transaction fee levied by Razorpay for every instant refund created by you. For more information, refer the product documentation.

The global value of the speed set for refunds can be overridden at the individual refund level. For example, once the Instant Refund feature is enabled in the Settings, the Refund Instantly checkbox is selected by default for all the refunds issued from the Transactions menu. You can unselect this checkbox, if you want to issue a normal refund for a particular payment or payments.

International Payments#

By default, you can accept payments in various international currencies supported by Razorpay.

If you do not want to accept payments in currencies apart from INR (₹), you can turn it off using the toggle switch available here.

You can also refer to our Knowledgebase for some FAQs about international payments.

Email Notifications#

You can configure the email addresses to receive email notifications like payments received, settlements received, daily payment reports and webhooks. If you want to enter multiple email addresses, separate them by a comma.


Webhooks allow you to build or set up integrations that subscribe to certain events on Razorpay APIs. When one of those events is triggered, we send an HTTP POST payload in JSON to the webhook's configured URL.

You can set up webhooks from your Dashboard and configure separate URLs for live mode and test mode.

A test mode webhook will only receive events for your test transactions.

In URLs, only port numbers 80 and 443 are currently allowed.

When setting up the webhook, you will be asked to specify a secret. Using this secret, you can validate that the webhook is from Razorpay. Entering the secret is optional, but recommended. The secret should never be exposed publicly.

To setup webhooks:

  1. Log into your Razorpay Dashboard and navigate to SettingsWebhooks.
  2. Click Setup Webhook.
  3. Enter the following details:
    1. Enter the Website URL where you want to receive the webhook payload when an event is triggered.
    2. Enter a Secret for the webhook endpoint. The secret is used for validation purposes. Note:
      The secret that you enter here can be used to validate that the webhook is from Razorpay. Do not expose the secret publicly.
    3. Select the required events from the list of Active Events .
  4. Click Save to enable webhooks.

Watch the short animation below for more details.

Refer to the Webhook section for more information.

API Keys#

API key is a combination of the key_id and key_secret and is required to make any API request to Razorpay. You also have to implement the API key in your code as part of your integration process.

  1. Log into your Dashboard with appropriate credentials.
  2. Select the mode (Test or Live) for which you want to generate the API key. Note:
    You have to generate separate API Keys for the test and live modes. No real money is used in test mode.
  3. Navigate to SettingsAPI KeysGenerate Key to generate key for the selected mode.

The Key Id and Key Secret appear in a pop-out window as shown below:

After generating the keys from the Dashboard, download and save them securely. If you do not remember your API Keys, you need to re-generate it from the Dashboard and replace it wherever required.

Once generated, you will be able to see the Key Id, the date the key was created and the expiry date for the API Key on screen.

Regenerate API Keys#

You also have the option to regenerate the key, if required.

Two Factor Authentication:
To regenerate API keys, you must validate your identity via OTP sent to your registered mobile number. However, this step is skipped if you already performed OTP validation while logging into the Dashboard.
If you have not set up two factor authentication, you will be prompted to verify your mobile number before re-generating keys.

To regenerate API key:

  1. Log into your Dashboard.
  2. Select the mode for which you want to generate the API key from the menu ribbon.
  3. Navigate to Settings, click API Keys and click Regenerate Key to generate key for the selected mode.
  4. This gives you the option to de-activate the old key immediately or in 24 hours.

Watch the short animation below for more information.


You can send your customers automated SMS and email reminders for Payment Links. Using reminders helps you:

  • Increase the number of paid Payment Links.
  • Reduce cost and manual effort required to collect payments.
  • Reduce the number of days taken by your customer to make the payment.

You can send SMS and email reminders to customers about payment links issued to them, but not yet paid. Reminders can be sent:

  • Before the expiry date.
  • After n days of issue of link.

Set Reminders#

Follow these steps to enable reminders for Payment Links through the Razorpay Dashboard. This is a global setting, meaning once enabled all Payment Links would have reminders configured for them. You may choose to manage reminders for individual links.

Navigate to SettingsReminders and enable Reminders for Payment Links.

Reminders vary for payment links with reminders and payment links without reminders.

For Payment Links with Expiry Date#

If you have set an expiry date for the Payment Link, you can configure three reminders based on the expiry date. For example, if you have issued a Payment Link with expiry date as 30 Nov 2019, you can set three reminders:

Expiry Date

Reminders to be sent

30 Nov 2019

3 days before expiry date - 27 Nov 2019
2 days before expiry date - 28 Nov 2019
1 day before expiry date - 29 Nov 2019.

For Payment Links without Expiry Date#

If you have not set any expiry date for Payment Links, you can configure three reminders to be sent after the issued date. For example, if you have issued a Payment Link on 25 Nov 2019, you can set three reminders:

Issued Date

Reminders to be sent

25 Nov 2019

3 days after issued date - 28 Nov 2019
7 days after issued date - 02 Dec 2019
10 days after issued date - 05 Dec 2019.

Advanced Settings#

Select the Channels through which the reminders must be sent. Available channel options are SMS and email.

Customers will receive the reminder email or SMS only if the contact and email details were provided when the payment link was created.

Click Save Changes.

Edit Reminder Configurations#

You can edit the reminder configurations at any time.

  1. Reschedule reminders.
    This can be done by changing the reminder frequency. For example, changing Remind 2 days after Issue Date to Remind 5 days after Issue Date.
  2. Change the Channels settings.
    For example, opting for only email reminders instead of both SMS and Email.

Disable Reminders#

You can disable reminders for all links by following these steps:

  1. Navigate to SettingsReminders
  2. Disable Reminders for Payment Links.

You may choose to disable reminders for a particular link. For example, if you have already received an offline payment from the customer. Learn how to disable reminders for specific links.