API ReferenceIntegrationsKnowledge Base

Set Up and Edit RazorpayX Webhooks

You can set up and edit webhooks from the RazorpayX Dashboard.

Set Up and Edit Webhooks🔗

Watch this video to set up webhooks in RazorpayX.

To set up webhooks:

  1. Log in to the RazorpayX Dashboard , and navigate to My Account & SettingsDeveloper Controls. Click Add Webhooks if you are setting up a webhook for the first time or Edit Webhook to edit a previously saved webhook.
  2. Enter the Webhook URL where you want to receive the webhook payload when an event is triggered. Handy Tips
  3. Enter a Secret for the webhook endpoint. This is an optional field and is used for validation. Handy Tips
    • When setting up the Webhooks, 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.
    • It is not necessary that the webhoook secret should be the merchant secret key provided by Razorpay.
  4. Select the events for which you want to subscribe from the list of Active Events.
  5. Click SAVE to enable the webhook.

To edit webhooks: After you set the webhooks, you can click Edit to make changes to a webhook.

Next Steps
You should validate and test your webhooks before you go live. Know more about validating and testing your webhooks.

Enable/Disable a Webhook🔗

To enable or disable a webhook:

  1. Log into the RazorpayX Dashboard and navigate to My Account & SettingsDeveloper Controls.

  2. Scroll down to the WEBHOOKS section.

  3. Click EDIT WEBHOOK.

  4. Click the Webhook Active switch to enable or disable the webhook as shown below:


All webhook responses must return a status code in the range 2XX within a window of 5 seconds. If we receive response codes other than this or if the request times out, it is considered a failure.

On failure, a webhook is re-tried at progressive intervals of time, defined in the exponential back-off policy, for 24 hours. If the failures continue for 24 hours, the webhook is disabled. You have to enable the webhook from the RazorpayX Dashboard after fixing the errors at your end. Know more about enabling webhooks.

Handy Tips
When a webhook gets disabled, you receive an email notification on the email id that you configured while setting up the webhooks.