API ReferenceIntegrationsKnowledge Base

Settings

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:

Configuration#

The Configuration tab allows you to customize your checkout theme, enable or disable flash checkout 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.

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#

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 a webhook 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 webhook for various events:

  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. This should not be exposed 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.

Note:
You have to generate separate API Keys for the test and live modes. No money is deducted from your account in test mode.

To generate 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.
  4. Click API Keys.
  5. Click Generate Key to generate key for the selected mode.

The Key Id and Key secret appear in a pop-out window. You also have the option to download the Key Details.

Watch the short animation below for more information.

Note:
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.

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.