> ## Documentation Index
> Fetch the complete documentation index at: https://docs.commert.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Payment Gateway (Razorpay)

> Connect Razorpay to accept online payments and process refunds, and disconnect it whenever you need to.

Razorpay lets your customers pay online at checkout using cards, UPI, net banking, wallets, and other methods Razorpay supports. Payments settle directly into your own Razorpay account, and you can issue full or partial refunds right from Commert Admin.

This guide explains how to connect Razorpay to your store and how to disconnect it later.

## What you get with Razorpay

* **Online payments at checkout** — shoppers pay instantly instead of choosing an offline method.
* **Payments in your own account** — money settles into your own Razorpay account, under your own Razorpay pricing.
* **Refunds from Commert** — issue full or partial refunds without leaving the admin.
* **Automatic status updates** — orders update on their own when Razorpay confirms a payment, using Razorpay webhooks.

<Note title="A secure connection — no API keys to copy">
  Razorpay connects through **OAuth**. You simply log in to Razorpay and approve access. Commert never asks for (and never sees) your Razorpay password or API keys.
</Note>

## Before you start

* You need a **Razorpay account**. If you don't have one yet, you can create it during the connect flow on Razorpay's website.
* You should be signed in to Commert Admin as a user who can manage store settings.

***

## Connect Razorpay

You can start the connection from either the **Payments** page or the **Integrations** page. Both lead to the same secure Razorpay approval step.

### Where to start

On **Settings → Payments**, the Razorpay section at the top shows the current status. When it isn't connected yet, the status is **Disconnected** and you'll see a **Connect Razorpay** button.

<img src="https://mintcdn.com/commert/bRlQ1srg3UClYlz0/images/user-guide/settings/payments/payment-gateway/payments-page-disconnected.png?fit=max&auto=format&n=bRlQ1srg3UClYlz0&q=85&s=65b33dd7295d60870c4b09066c920156" alt="Razorpay shown as Disconnected on the Payments page" width="1440" height="900" data-path="images/user-guide/settings/payments/payment-gateway/payments-page-disconnected.png" />

You can also go to **Settings → Integrations**, where Razorpay appears in the list with a **Connect** button.

<img src="https://mintcdn.com/commert/bRlQ1srg3UClYlz0/images/user-guide/settings/payments/payment-gateway/integrations-list.png?fit=max&auto=format&n=bRlQ1srg3UClYlz0&q=85&s=ecfeb5523ff458293edce3a76e5f6895" alt="Razorpay in the Integrations list" width="1440" height="900" data-path="images/user-guide/settings/payments/payment-gateway/integrations-list.png" />

### Step 1 — Review the integration (optional)

If you open Razorpay from the **Integrations** page, a panel opens with everything the integration does, a short installation guide, and answers to common questions. Read through it, then click **Connect** at the bottom.

<Tabs>
  <Tab title="Description">
    <img src="https://mintcdn.com/commert/bRlQ1srg3UClYlz0/images/user-guide/settings/payments/payment-gateway/integration-details-description.png?fit=max&auto=format&n=bRlQ1srg3UClYlz0&q=85&s=1050506ef91140bea24c82fc4e652be4" alt="Razorpay integration description" width="1440" height="900" data-path="images/user-guide/settings/payments/payment-gateway/integration-details-description.png" />
  </Tab>

  <Tab title="Installation Guide">
    <img src="https://mintcdn.com/commert/bRlQ1srg3UClYlz0/images/user-guide/settings/payments/payment-gateway/integration-details-installation.png?fit=max&auto=format&n=bRlQ1srg3UClYlz0&q=85&s=16f7c4177ae34c1b198a9da280699023" alt="Razorpay installation guide" width="1440" height="900" data-path="images/user-guide/settings/payments/payment-gateway/integration-details-installation.png" />
  </Tab>

  <Tab title="FAQs">
    <img src="https://mintcdn.com/commert/bRlQ1srg3UClYlz0/images/user-guide/settings/payments/payment-gateway/integration-details-faqs.png?fit=max&auto=format&n=bRlQ1srg3UClYlz0&q=85&s=324fe80db1f0d9e3fd4fba2578922f3d" alt="Razorpay FAQs" width="1440" height="900" data-path="images/user-guide/settings/payments/payment-gateway/integration-details-faqs.png" />
  </Tab>
</Tabs>

### Step 2 — Start the connection

You'll land on the **Connect Razorpay** screen. It reminds you that you'll be taken to Razorpay to approve access, and that Commert never asks for your payment gateway password or API keys.

Click **Connect with Razorpay** to continue.

<img src="https://mintcdn.com/commert/bRlQ1srg3UClYlz0/images/user-guide/settings/payments/payment-gateway/connect-razorpay-screen.png?fit=max&auto=format&n=bRlQ1srg3UClYlz0&q=85&s=d78455bd6f3cc2ccfb1f5cf77913b6a7" alt="Connect Razorpay screen" width="1440" height="900" data-path="images/user-guide/settings/payments/payment-gateway/connect-razorpay-screen.png" />

### Step 3 — Log in on Razorpay

Commert takes you to Razorpay's own website. Log in to your Razorpay account using your email or phone number (or sign up if you're new).

<img src="https://mintcdn.com/commert/bRlQ1srg3UClYlz0/images/user-guide/settings/payments/payment-gateway/razorpay-oauth-login.png?fit=max&auto=format&n=bRlQ1srg3UClYlz0&q=85&s=4d23acf756392164438f030b1687a06f" alt="Razorpay login page" width="1440" height="900" data-path="images/user-guide/settings/payments/payment-gateway/razorpay-oauth-login.png" />

<Note>
  This page belongs to Razorpay, not Commert. You're logging in directly with Razorpay, which is why Commert never needs your Razorpay password.
</Note>

### Step 4 — Approve the access

After you log in, Razorpay shows exactly what Commert is asking permission to do. For the payments integration, Commert requests access to:

* **Create & view payments**
* **Create & view refunds**
* **View disputes & settlements**

Review the list, then click **Authorize** to approve. (You can remove this access from your Razorpay account settings at any time.)

<img src="https://mintcdn.com/commert/bRlQ1srg3UClYlz0/images/user-guide/settings/payments/payment-gateway/razorpay-oauth-confirmation.png?fit=max&auto=format&n=bRlQ1srg3UClYlz0&q=85&s=bdc2a50d757c6aecb5187f8ab4b877e9" alt="Razorpay authorization screen" width="2559" height="1295" data-path="images/user-guide/settings/payments/payment-gateway/razorpay-oauth-confirmation.png" />

### Step 5 — You're connected

After you approve, Razorpay sends you back to Commert and the connection is set up automatically. No details need to be typed in.

Once connected:

* On the **Payments** page, the status changes to **Connected** and the button becomes **Manage Razorpay**.
* On the **Integrations** page, Razorpay shows a green **Connected** badge.

<img src="https://mintcdn.com/commert/bRlQ1srg3UClYlz0/images/user-guide/settings/payments/payment-gateway/payments-page-connected.png?fit=max&auto=format&n=bRlQ1srg3UClYlz0&q=85&s=022098a22f01f2b31f9998eebb831cd9" alt="Razorpay shown as Connected on the Payments page" width="1440" height="900" data-path="images/user-guide/settings/payments/payment-gateway/payments-page-connected.png" />

The **Manage Razorpay** button opens your Razorpay dashboard in a new tab, where you can view payments, settlements, and account details.

***

## Staying connected

You don't need to do anything to keep Razorpay working — Commert refreshes the connection automatically in the background.

Occasionally you may be asked to **reconnect** (for example, if the connection is nearing the end of its lifetime, or if access was removed on Razorpay's side). If that happens, just run the connect steps above again.

***

## Disconnect Razorpay

Disconnecting stops Commert from using your Razorpay account. Customers will no longer be able to pay online through Razorpay until you connect it again.

To disconnect:

1. Go to **Settings → Integrations**.
2. Find Razorpay in the list — it shows a green **Connected** badge and a **Disconnect** button.
3. Click **Disconnect**.

<img src="https://mintcdn.com/commert/bRlQ1srg3UClYlz0/images/user-guide/settings/payments/payment-gateway/integrations-list-connected.png?fit=max&auto=format&n=bRlQ1srg3UClYlz0&q=85&s=3b58ec5656a03571dcdf4b11b336c3bc" alt="Razorpay connected with a Disconnect button" width="1440" height="900" data-path="images/user-guide/settings/payments/payment-gateway/integrations-list-connected.png" />

4. A confirmation appears. Click **Disconnect** again to confirm.

<img src="https://mintcdn.com/commert/bRlQ1srg3UClYlz0/images/user-guide/settings/payments/payment-gateway/disconnect-confirmation.png?fit=max&auto=format&n=bRlQ1srg3UClYlz0&q=85&s=d337622f2d8c854142dfd7d772cf5155" alt="Disconnect confirmation dialog" width="1440" height="900" data-path="images/user-guide/settings/payments/payment-gateway/disconnect-confirmation.png" />

Once confirmed, the connection is removed immediately. Razorpay's status returns to **Disconnected**, and the stored access is revoked with Razorpay.

<Note>
  You can also remove Commert's access from your **Razorpay dashboard** (by revoking the connected app). Either way, the connection stops working right away, and Commert updates the status to Disconnected automatically.
</Note>

<Note type="warning">
  Disconnecting can't be undone. To use Razorpay again afterwards, connect it fresh using the steps above.
</Note>

***

## Connection statuses

The Payments and Integrations pages show a simple status so you always know where things stand:

* **Connected** — Razorpay is linked and ready to accept online payments.
* **Disconnected** — Razorpay isn't linked. Customers can't pay online through Razorpay until you connect it.

***

## Frequently asked questions

**Do I need to share my Razorpay API keys?**
No. The connection uses Razorpay OAuth — you approve access from your own Razorpay account and can revoke it at any time.

**Which Razorpay account is charged the platform fees?**
Payments settle directly into your own Razorpay account, under your own Razorpay pricing.

**How do I disconnect?**
Use the **Disconnect** action on the Integrations page, or revoke the app from your Razorpay dashboard. Either way the connection stops working immediately.

***

## Next steps

* [Manual Payment Method](./manual-payment-method) — add, edit, or delete offline options like Cash on Delivery or bank transfer.
* [Payments Overview](/en/settings/payments) — see how online and manual payment options work together at checkout.
