> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay-881012b3.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Subscribe to Webhooks

> Use webhooks to get notified about Transaction events and Sub-Merchant Onboarding events.

<div style={{display:"flex",flexWrap:"wrap",alignItems:"center",gap:"0.35rem 0.9rem",border:"1px solid rgba(128,128,128,0.28)",borderRadius:"0.5rem",padding:"0.45rem 0.75rem",margin:"0 0 1.25rem",fontSize:"0.875rem"}}>
  <span style={{fontWeight:600}}>Available in</span>
  <span>🇮🇳 India</span>
</div>

Subscribe to webhook events relevant to partners to receive notifications (in the form of a webhook payload) when these events occur.

Watch this video to see how you can subscribe to Partner Webhooks.

<video width="650" controls>
  <source src="https://razorpay.com/docs/build/browser/assets/images/partners-partner_webhooks.mp4" type="video/mp4" />

  partner webhooks
</video>

To subscribe to webhook events:

1. Log in to the Dashboard.
2. Navigate to **Partner's Dashboard** → **Settings** → **Webhooks** to subscribe to any of the events mentioned in the following section.
3. Click on **Manage** settings.
4. In the **Webhook Setup** pop-up page:
   1. Enter the **URL** where you want to receive the webhook payload when an event is triggered. We recommended using an HTTPS URL.
   2. Enter a **Secret** for the webhook endpoint. The secret is used to validate that the webhook is from Razorpay.
   3. In the **Alert Email** field, enter the email address to which the notifications should be sent in case of webhook failure.
   4. Select the required events from the list of **Active Events**.
5. Click **Create Webhook**.

### Webhook Events and Descriptions

There are 2 types of events:<br />

1. **Transaction Events**: These are events related to payment transactions performed by the sub-merchants. The partner at a sub-merchant level can configure these events.
2. **Sub-Merchant Onboarding Events**: These events are related to the onboarding status of the sub-merchant. This is subscribed at the partner level and not configurable at the sub-merchant level. Subscribing to this event will enable the partner to get the onboarding status of all sub-merchants.

Know more about [Aggregators Webhooks](/docs/webhooks/partners).

#### Transaction Events

| Event Category       | Event Name                         | Description                                                      |
| -------------------- | ---------------------------------- | ---------------------------------------------------------------- |
| Payment Events       | payment.authorized                 | Triggered when a payment is authorized.                          |
| Payment Events       | payment.failed                     | Triggered when a payment fails.                                  |
| Payment Events       | payment.captured                   | Triggered when a payment is captured.                            |
| Payment Events       | payment.dispute.created            | Triggered when a dispute for a payment is created.               |
| Payment Events       | payment.dispute.won                | Triggered when a dispute for a payment is won.                   |
| Payment Events       | payment.dispute.lost               | Triggered when a dispute for a payment is lost.                  |
| Payment Events       | payment.dispute.closed             | Triggered when a dispute for a payment is closed.                |
| Payment Events       | payment.downtime.started           | Triggered when the downtime for a payment starts.                |
| Payment Events       | payment.downtime.resolved          | Triggered when the downtime for a payment is resolved.           |
| Order Events         | order.paid                         | Triggered when a payment is successfully made against an  order. |
| Invoice Events       | invoice.paid                       | Triggered when an invoice is successfully paid.                  |
| Invoice Events       | invoice.partially\_paid            | Triggered when a partial payment is made for an invoice.         |
| Invoice Events       | invoice.expired                    | Triggered when an invoice expires.                               |
| Fund\_account Events | fund\_account.validation.completed | Triggered when the validation for a fund account is completed.   |
| Fund\_account Events | fund\_account.validation.failed    | Triggered when the validation for a fund account fails.          |
| Refund Events        | refund.speed\_changed              | Triggered when the speed of a refund is changed.                 |
| Refund Events        | refund.processed                   | Triggered when a refund is processed.                            |
| Refund Events        | refund.failed                      | Triggered when the a refund fails.                               |
| Refund Events        | refund.created                     | Triggered when the a refund is created.                          |
| Payment\_link Events | payment\_link.paid                 | Triggered when a Payment Link is paid.                           |
| Payment\_link Events | payment\_link.partially\_paid      | Triggered when a partial payment is made on a Payment Link.      |
| Payment\_link Events | payment\_link.expired              | Triggered when a Payment Link expires.                           |
| Payment\_link Events | payment\_link.cancelled            | Triggered when a Payment Link is cancelled by you.               |

Check the [sample payloads](/docs/webhooks) for the above-mentioned webhook events.

#### Sub-Merchant Onboarding Events

| Event Category    | Event Name                                    | Description                                                                       |
| ----------------- | --------------------------------------------- | --------------------------------------------------------------------------------- |
| PG Product Status | product.payment\_gateway.under\_review        | Triggered when the status for a Payment Gateway product is `under_review`.        |
| PG Product Status | product.payment\_gateway.needs\_clarification | Triggered when the status for a Payment Gateway product is `needs clarification`. |
| PG Product Status | product.payment\_gateway.activated            | Triggered when the status for a Payment Gateway product is `activated`.           |
| PG Product Status | product.payment\_gateway.rejected             | Triggered when the status for a Payment Gateway product is `rejected`.            |
| PL Product Status | product.payment\_link.under\_review           | Triggered when the status for a Payment Link product is `under_review`.           |
| PL Product Status | product.payment\_link.needs\_clarification    | Triggered when the status for a Payment Link product is `needs clarification`.    |
| PL Product Status | product.payment\_link.activated               | Triggered when the status for a Payment Link product is `activated`.              |
| PL Product Status | product.payment\_link.rejected                | Triggered when the status for a Payment Link product is `rejected`.               |
| Account           | account.suspended                             | Triggered when the Partner's account gets suspended.                              |

You can check the events and sample payloads of [Sub-Merchant Onboarding Events](/docs/webhooks/partners). Know more about [Webhook APIs](/docs/api/partners/webhooks).

### Related Information

* [Sub-Merchant Onboarding APIs](/docs/partners/aggregators/onboarding-api)
* [Sub-Merchant Onboarding APIs Flow](/docs/partners/aggregators/onboarding-api/workflow)
* [List of Partner APIs](/docs/partners/aggregators/onboarding-api)
* [Appendix](/docs/partners/aggregators/onboarding-api/appendix)
