lms/vendor/razorpay/razorpay/documents/webhook.md

Webhook

Create a Webhook

$accountId = "acc_GP4lfNA0iIMn5B";

$api->account->fetch($accountId)->webhooks()->create(array(
    "url" => "https://google.com",
    "alert_email" => "gaurav.kumar@example.com",
    "secret" => "12345",
    "events" => array(
        "payment.authorized",
        "payment.failed",
        "payment.captured",
        "payment.dispute.created",
        "refund.failed",
        "refund.created"
    )
));

Parameters:

Name	Type	Description
accountId*	string	The unique identifier of a sub-merchant account generated by Razorpay.
url*	string	The URL where you receive the webhook payload when an event is triggered. The maximum length is 255 characters.
alert_email	string	This is the email address to which notifications must be sent in case of webhook failure.
secret	string	A secret for the webhook endpoint that is used to validate that the webhook is from Razorpay.
events	string	The required events from the list of Active Events. For example payment.authorized, payment.captured, payment.failed, payment.dispute.created, refund.failed, refund.created and so on.

Response:

{
  "id": "JebiXkKGYwua5L",
  "created_at": 1654605478,
  "updated_at": 1654605478,
  "service": "beta-api-live",
  "owner_id": "JOGUdtKu3dB03d",
  "owner_type": "merchant",
  "context": [],
  "disabled_at": 0,
  "url": "https://google.com",
  "alert_email": "gaurav.kumar@example.com",
  "secret_exists": true,
  "entity": "webhook",
  "active": true,
  "events": [
    "payment.authorized",
    "payment.failed",
    "payment.captured",
    "payment.dispute.created",
    "refund.failed",
    "refund.created"
  ]
}

---

Edit Webhook

$accountId = "acc_GP4lfNA0iIMn5B";

$webhookId = "HK890egfiItP3H";

$api->account->fetch($accountId)->webhooks()->edit($webhookId, array(
    "url" => "https://www.linkedin.com",
    "events" => array(
        "refund.created"
    )
));

Parameters:

Name	Type	Description
accountId*	string	The unique identifier of a sub-merchant account generated by Razorpay.
webhookId*	string	The unique identifier of the webhook whose details are to be updated
url	string	The URL where you receive the webhook payload when an event is triggered. The maximum length is 255 characters.
events	string	The required events from the list of Active Events. For example payment.authorized, payment.captured, payment.failed, payment.dispute.created, refund.failed, refund.created and so on.

Response:

{
  "id": "HK890egfiItP3H",
  "created_at": 1623060358,
  "updated_at": 1623067148,
  "service": "beta-api-test",
  "owner_id": "H3kYHQ635sBwXG",
  "owner_type": "merchant",
  "context": [],
  "disabled_at": 0,
  "url": "https://www.linkedin.com",
  "alert_email": "gaurav.kumar@example.com",
  "secret_exists": true,
  "entity": "webhook",
  "active": true,
  "events": [
    "refund.created"
  ]
}

---

Delete an account

$accountId = "acc_GP4lfNA0iIMn5B";

$webhookId = "HK890egfiItP3H";

$api->account->fetch($accountId)->webhooks()->delete($webhookId);

Parameters:

Name	Type	Description
accountId*	string	The unique identifier of a sub-merchant account that must be deleted.
webhookId*	string	The unique identifier of the webhook whose details are to be updated

Response:

[]

---

Fetch a webhook

$accountId = "acc_GP4lfNA0iIMn5B";

$webhookId = "HK890egfiItP3H";

$api->account->fetch($accountId)->webhooks()->fetch($webhookId);

Parameters:

Name	Type	Description
accountId*	string	The unique identifier of a sub-merchant account generated by Razorpay.
webhookId*	string	The unique identifier of the webhook whose details are to be updated

Response:

{
  "id": "HK890egfiItP3H",
  "created_at": 1623060358,
  "updated_at": 1623060358,
  "owner_id": "H3kYHQ635sBwXG",
  "owner_type": "merchant",
  "context": [],
  "disabled_at": 0,
  "url": "https://en1mwkqo5ioct.x.pipedream.net",
  "alert_email": "gaurav.kumar@example.com",
  "secret_exists": true,
  "entity": "webhook",
  "active": true,
  "events": [
    "payment.authorized",
    "payment.failed",
    "payment.captured",
    "payment.dispute.created",
    "refund.failed",
    "refund.created"
  ]
}

---

Fetch all Webhooks

$accountId = "acc_GP4lfNA0iIMn5B";

$api->account->fetch($accountId)->webhooks()->all();

Parameters:

Name	Type	Description
accountId*	string	The unique identifier of a sub-merchant account generated by Razorpay.
from	integer	Timestamp, in seconds, from when the webhooks are to be fetched.
to	integer	Timestamp, in seconds, till when the webhooks are to be fetched.
count	integer	Number of webhooks to be fetched. The default value is 10 and the maximum value is 100. This can be used for pagination, in combination with skip.
skip	integer	Number of records to be skipped while fetching the webhooks. This can be used for pagination, in combination with count.

Response:

{
  "id": "HK890egfiItP3H",
  "created_at": 1623060358,
  "updated_at": 1623060358,
  "owner_id": "H3kYHQ635sBwXG",
  "owner_type": "merchant",
  "context": [],
  "disabled_at": 0,
  "url": "https://en1mwkqo5ioct.x.pipedream.net",
  "alert_email": "gaurav.kumar@example.com",
  "secret_exists": true,
  "entity": "webhook",
  "active": true,
  "events": [
    "payment.authorized",
    "payment.failed",
    "payment.captured",
    "payment.dispute.created",
    "refund.failed",
    "refund.created"
  ]
}

---

PN: * indicates mandatory fields

For reference click here