Introducing PayUmoney Webhooks – Get Callbacks To Your Server

We have been receiving requests from many of our merchants to provide a way to update their systems whenever a payment happen. We listened to the feedback and have launched webhook feature for the same.

What is a webhook?
Webhook is a HTTP callback. The callback is done to a url specified while creating a webhook.
The webhook callbacks are event driven i.e. a callback to a webhook will be done whenever the event associated with the webhook occurs.

Example –
Successful Payment Webhook – The event associated with this webhook is Successful Payment. So whenever a successful payment happens, a callback to the webhook url will be done

How does PayUMoney webhook work?
PayUMoney will be sending the callback messages as HTTP POST Request to the url specified.
Currently we are providing 2 types of webhook events –

  1. When a Payment is successful
  2. When a Payment is failed

So whenever a payment is success/fail for your merchant account, you can receive a callback to your server.In the callback message all the payment details are shared, so you can update your server and process the order as per your business processes.

The callback request format can be viewed here – here.

How do I create a webhook?

    1. To create a webhook, you will need to create a URL at your server which will be able to receive the callback message that will be sent.
    2. Once you have created the url, you can go to your PayUMoney merchant account -> Settings -> My Account ->Webhook


    1. Click on Create New Webhook button
    2. Select the event type for which you want webhook to be added


  1. Enter webhook URL (that you have created in 1). Note that you can’t create a webhook with a url that is not working (receiving callback request)
  2. Optionally, You can also provide a static authorization header & key so that your server identified that the callback message is sent from PayUMoney server
  3. Submit

Upon submission, PayUMoney server will send a dummy callback message to confirm whether the url provided is able to receive POST requests or not.

If your URL isn’t accepting the dummy request sent, then you will be allowed to create that webhook.

If your url is able to receive the request and provides a http response code 200 OK, then the webhook will be successfully created.

Once your webhook is created then from the next time whenever the webhook event will occur, a callback to your webhook url will be sent.

Author: Arun Agrawal