Subscribe to Webhooks

Setup and manage webhooks for your client application from your Razorpay Dashboard.

Webhooks allow you to build or set up integrations that subscribe to certain Razorpay events on merchant resources. When one of those events is triggered, we send an HTTP POST payload in JSON to a specific URL.

Webhooks can be configured and managed independently for each application you create on your Razorpay Dashboard, thereby giving you greater control over your notifications.

Know more about


Managing webhooks for individual applications follows the same procedure as managing account webhooks.

Handy Tips

If you are just starting off and have not created an application yet, refer the

to create an app.

To set up webhooks:

  1. Log in to the


  2. Navigate to Applications.

  3. On a created application, click Manage Webhook.

    Manage Webhook
  4. Enter the Webhook URL where you will receive the webhook payload when the event is triggered.

    Edit Webhook
  5. Create a new Secret. This field is optional.

    Handy Tips

    The Secret can be used to validate that the webhook is from Razorpay, thus it should not be exposed publicly. On the UI, the Secret will not be shown after creation. You can leave the Secret blank to leave it unedited.

  6. Select the event(s) you want to activate the webhook for from the list of available events.

  7. Click Save to enable the webhook.

To validate your webhook signature, refer the


Handy Tips

Use the Test mode on the Dashboard to test webhooks.

The 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 retried at progressive intervals of time.

Was this page helpful?