razorpay-webhooks

name	razorpay-webhooks
description	Receive and verify Razorpay webhooks. Use when setting up Razorpay webhook handlers, debugging X-Razorpay-Signature verification, or handling payment events like payment.captured, payment.failed, order.paid, refund.processed, or subscription.charged.
license	MIT
metadata	{"author":"hookdeck","version":"0.1.0","repository":"https://github.com/hookdeck/webhook-skills"}

Razorpay Webhooks

Razorpay is an India-focused payments platform. It notifies your application of payment lifecycle events (orders, payments, refunds, subscriptions, settlements, disputes) by sending an HTTP POST webhook with a JSON payload to your endpoint.

When to Use This Skill

• How do I receive Razorpay webhooks?
• How do I verify the X-Razorpay-Signature header?
• Why is my Razorpay webhook signature verification failing?
• How do I handle payment.captured, order.paid, or subscription.charged events?
• Understanding Razorpay event types and payload structure

Verification (core)

Razorpay signs each webhook with HMAC-SHA256 over the raw request body, hex-encoded, in the X-Razorpay-Signature header. The key is the webhook secret you set in the dashboard (not your API key). Verify the raw body — do not JSON.parse before verifying.