Examples / Payments and billing / Razorpay

Razorpay webhooks

Payments, orders, refunds, settlements and subscriptions for the Indian market.

Events

payment.captured
payment.failed
refund.processed
subscription.charged

Signature

Header X-Razorpay-Signature: HMAC-SHA256 of the raw body with the webhook secret, hex encoded.

✓ A bin checks Razorpay signatures: add the webhook secret under Signature verification (Razorpay).

Check a Razorpay signature with the free tool (use the GitHub preset).

Retries

Razorpay retries for 24 hours with increasing gaps if your server does not return 2xx.

See a retry schedule in the calculator.

Docs

razorpay.com/docs/webhooks/

Checked 2026-10-08. Report a change.

Sample request from Razorpayillustrative, shortened

Content-Typeapplication/jsonX-Razorpay-Signature9a3f…c7d0X-Razorpay-Event-IdQx7mN8pLk2RsTu

{
  "entity": "event",
  "account_id": "acc_Hk3jLm9nPq2rSt",
  "event": "payment.captured",
  "created_at": 1759924800,
  "payload": {
    "payment": {
      "entity": {
        "id": "pay_Qx7mN8pLk2RsTu",
        "amount": 149900,
        "currency": "INR",
        "status": "captured",
        "email": "ravi@example.com",
        "notes": { "order_id": "ORD-20481" }
      }
    }
  }
}

The scheme is the same as GitHub's without the 'sha256=' prefix. Use the GitHub preset in the checker and drop the prefix.

Receive Razorpay webhooks with webhooks.xyz

Create a bin. Paste its URL into Razorpay. Each request shows at once with its headers and body. Add your secret, and each request gets a verified or failed mark. Add your server as a destination, and deliveries retry when it is down. Request an invite.

More in payments and billing: GoCardless, Paddle, PayPal, Square, Stripe.