{"id":4498,"date":"2020-08-26T15:26:05","date_gmt":"2020-08-26T09:56:05","guid":{"rendered":"https:\/\/razorpay.com\/blog\/?p=4498"},"modified":"2024-06-25T11:29:23","modified_gmt":"2024-06-25T05:59:23","slug":"how-to-use-razorpay-webhooks","status":"publish","type":"post","link":"https:\/\/razorpay.com\/blog\/how-to-use-razorpay-webhooks\/","title":{"rendered":"Razorpay Payments Webhooks Just Got a Major Upgrade"},"content":{"rendered":"

Have you ever wondered how different applications contact within themselves? Or how they pass<\/span> on information on success or failure of a transaction to keep their users updated or perform an automated action?<\/span> Well, there’s this awesome thing called <\/span>webhooks<\/span><\/i> that enables applications to contact each other.\u00a0<\/span><\/p>\n

[bctt tweet=”A webhook is a feature that allows an application to deliver data to other applications as and when an event happens.” username=””] <\/span><\/p>\n

These events are often asynchronous (happening at a later time). Webhooks are super-efficient as they avoid you to log in to a portal to check for updates or polling an API every few minutes. Once set-up, they run automatically to deliver updates that are important to you to perform an action on your end.<\/span><\/p>\n

At Razorpay, we offer webhooks that allow businesses to build or set up integrations that subscribe to certain events.<\/span>\u00a0<\/i><\/b><\/p>\n

Read more about Razorpay webhooks here<\/a>.\u00a0<\/span><\/p>\n

Use cases of Razorpay webhooks<\/span><\/h2>\n

Before we dive deep and talk about the updates, let’s quickly understand the major use cases of Razorpay webhooks.<\/span><\/p>\n

Capturing delayed authorized payments<\/span><\/h3>\n

You can use Razorpay webhooks<\/a> to get notified about payments that get <\/span>authorized<\/span><\/i> and analyze this data to decide whether or not to capture the payment.<\/span><\/p>\n

Update of the refund status<\/span><\/h3>\n

Razorpay webhooks can help you communicate with your internal teams and customers with ease by notifying them at each step of a refund process.\u00a0<\/span><\/p>\n

Subscription plan updates to the customer\u00a0<\/span><\/h3>\n

[bctt tweet=”With Razorpay webhooks, you can get automated updates when a new subscription is created, an existing subscription is charged or even when a subscription is cancelled by your customers.” username=””]<\/p>\n

We offer webhooks that can address many more use cases on your end. Check out our <\/span>documentation<\/span><\/a> to explore.\u00a0<\/span><\/p>\n

Based on our customers’ feedback, we have made a few major improvements to our webhook set-up interface. Read this blog to know about these updates in detail.\u00a0<\/span><\/p>\n

Latest updates in Razorpay webhooks<\/span><\/h2>\n

Now that you understand webhooks in general and got a snapshot about Razorpay’s webhooks, let’s talk about the latest updates!\u00a0<\/span><\/p>\n

Multiple webhooks\u00a0<\/span><\/h3>\n

You can now set-up a maximum of five webhook URLs in Razorpay’s payments dashboard<\/a>. This feature will help you if you want to receive different events on different callback URLs.\u00a0<\/span><\/p>\n

For example, you might want to receive webhooks for your payments on your user-facing application while webhooks related to Route or Smart collect on an internal-facing application.\u00a0<\/span><\/p>\n

This feature will solve this problem while you use multiple products by Razorpay.\u00a0<\/span><\/p>\n

\"Razorpay<\/p>\n

Custom alert email\u00a0<\/span><\/h3>\n

In the earlier version of Razorpay webhooks, all the webhook updates used to be sent to a registered email ID (the one used to create an account on Razorpay). We noticed that the developers usually do not have access to the registered email ID and hence, often they miss out on some critical webhook notifications. Multiple stakeholders communicated with us the need to change and add the receipts email ID.\u00a0<\/span><\/p>\n

To make the entire process simpler for the team, we are now enabling you to add a custom email address that belongs to the particular team for a specific webhook. With the update, you can now specify an email address on which you would like to receive webhook notifications.\u00a0<\/span><\/p>\n

\"Razorpay<\/p>\n

Delete a webhook\u00a0<\/span><\/h3>\n

There are times when you don’t want to receive webhook events on specific URLs. Until our latest update, permanently deleting a webhook was not possible. However, now you can choose to either temporarily disable it or delete it permanently.\u00a0<\/span><\/p>\n

\"Razorpay<\/p>\n

\"razorpay<\/p>\n

Pro-tip:<\/i><\/b> Be super careful while deleting any webhook. This action is irreversible.\u00a0<\/span><\/p>\n

Other usability enhancements of Razorpay webhooks<\/span><\/h3>\n

Along with the three major updates, there are some minor enhancements:\u00a0<\/span><\/p>\n

    \n
  • Earlier, there was no way to find out if a <\/span>secret<\/span><\/i> was provided during a webhook set-up. However, now you can find this out under <\/span>‘webhook details’<\/span><\/i>. This feature will avoid signature validation errors, that usually occur during integration<\/span><\/li>\n<\/ul>\n

    \"webhooks<\/p>\n

    \"what<\/p>\n

      \n
    • With our updated UI, you can select multiple events at a time. The events are not categorised depending on the entity<\/span><\/li>\n<\/ul>\n

      \"what<\/p>\n

        \n
      • Lastly, you can now identify when was the last time a webhook was updated, either manually by your users. You can also find out if the webhook was auto-disabled by our system due to multiple failures<\/span><\/li>\n<\/ul>\n

        \"razorpay<\/p>\n

        Please note:<\/strong> 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<\/span>.<\/span><\/p>\n

        For now, this is it. But this is not all!\u00a0<\/span><\/p>\n

        In the coming months, we have some interesting features lined up around webhook delivery status and metrics. Our teams are working to simplify and enhance our offering so that you can focus on your business efficiently while we tackle payments for you!<\/span><\/p>\n

        If you have some feedback on our recent UI or would like us to build any other features, feel free to reach out to us here.<\/span>\u00a0<\/span><\/i><\/p>\n


        \n