If you have selected Razorpay as your merchant, you must authorize your Zoho Forms account to access your Razorpay resources using OAuth authentication.
OAuth Authentication lets you connect your form with Razorpay using secure access tokens instead of Key ID and Key Secret, providing secure access to the Razorpay resources via token-based authentication.
To configure Razorpay in the Payment field,
- Configure OAuth Authentication if you are configuring Razorpay for the first time.
- If you have already configured your form with Razorpay using Key ID and Key Secret, you can Switch to OAuth Authentication.
If you are configuring your form with Razorpay for the first time,
-
Click Authenticate to grant Zoho Forms access to connect with your Razorpay account.
-
In the pop-up, enter OAuth Name and select the Mode of Authentication to be either Sandbox or Production.
Note: We recommend that you enter a meaningful OAuth Name. This name will be for your reference to identify the OAuth.
-
Click Proceed.
- You will be redirected to the RazorPay window. Use the Razorpay account owner’s login details to authorize OAuth authentication and connect to a specific Merchant ID. Click Authorize to allow Zoho Forms to securely access your RazorPay account to make read/write operations while processing payments.
- Once authorized, you can view a list of authorized RazorPay accounts in the OAuth Authorized with dropdown in your Zoho Forms Payment field configuration.
- To authorize a new RazorPay account, click + New Connection in the dropdown.

- Enter the Payment Amount. You can either set a fixed amount for payment or autofill the Payment Amount with a value from a form field.
- Under Prefill Information, you can include Email and Phone from the form fields. This information will be prefilled in the merchant site.
- Under Checkout Page Display Settings, enable Apply Razorpay Checkout Styling to use the checkout style configured for brand name and background color in your Razorpay dashboard to your checkout page. Learn more
- To capture the status of payment for certain cases when a payment is made via Razorpay through the mobile payment app, you can configure a webhook under Webhook Configuration.
- Click Done.
Configuring Checkout Page Display Settings
To style your checkout page with your brand name and desired background color from Razorpay's Checkout Styling, do the following
Razorpay Dashboard:
- In your Razorpay dashboard, navigate to Account & Settings > Checkout settings > Checkout Styling.
- Set your preferred background color under Background color and your brand name under Brand name and logo.
- Save all the changes.

Zoho Forms Payment Gateway:
- In your form, navigate to Razorpay payment gateway configuration.
- Under Checkout Page Display Settings, enable Apply Razorpay Checkout Styling.
This will apply the background color and brand name configured in your Razorpay's Checkout Styling to your checkout page.
Note:
Other checkout styling elements such as Brand logo, Border Style, Font, Slidebar graphic, Razorpay trusted badge will be displayed on checkout page according to your configurations in Razorpay's Checkout Styling, regardless the selection made under Checkout Page Display Settings.
Switch to OAuth Authentication
If you have already configured your form with Razorpay using Key ID and Key Secret and would like to authorize Zoho forms to access your Razorpay account using OAuth authentication,
-
Click
Authenticate OAuth in the top-right corner of the Payment Gateway configuration.

-
In the pop-up, enter the OAuth Name and select the Mode of Authentication to be either Sandbox or Production.
Note: We recommend that you enter a meaningful OAuth Name. This name will be for your reference to identify the OAuth.
-
Click Proceed.
-
You will be redirected to the RazorPay window. Use the Razorpay account owner’s login details to authorize OAuth authentication and connect to a specific Merchant ID. Click Authorize to allow Zoho Forms to securely access your RazorPay account to make read/write operations while processing payments.
-
Once authorized, you can view a list of authorized RazorPay accounts in the OAuth Authorized with dropdown in your Zoho Forms Payment field configuration.
-
To authorize a new RazorPay account, click
+ New Connection in the dropdown.

-
Enter the Payment Amount. You can either set a fixed amount for payment or autofill the Payment Amount with a value from a form field.
-
Under Prefill Information, you can include Email and Phone from the form fields. This information will be prefilled in the merchant site during payment.
-
Under
Checkout Page Display Settings, enable
Apply Razorpay Checkout Styling to use the checkout style configured for brand name and background color in your Razorpay dashboard to your checkout page.
Learn more
- To capture the status of payment for certain cases when a payment is made via Razorpay through the mobile payment app, you can configure a webhook under Webhook Configuration.
-
Click Done.
- A maximum of 3 Razorpay accounts can be authorized with each Mode of Authentication (Sandbox or Production).
- If you have a custom domain, you must complete the KYC Review Process for your domain with Razorpay to receive payments. Read more
- If the form ownership is changed to a different user, RazorPay OAuth authentication will have to be re-configured.
- If you wish to receive payments in any currency other than INR, you must enable International Payments in your Razorpay Dashboard.
Configuring Razorpay Webhook
When a payment is made through a mobile payment app via Razorpay, there is a possibility that users are not redirected to the browser automatically after the payment. To capture the payment status in such cases (delayed authorized payment, failed payment, payment success), you can configure a webhook while setting up the payment field using Razorpay as your merchant account.
Generating webhook URL
To capture the payment status:
- Select Capture status via webhook under Webhook Configuration.
- Enter a secret key of your choice under Secret. The key must consist of at least 5 characters.
-
A webhook
URL will be provided.

- Click Save.
- Copy the webhook URL in the resultant pop-up.
Once you have finished configuring the webhook URL, go to your Razorpay settings and follow the steps shown below:
Configuring the webhook in Razorpay Settings
- Go to your Razorpay Account's Dashboard and navigate to Settings.
- Under the Webhooks tab, click Setup your Live Webhook.
- Paste the copied Webhook URL in the textbox provided and select Active.
- Enter the Secret Key. This is the key that you have setup under the Payment Settings in your form builder.
- Under Active Events, select the payment.failed and order.paid options.
- Click Save.
Note: If you enable multiple events under Active Events, Zoho Forms will receive unnecessary payment related requests from Razorpay.
When a payment is made, you can check the payment status of a record under All Entries > Payment Status.
- Payment status via webhooks will be updated as long as your webhook is active.
- Payment status will not be updated if there is any mismatch in the Secret key entered.
- Once the webhook is configured, Razorpay will trigger the webhook to Zoho Forms each time the merchant account receives payments (irrespective of the service used for payment via RazorPay).
When configuring payment gateways, sensitive information like secret keys and tokens are encrypted before they are stored in our database and are never exposed to other third party apps.
Revoke OAuth Access Token
To unlink your Razorpay account from your Zoho Forms account, you can remove the OAuth access token from the Control Panel.
To do so,
- Click the home icon in the top-left corner to access the Control Panel.
-
In the Control Panel, click Access Tokens under Developer Space.
- Hover over Razorpay and click the Delete icon.