---
title: How to Connect Razorpay to OneSuite
description: "Connect Razorpay so your clients can pay invoices online through Razorpay. Go to **Settings** > **Integrations** > **Payment** and click **Connect** on the Razorpay card. Paste your **Key ID**, **Key Secret** and **Webhook Secret**. Add the OneSuite webhook URL in Razorpay with the `payment_link.paid` event, then click **Save**. **In this guide you'll learn how to:**…"
url: "https://help.onesuite.io/docs/how-to-connect-razorpay-to-onesuite/"
updated: "2026-11-19"
category: Payment Integration
---

# How to Connect Razorpay to OneSuite

Connect Razorpay so your clients can pay invoices online through Razorpay. Go to **Settings** > **Integrations** > **Payment** and click **Connect** on the Razorpay card. Paste your **Key ID**, **Key Secret** and **Webhook Secret**. Add the OneSuite webhook URL in Razorpay with the `payment_link.paid` event, then click **Save**.

**In this guide you'll learn how to:**

- Find your Razorpay Key ID and Key Secret
- Add the webhook in Razorpay
- Connect Razorpay to OneSuite
- Switch Razorpay on for an invoice

## Before you start

- You need a Razorpay account and access to its Dashboard.
- You need access to **Settings**. If you can't see **Integrations**, ask an admin.
- Your Key ID and Key Secret are two codes from Razorpay. They let OneSuite work with your Razorpay account.
- Razorpay shows the Key Secret only once, when you generate the key. Have a place ready to save it.
- A webhook is how Razorpay tells OneSuite about a payment. It is a web address that you add in Razorpay.
- Razorpay has separate Test and Live keys. Test keys are for trying things out. Use Live keys to take real payments.

## What does OneSuite ask for when you connect Razorpay?

| Field | Where to find it | Required |
| --- | --- | --- |
| **Key ID** | In the Razorpay Dashboard, open **Account & Settings**, then **API Keys**. The example in the field starts with rzp_live_. | Yes |
| **Key Secret** | Razorpay shows it once, when you generate the key in its dashboard. | Yes |
| **Webhook Secret** | The secret you type when you create the webhook in Razorpay's dashboard. | Yes |
| **Currency** | Starts as **Indian Rupee (INR)**. OneSuite uses it when an invoice has no currency of its own. | No |

The dialog also shows a **Webhook URL for your Razorpay dashboard** box with a copy button.

## How do I connect Razorpay to OneSuite?

1. Click your name at the bottom of the sidebar, then click **Settings**.
2. Under **Integrations**, click **Payment**.
3. On the **Payment Methods** page, find **Razorpay** and click **Connect**. Keep the dialog open.
4. In Razorpay, open **Account & Settings**, then **API Keys**.
5. Generate your key.
6. Copy the Key ID and the Key Secret.
7. Paste the Key ID into **Key ID** in OneSuite.
8. Paste the Key Secret into **Key Secret** in OneSuite.
9. Add the webhook in Razorpay. The next section shows how.
10. Enter the secret you chose for the webhook in **Webhook Secret**.
11. Check the **Currency**.
12. Click **Save**.

![](https://help.onesuite.io/wp-content/uploads/2026/11/open-payment-settings-in-onesuite-1-925x1024.png)

## How do I add the Razorpay webhook?

Without the webhook, payments may not be recorded on the invoice.

1. In the OneSuite dialog, click the copy button beside **Webhook URL for your Razorpay dashboard**.
2. In Razorpay, open **Account & Settings**, then **Webhooks**.
3. Add a webhook.
4. Paste the OneSuite URL as the webhook URL.
5. Turn on the `payment_link.paid` event.
6. Set a secret for the webhook.
7. Use the same secret in OneSuite's **Webhook Secret** field.

## How do I check it worked?

The Razorpay card on the **Payment Methods** page now says **Connected** instead of **Not connected**. You also see Razorpay marked **Connected** under **Invoices** > **Configure** > **Getting paid** > **Online payments**.

OneSuite switches a connected gateway on for every new invoice. An invoice you created earlier keeps its own choice. To use Razorpay on an older invoice:

1. Open the invoice.
2. Switch Razorpay on in its **Payments** panel.
3. Save the invoice and send it again.

## FAQs

### Which Razorpay event do I turn on?

Turn on `payment_link.paid`. Give the webhook the same secret that you enter in OneSuite's **Webhook Secret** field.

### Can I see my Razorpay Key Secret again?

Razorpay shows the Key Secret only once, when you generate the key. Razorpay's [guide to API keys](https://razorpay.com/docs/payments/dashboard/account-settings/api-keys/) says only the Key ID stays visible afterwards. Save the Key Secret when you generate it.

### Which currency does Razorpay use in OneSuite?

The **Currency** list starts as Indian Rupee (INR). OneSuite applies it to any invoice that has none of its own.

## What to do next

**See every gateway:** Browse all the guides in [Payment Integration](https://help.onesuite.io/docs-category/payment-integration/).

**Record the money that arrives:** Log payments made outside a gateway with [How to Record Invoice Payments](https://help.onesuite.io/docs/how-to-record-invoice-payments/).
