Attribute revenue with Razorpay

Use this guide to connect Razorpay webhooks to Faurya. The setup has three parts:

1. Pass Faurya attribution IDs into Razorpay checkout notes.
2. Save your Razorpay API credentials in Faurya.
3. Create a Razorpay webhook with the Faurya endpoint, Faurya webhook secret, and supported events.

After the webhook is added and confirmed, Faurya can verify Razorpay events and attribute successful payments back to the original visitor and session.

What Faurya needs from Razorpay

Faurya uses these Razorpay values:

• Razorpay Key ID
• Razorpay Key Secret
• Faurya-generated Razorpay Webhook Secret

The Key ID and Key Secret are saved in Faurya first. Faurya then generates a webhook secret that you must paste into Razorpay while creating the webhook.

Pass Faurya attribution IDs to Razorpay checkout

Before you create a Razorpay order, read the Faurya attribution IDs from cookies and pass them into Razorpay notes. This lets Faurya connect the final payment webhook back to the visitor and session that started checkout.

Use these cookie values:

• faurya_visitor_id
• faurya_session_id

Example with a Next.js server route:

import Razorpay from "razorpay";
import { cookies } from "next/headers";

const razorpay = new Razorpay({
  key_id: process.env.RAZORPAY_KEY_ID!,
  key_secret: process.env.RAZORPAY_KEY_SECRET!,
});

export async function POST() {
  const cookieStore = await cookies();
  const fauryaVisitorId = cookieStore.get("faurya_visitor_id")?.value;
  const fauryaSessionId = cookieStore.get("faurya_session_id")?.value;

  const order = await razorpay.orders.create({
    amount: 99900,
    currency: "INR",
    receipt: `receipt_${Date.now()}`,
    notes: {
      faurya_visitor_id: fauryaVisitorId,
      faurya_session_id: fauryaSessionId,
    },
  });

  return Response.json(order);
}

Step 1: Save Razorpay API credentials in Faurya

In Razorpay, open your dashboard and go to:

1. Account & Settings
2. API Keys
3. Generate Key or copy an existing active key

Copy the Key ID as your Razorpay Key ID.

Copy the Key Secret as your Razorpay Key Secret.

Open your Faurya dashboard and go to your site's Revenue settings. Select Razorpay.

Enter:

• Razorpay Key ID
• Razorpay Key Secret

Then click Save API Credentials.

Step 2: Create the Razorpay webhook

After saving your API credentials, Faurya shows Step 2 with your Razorpay webhook URL and a Faurya-generated webhook secret.

If your Razorpay API credentials were already saved earlier, Faurya will not ask for the Key ID or Key Secret again. Faurya shows the webhook URL and webhook secret directly in Step 2.

The webhook URL looks like this:

https://app.faurya.com/api/v1/webhooks/payment/razorpay/siteId

Copy both values from Faurya:

• Webhook URL
• Razorpay Webhook Secret

In Razorpay, go to:

1. Account & Settings
2. Webhooks
3. Add New Webhook

In the webhook form:

1. Paste the Faurya webhook URL into Webhook URL.
2. Paste the Faurya-generated secret into Secret.
3. Select all events in Razorpay.
4. Set the webhook to active.

Click Create Webhook or Save.

Step 3: Confirm the webhook in Faurya

Go back to Faurya and click I Added the Webhook in Razorpay.

Faurya encrypts and saves the webhook secret, then enables Razorpay for the selected site.

When the connection is ready, the Razorpay card shows:

Razorpay connected: rzp_********

At this point, Razorpay revenue events can be verified and processed by Faurya.

How Razorpay attribution works

When Razorpay sends a webhook to Faurya:

1. Faurya reads the raw webhook body.
2. Faurya verifies x-razorpay-signature using the webhook secret saved for your site.
3. Faurya parses the webhook only after verification succeeds.
4. Faurya checks whether the webhook was already processed.
5. Faurya records successful payment.captured, subscription.charged, and order.paid events as payment revenue.
6. Faurya uses notes.faurya_visitor_id and notes.faurya_session_id to connect revenue to the original visitor and session.

Unsupported but valid Razorpay events are acknowledged so Razorpay does not keep retrying them.

Troubleshooting

Razorpay remains disconnected in Faurya

• Confirm you saved Razorpay Key ID and Key Secret in Faurya first.
• Confirm you clicked I Added the Webhook in Razorpay after creating the webhook.
• Confirm the webhook URL includes the correct Faurya site ID.
• Confirm the webhook is active in Razorpay.

Webhook signature fails

• Confirm the Faurya-generated webhook secret was pasted into Razorpay exactly.
• Confirm Test Mode webhooks use Test Mode keys and Live Mode webhooks use Live Mode keys.
• Generate fresh credentials in Faurya, create a new Razorpay webhook, and paste the new secret if the original secret was lost.

Revenue is not appearing

• Confirm you selected payment.captured, subscription.charged, or order.paid.
• Confirm Razorpay shows successful webhook deliveries.
• Confirm the webhook payload includes an amount and a payment, order, or subscription ID.
• Confirm your checkout passes faurya_visitor_id and faurya_session_id in Razorpay notes.

Duplicate revenue appears

Faurya deduplicates Razorpay webhooks using Razorpay event IDs and payment/order/subscription identifiers. If you also send revenue manually through the Faurya Payments API, avoid recording the same payment twice.