> ## 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.

# Webhooks

> Configure Webhooks to receive alerts about the status of tokens and recurring payments as they occur.

<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>

You can use Razorpay [Webhooks](/docs/webhooks) to receive notifications of all events related to payment states and the token in the recurring payments workflow.

## Check Payment Status Using Webhooks

You can [set up Webhooks](/docs/api/payments/recurring-payments/webhooks#setup-webhooks) to get notifications about the following:

* [Authorisation payment states](#authorisation-payment-states)
* [Registration link states for recurring payments](#registration-link-states)
* [Token states](#token-states)

### Authorisation Payment States

Once the customer has made the Authorisation Payment, it moves through the following states as per the [payment flow](/docs/payments/payment-gateway/how-it-works):

| Status     | Description                                                                                                                                                                                                   | Webhook                                                                                                                                                        |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Created    | Payment is created when a customer enters and submits the payment information.                                                                                                                                | NA                                                                                                                                                             |
| Authorized | Payment is authorized when the customer’s payment details are successfully authenticated by the bank.                                                                                                         | [payment.authorized](/docs/api/payments/recurring-payments/webhooks#payment-authorized)                                                                        |
| Captured   | Indicates that the payment is verified by you.<br />Once a payment is captured you can [retrieve the token](/docs/payments/recurring-payments/create#3-search-for-the-token).                                 | [payment.captured](/docs/api/payments/recurring-payments/webhooks#payment-captured) or [order.paid](/docs/api/payments/recurring-payments/webhooks#order-paid) |
| Failed     | Indicates that the payment has failed.<br />If the payment has failed, you need to [create an authorisation transaction](/docs/api/payments/recurring-payments/cards/create-authorization-transaction) again. | [payment.failed](/docs/api/payments/recurring-payments/webhooks#payment-failed)                                                                                |

### Registration Link States

A registration link moves through the following states during its life cycle:

| Status    | Description                                                                                                                               | Webhook                                                                           |
| --------- | ----------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| Issued    | A registration Link is created and sent to the customer.                                                                                  | NA                                                                                |
| Paid      | Payment is made for the issued registration Link.<br />Once the registration Link is paid, search for Token corresponding to the payment. | [invoice.paid](/docs/api/payments/recurring-payments/webhooks#invoice-paid)       |
| Cancelled | The registration link has been canceled. In such cases, you need to create a registration link again.                                     | NA                                                                                |
| Expired   | The registration link has expired. You can set an expiry timestamp at the time of creation.                                               | [invoice.expired](/docs/api/payments/recurring-payments/webhooks#invoice-expired) |

### Token States

| `token_status` | Description                                                     | Next Step                                                                                               |
| -------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| `initiated`    | Indicates that the bank is processing the mandate registration. | Wait for the [token.confirmed](/docs/api/payments/recurring-payments/webhooks#token-confirmed) webhook. |
| `confirmed`    | Indicates that the bank has completed the mandate registration. | [Create recurring payment](/docs/payments/recurring-payments/create)                                    |
| `rejected`     | Indicates that the mandate registration has failed.             | Create the authorisation transaction again.                                                             |
| `cancelled`    | Indicates that the token has been cancelled.                    | Create the authorisation transaction again if you want to charge the customer.                          |
| `paused`       | Indicates that the token has been paused by your customer.      | The token is inactive. Your customer has paused the token. Ask them to resume the token to charge them. |

## Sample Payloads

Know more about the [Webhook payloads](/docs/api/payments/subscriptions-custom#sample-payloads).

### Related Information

* [Emandate](/docs/payments/recurring-payments/emandate/integrate)
* [Cards](/docs/payments/recurring-payments/cards/integrate)
* [Paper NACH](/docs/payments/recurring-payments/paper-nach/integrate)
* [UPI](/docs/payments/recurring-payments/upi/integrate)