RazorpayX | Subscribe to Webhooks

Webhooks (Web Callback, HTTP Push API or Reverse API) are one of the ways in which one web application can send information to another application in real-time when a specific event happens. Know more about

Webhooks

Set Up and Edit RazorpayX Webhooks

You must first

set up and edit RazorpayX Webhooks

as per your requirement.

Validate and Test Webhooks

Then you must

validate and test webhooks

as a best practice.

Webhook Events and Descriptions

Listed below are the various webhooks events available in RazorpayX. The payload remains the same irrespective of the fund_account_type, that is, a bank account, VPA or card, to which the payout is made.

The table below lists the webhook events available for RazorpayX Payouts. You can enable webhooks for payout statuses listed in

Payout Life Cycle

The table below lists the webhook events available for

RazorpayX transactions

When your webhook secret is set, Razorpay uses it to create a hash signature with each payload. This hash signature is passed with each request under the X-Razorpay-Signature header that you need to validate at your end. Support for validating the signature is provided in all our

language SDKs

Do Not Parse or Cast the Webhook Request Body

While generating the signature at your end, ensure that the webhook body passed as an argument is the raw webhook request body. Do not parse or cast the webhook request body.

X-Razorpay-Signature

The hash signature is calculated using HMAC with SHA256 algorithm, your webhook secret set as the key and the webhook request body as the message.

You can also validate the webhook signature yourself using an

HMAC

as shown below:

key                = webhook_secret
message            = webhook_body // raw webhook request body
received_signature = webhook_signature

expected_signature = hmac('sha256', message, key)

if expected_signature != received_signature
    throw SecurityError
end

Sample Payloads and Events

See

Payout Sample Payloads

For transaction webhook events, check the

Transaction Sample Payloads

Subscribe to Webhooks

Set Up and Edit RazorpayX Webhooks

Validate and Test Webhooks

Webhook Events and Descriptions

Sample Payloads and Events

Related Information