API ReferenceIntegrationsKnowledge Base

Webhooks

You can subscribe to webhook events from the Razorpay Dashboard. Know more about Webhooks.

To subscribe to webhook events:

  1. Log into the Razorpay Dashboard.
  2. Navigate to DashboardSettingsWebhooks to subscribe to any of the events mentioned in the following section.

Webhook Events and Payload Samples🔗

Orders🔗

The table below lists the Webhook events available for orders.

Webhook Event

Description

order.paid

Triggered when an order is successfully paid.

Check the sample payloads.

Payments🔗

The table below lists the Webhook events available for payments.

Webhook Event

Description

payment.authorized

Triggered when a payment is authorised.

payment.captured

Triggered when a payment is successfully captured.

payment.failed

Triggered when a payment fails.

Handy Tips

  • The payload for a Webhook is a snapshot of the entity when the event occurred. For example, when a customer makes a payment, its status changes to authorized. It can then immediately move to the captured state.
  • It is possible for the payment to be in the captured state when the payment.authorized Webhook is fired. However, the payload for the payment.authorized event contains details of the events when the payment was authorised, not when it was captured.

Check the sample payloads.

Refunds🔗

The table below lists the webhook events available for refunds.

Webhook Event

Description

refund.created

Triggered when a refund is created.

refund.processed

Triggered when the refund is successfully processed.

refund.failed

Triggered when we are not able to process a refund.

refund.speed_changed

Triggered when the processing speed changes from instant to normal and the requested speed was set to optimum.
This is applicable for Instant Refunds only.

Check the sample payloads.

Disputes🔗

The table below lists the webhook events available for disputes.

Webhook Event

Description

payment.dispute.created

Triggered when a dispute is raised by the customer's issuing bank against a payment.

payment.dispute.won

Triggered when a merchant has won a dispute against a payment.

payment.dispute.lost

Triggered when a merchant has lost a dispute against a payment.

payment.dispute.closed

Triggered when a dispute is closed.

Check the sample payloads.

×