Skip to main content

​
Overview

RabbitPay relies on Razorpay Webhooks to receive real-time payment notifications. These notifications allow RabbitPay to automatically synchronize payment statuses, orders, subscriptions, and QR transactions without requiring manual intervention. Whenever an event occurs on Razorpay — such as a payment being captured, an order being updated, a subscription renewing, or a QR payment being received — Razorpay sends a signed HTTP request to the RabbitPay webhook endpoint. RabbitPay verifies the signature and updates the corresponding merchant record instantly.
Configuring the webhook correctly is mandatory before merchants can start accepting payments through RabbitPay. Without a valid webhook, payment and order statuses will not sync.

​
Prerequisites

Before proceeding, ensure the following:
  • An active Razorpay Business Account.
  • Administrator access to the Razorpay Dashboard.
  • Razorpay API Keys have already been generated. See Generate Razorpay API Token.
  • RabbitPay onboarding has been initiated.

​
Step 1: Navigate to Webhooks

From the Razorpay Dashboard, follow this path to reach the Webhooks configuration screen:
Navigation
1

Open Account & Settings

Log in to the Razorpay Dashboard and click Account & Settings in the left sidebar.
2

Open Website and App Settings

Scroll to the Website and app settings card in the Account and product settings section.
3

Click Webhooks

Click the Webhooks link inside the Website and app settings card to open the Webhooks page.
Razorpay Account & Settings page highlighting the Website and app settings card

Figure 1: Navigate to Account & Settings → Website and App Settings → Webhooks.

​
Step 2: Create a New Webhook

On the Webhooks page:
  1. Click + Add New Webhook in the top-right corner.
  2. The Webhook Setup dialog will open.
A webhook endpoint must be created so Razorpay can securely send event notifications to RabbitPay. Each webhook maps a specific URL to a set of events that Razorpay will deliver.
Razorpay Webhooks page with + Add New Webhook button highlighted

Figure 2: Click + Add New Webhook to create a new webhook configuration.

​
Step 3: Configure the Webhook

Complete the Webhook Setup form using the values below.

​
Webhook URL

Copy and paste the following URL into the Webhook URL field.
Webhook URL
This endpoint is used by RabbitPay to receive all webhook events from Razorpay. It is served over HTTPS and validates every incoming request.

​
Secret

Enter the following value into the Secret field.
Webhook Secret
The webhook secret is used to verify that every webhook request originates from Razorpay. RabbitPay uses this secret to compute an HMAC signature and compare it against the X-Razorpay-Signature header on every incoming request.

​
Alert Email

This field is optional. Merchants may enter an email address if they wish to receive notifications whenever webhook delivery fails. This is useful for monitoring the health of the webhook integration.

​
Active Events

Under Active Events, select all events from the following categories:
  • Payment Events
  • Order Events
  • Subscription Events
  • QR Events
Expand each category and ensure every available event within these four categories is selected.
Do not deselect any events within these four categories. RabbitPay requires every event so that payment creation, payment capture, order updates, subscription activities, and QR payment events are synchronized correctly. Missing events will cause order or payment desynchronization on the merchant dashboard.
Includes events such as payment.authorized, payment.failed, payment.captured, payment.dispute.created, payment.dispute.won, payment.dispute.lost, payment.dispute.closed, and all other events listed under Payment Events. Select every event in this category.
Includes events such as order.paid and all other events listed under Order Events. Select every event in this category.
Includes events such as subscription.activated, subscription.charged, subscription.completed, subscription.updated, subscription.pending, subscription.halted, subscription.cancelled, subscription.paused, subscription.resumed, and every other event listed under Subscription Events. Select every event in this category.
Includes events such as qr_code.created, qr_code.closed, qr_code.credited, and every other event listed under QR Events. Select every event in this category.
Razorpay Webhook Setup dialog showing Webhook URL, Secret, Alert Email, and Active Events fields

Figure 3: Configure the Webhook URL, Secret, and select all events under Payment Events, Order Events, Subscription Events, and QR Events before creating the webhook.

​
Step 4: Create the Webhook

After verifying the configuration:
1

Verify the Webhook URL

Confirm the URL is exactly https://dashboard.rabbitpay.ai/api/razorpay/webhook with no trailing spaces.
2

Verify the Secret

Confirm the secret matches rabbit@321 character-for-character.
3

Verify Event Selection

Confirm that all events under Payment Events, Order Events, Subscription Events, and QR Events are selected.
4

Click Create Webhook

Click the Create Webhook button at the bottom-right of the dialog.
Once created, Razorpay will begin sending webhook events to RabbitPay immediately.

​
Verification

The webhook configuration is complete when:
  • The webhook appears in the Webhooks list on the Razorpay Dashboard.
  • The status is Enabled.
  • The RabbitPay webhook URL (https://dashboard.rabbitpay.ai/api/razorpay/webhook) is displayed.
  • The configured webhook shows the selected events count matching the total across the four required categories.
  • No validation errors are displayed.
After the webhook is created, RabbitPay automatically detects the incoming events and marks the merchant’s Razorpay integration as Active. If the merchant dashboard does not reflect this within a few minutes, verify that the URL and secret were entered exactly as documented above.

​
Next Steps

Generate Razorpay QR Code

Configure the Razorpay QR code so RabbitPay can accept UPI QR payments.

Shopify Integration

Connect your Shopify store to RabbitPay and enable 1-Click Checkout.