Razorpay Setup

Razorpay lets India-based teams collect INR invoice payments through Payment Links. Customers can pay with the methods enabled in your Razorpay Dashboard, including UPI, Indian credit and debit cards, netbanking, and wallets.

Before You Start

• Use a Razorpay account with live API keys.
• Activate RazorpayX before enabling UPI payouts.
• Keep the Razorpay Key Secret and webhook secret private. Miru stores them encrypted and only shows whether they are configured.

Connect Razorpay

1. Open Settings → Payment Settings → Razorpay.
2. Click Open Razorpay and copy the live Key ID and Key Secret.
3. Paste the Key ID and Key Secret into Miru.
4. Keep Show Razorpay on INR invoices enabled.
5. Click Save Razorpay.

Add Webhooks

In Miru, use Copy setup from the Razorpay webhook box. It copies both endpoint URLs and the events to select.

Payment Links webhook:

https://app.miru.so/webhooks/razorpay/payment_links

Select these events:

• payment_link.paid
• payment_link.partially_paid
• payment_link.cancelled
• payment_link.expired

RazorpayX payouts webhook:

https://app.miru.so/webhooks/razorpay/payouts

Select these events:

• payout.pending
• payout.queued
• payout.initiated
• payout.processed
• payout.updated
• payout.failed
• payout.rejected
• payout.reversed
• payout.cancelled

Use the same webhook secret in Razorpay and Miru. The webhook secret is different from the API Key Secret.

Enable UPI Payouts

1. Activate RazorpayX and payout API access.
2. Add the RazorpayX account number in Miru.
3. Add the verified payout UPI ID.
4. Enable UPI payouts.
5. Keep Queue low-balance payouts enabled if RazorpayX should queue payouts when the source account balance is low.

Verify

1. Create a test INR invoice.
2. Open the client payment link and pay through Razorpay test mode.
3. Confirm the invoice is marked paid after the webhook delivery.
4. If UPI payouts are enabled, confirm the payout row appears on the Payments page and moves to the final RazorpayX status after webhook delivery.