Ecommerce Development

Razorpay on Shopify: The Complete Setup Guide for Indian Stores (2026)

Razorpay on Shopify: The Complete Setup Guide for Indian Stores (2026)

08 min read

If you're building a Shopify store for the Indian market, your payment gateway decision matters more than most founders realise. Selecting the correct payment infrastructure is not merely a technical checkbox; it serves as the foundational architecture for your store's ability to capture, process, and reconcile revenue in a highly competitive digital landscape. Razorpay is the most commonly used payment gateway among Indian D2C brands on Shopify and for good reason. It supports UPI, cards, netbanking, EMI, wallets, and COD flows, all within a single integration.

By consolidating these diverse payment streams into one robust interface, Razorpay provides the necessary technical stability for high-growth stores to scale without managing fragmented vendor relationships. This guide walks you through the complete Razorpay–Shopify setup, from account activation to going live, with a pre-launch checklist you can actually use. We will ensure that you have configured your backend systems to handle the complexities of Indian financial regulations while maintaining a seamless, frictionless path to purchase for your end consumers.

Why Razorpay Is the Default Choice for Indian Shopify Stores

Indian shoppers don't pay the way Western shoppers do. The consumption behavior in the Indian market is uniquely characterized by a high preference for digital convenience and real-time payment settlement, making the traditional credit-card-only model insufficient. UPI dominates the transaction landscape, and modern consumers have developed a strong reliance on it for both small-ticket impulse buys and larger planned purchases. EMI on cards and buy-now-pay-later (BNPL) options are now standard expectations for consumers looking to optimize their personal cash flow, while COD remains uniquely relevant as a trust-building mechanism in Tier 2 and Tier 3 cities. A payment gateway that doesn't support all of this creates friction — and friction costs conversions. Razorpay covers this stack in a single integration, effectively bridging the gap between legacy payment rails and the new-age digital demands of Indian consumers. It connects directly with Shopify via a native app, supports all major Indian payment methods, and settles in INR to Indian bank accounts without the complexity of cross-border routing. The tradeoff worth knowing upfront: Razorpay requires a registered Indian business entity (sole proprietorship, partnership, LLP, or private limited company) and a completed KYC process before you can go live. There is no shortcut here. Plan your onboarding timeline accordingly, as the regulatory compliance required by the Reserve Bank of India necessitates a rigorous identity and business verification process that acts as a mandatory buffer for every merchant entering the space.

What You Need Before You Start

Getting the integration right starts with having the right things in place before you touch your Shopify admin, as technical configuration is impossible without the necessary credentialing. On the Razorpay side:

  • Business Account — A Razorpay business account (sign up at razorpay.com) is the core operational requirement.

  • KYC Completion — This includes your GST certificate or business PAN, valid bank account details, and government-issued identity proof for the business owner.

  • Account Activation — Ensure your Razorpay account is fully activated, which requires successful KYC approval and can take 1–3 business days.

  • API Credentials — You must have your unique Razorpay API Key ID and API Key Secret ready, which are accessible only from the official Razorpay Dashboard.

    On the Shopify side:

  • Active Store — An active Shopify store running on any subscription plan.

  • Admin Permissions — Complete Shopify admin access with administrative privileges to manage payment provider configurations.

  • Currency Settings — Your store's base currency must be set to INR to ensure accurate transaction processing and reconciliation.

  • Business Identity — A confirmed business address, registered contact details, and tax information properly saved in your Shopify settings.

    Getting both sides ready before you begin prevents the most common setup delays, such as mismatched business profiles or authentication failures that occur when credentials do not align between your merchant account and your digital storefront.

Step-by-Step: Setting Up Razorpay on Shopify
Step 1: Install the Razorpay App from the Shopify App Store

Go to the Shopify App Store and search for "Razorpay". Install the official Razorpay app, which creates the secure bridge between your Shopify store and Razorpay's specialized payment infrastructure. Once installed, the app will prompt you to connect your Razorpay account. Do not skip this step or use test credentials for a live store, as doing so will cause catastrophic failures in your order processing and customer trust during your critical launch phase.

Step 2: Connect Your Razorpay Account

Inside the Razorpay app dashboard within Shopify, you'll be asked to enter your API Key ID and API Key Secret. To find these, log in to your Razorpay Dashboard, navigate to Settings → API Keys, and generate a key pair specifically for live mode. Copy both values carefully and paste them into the Shopify app interface. Keep your Key Secret strictly private — treat it like a password to prevent unauthorized access to your merchant environment. One common mistake here: using Test Mode keys for a live store. Your store will appear to accept payments but none will actually process, leading to abandoned carts and confused customers. Always confirm you're using Live Mode keys before launch.

Step 3: Enable Razorpay as a Payment Provider in Shopify

In your Shopify admin, go to Settings → Payments. Scroll to the Third-Party Payment Providers section and select Razorpay if it's not already showing as active. If you see Shopify Payments listed as your active gateway (which is not typically available for Indian stores), you'll need to deactivate it before enabling a third-party provider to avoid conflicting payment logic within your checkout sequence.

Step 4: Configure Your Payment Methods Within Razorpay

Inside the Razorpay Dashboard, go to Settings → Payment Methods. Here you control exactly which methods appear at your checkout — UPI, credit and debit cards, netbanking, digital wallets, EMI, and various BNPL services. Enable the methods most relevant to your specific customer demographic to ensure a personalized checkout flow. If you're targeting Tier 1 metros, UPI and cards should be your primary focus for speed and success rates. If you have significant Tier 2/3 traffic, enable netbanking and mobile wallets. EMI is a high-value tool worth enabling if your average order value exceeds ₹3,000, as it significantly lowers the barrier to entry for expensive products.

Step 5: Set Up Your Checkout Appearance

Razorpay gives you granular control over the checkout experience to ensure it aligns with your brand guidelines. Within the Razorpay Dashboard, under Checkout Settings, you can add your company logo to the Razorpay checkout modal, set a preferred checkout language to match your audience, and toggle specific payment categories. This is also where you configure whether customers interact with a Razorpay-hosted checkout page or an embedded checkout. The default modal overlay is highly recommended because it provides a consistent, secure environment that maintains high trust metrics on both mobile and desktop devices.

Step 6: Test the Integration Before Going Live

Always run a comprehensive test transaction before publishing your store or driving paid traffic to it. Use Razorpay's test mode to simulate a payment end-to-end to verify that your data pipelines are functional. To do this: switch your API keys to Test Mode keys temporarily, place a dummy test order on your storefront, and verify that the transaction successfully clears in the Shopify Orders dashboard. Finally, confirm the order status updates to "Paid" in your Razorpay Dashboard. Once confirmed, switch back to your permanent Live Mode keys to ensure your store is ready for actual commerce.

Step 7: Configure Settlement and Notifications

In your Razorpay Dashboard, go to Settings → Settlements. Confirm your settlement schedule; T+2 is standard for most accounts, but high-volume merchants may qualify for faster cycles. Ensure your official bank account is verified to avoid settlement delays. Additionally, set up payment notifications under Settings → Notifications so your operations team receives immediate alerts for successful payments, customer refunds, and payment failures.

The Razorpay–Shopify Integration Readiness Matrix

Use this matrix before going live to confirm your setup is complete. This is a structured pre-launch check, not a general checklist — each item maps to a specific failure point seen in live integrations.

  • Account Layer — Razorpay KYC completed and account activated: Yes / No

  • Account Layer — Live Mode API keys generated and saved securely: Yes / No

  • Account Layer — Bank account verified in Razorpay settlements: Yes / No

  • Shopify Configuration Layer — Shopify store currency set to INR: Yes / No

  • Shopify Configuration Layer — Razorpay app installed from official App Store listing: Yes / No

  • Shopify Configuration Layer — Live Mode API keys entered in Shopify app (not test keys): Yes / No

  • Shopify Configuration Layer — Razorpay enabled as active payment provider in Settings → Payments: Yes / No

  • Checkout Experience Layer — Payment methods configured based on target audience: Yes / No

  • Checkout Experience Layer — Brand logo uploaded to Razorpay checkout: Yes / No

  • Checkout Experience Layer — Checkout tested end-to-end in test mode: Yes / No

  • Post-Payment Layer — Settlement schedule confirmed: Yes / No

  • Post-Payment Layer — Email/SMS notifications enabled in Razorpay: Yes / No

  • Post-Payment Layer — Shopify order status confirmed to update on payment: Yes / No

  • Post-Payment Layer — Refund flow tested at least once: Yes / No

    Every "No" on this matrix before launch is a risk. Address them sequentially before your store goes live to minimize operational downtime.

Common Mistakes and Trade-Offs
Using test API keys on a live store

This is the most frequent setup error, often caused by rushing the launch process. Payments appear to process within the checkout modal, but the transactions are never captured or recorded in your production environment. Always double-check which mode your API keys belong to before going live, and perform a live transaction if you have any doubt about the key configuration.

Skipping the refund flow test

Most teams test the payment flow meticulously but completely ignore the refund flow. If a customer requests a refund and your team is unsure how to initiate it through the Razorpay Dashboard or Shopify, you create a massive support bottleneck on day one. Test the full refund lifecycle before you launch to ensure your operational processes are airtight.

Not configuring payment methods for your actual audience

The default Razorpay setup enables almost all methods, which can lead to a cluttered checkout experience. While broad support is beneficial, it is not optimized for every niche. If your audience skews younger and is based in metro areas, UPI and cards should be your prominent checkout features. If you sell to a broader demographic, ensure netbanking and mobile wallets are enabled and visually accessible.

COD as a separate workflow

Razorpay does not natively handle COD through the standard Shopify integration, a common point of confusion for new merchants. If COD is vital to your business, you'll need to use a separate COD management app or a third-party logistics partner that manages cash collection. Do not assume Razorpay covers this automatically; it is a separate operational workflow that requires distinct software handling.

Settlement timing expectations

Razorpay's standard settlement is T+2, meaning you receive your funds two business days after the transaction is completed. If your store has high daily volumes and tight inventory margins, factor this into your cash flow planning. Instant settlements are available on Razorpay for an additional fee — this is a strategy worth evaluating if your working capital is a primary growth constraint.

If you're building a Shopify store for the Indian market, your payment gateway decision matters more than most founders realise. Selecting the correct payment infrastructure is not merely a technical checkbox; it serves as the foundational architecture for your store's ability to capture, process, and reconcile revenue in a highly competitive digital landscape. Razorpay is the most commonly used payment gateway among Indian D2C brands on Shopify and for good reason. It supports UPI, cards, netbanking, EMI, wallets, and COD flows, all within a single integration.

By consolidating these diverse payment streams into one robust interface, Razorpay provides the necessary technical stability for high-growth stores to scale without managing fragmented vendor relationships. This guide walks you through the complete Razorpay–Shopify setup, from account activation to going live, with a pre-launch checklist you can actually use. We will ensure that you have configured your backend systems to handle the complexities of Indian financial regulations while maintaining a seamless, frictionless path to purchase for your end consumers.

Why Razorpay Is the Default Choice for Indian Shopify Stores

Indian shoppers don't pay the way Western shoppers do. The consumption behavior in the Indian market is uniquely characterized by a high preference for digital convenience and real-time payment settlement, making the traditional credit-card-only model insufficient. UPI dominates the transaction landscape, and modern consumers have developed a strong reliance on it for both small-ticket impulse buys and larger planned purchases. EMI on cards and buy-now-pay-later (BNPL) options are now standard expectations for consumers looking to optimize their personal cash flow, while COD remains uniquely relevant as a trust-building mechanism in Tier 2 and Tier 3 cities. A payment gateway that doesn't support all of this creates friction — and friction costs conversions. Razorpay covers this stack in a single integration, effectively bridging the gap between legacy payment rails and the new-age digital demands of Indian consumers. It connects directly with Shopify via a native app, supports all major Indian payment methods, and settles in INR to Indian bank accounts without the complexity of cross-border routing. The tradeoff worth knowing upfront: Razorpay requires a registered Indian business entity (sole proprietorship, partnership, LLP, or private limited company) and a completed KYC process before you can go live. There is no shortcut here. Plan your onboarding timeline accordingly, as the regulatory compliance required by the Reserve Bank of India necessitates a rigorous identity and business verification process that acts as a mandatory buffer for every merchant entering the space.

What You Need Before You Start

Getting the integration right starts with having the right things in place before you touch your Shopify admin, as technical configuration is impossible without the necessary credentialing. On the Razorpay side:

  • Business Account — A Razorpay business account (sign up at razorpay.com) is the core operational requirement.

  • KYC Completion — This includes your GST certificate or business PAN, valid bank account details, and government-issued identity proof for the business owner.

  • Account Activation — Ensure your Razorpay account is fully activated, which requires successful KYC approval and can take 1–3 business days.

  • API Credentials — You must have your unique Razorpay API Key ID and API Key Secret ready, which are accessible only from the official Razorpay Dashboard.

    On the Shopify side:

  • Active Store — An active Shopify store running on any subscription plan.

  • Admin Permissions — Complete Shopify admin access with administrative privileges to manage payment provider configurations.

  • Currency Settings — Your store's base currency must be set to INR to ensure accurate transaction processing and reconciliation.

  • Business Identity — A confirmed business address, registered contact details, and tax information properly saved in your Shopify settings.

    Getting both sides ready before you begin prevents the most common setup delays, such as mismatched business profiles or authentication failures that occur when credentials do not align between your merchant account and your digital storefront.

Step-by-Step: Setting Up Razorpay on Shopify
Step 1: Install the Razorpay App from the Shopify App Store

Go to the Shopify App Store and search for "Razorpay". Install the official Razorpay app, which creates the secure bridge between your Shopify store and Razorpay's specialized payment infrastructure. Once installed, the app will prompt you to connect your Razorpay account. Do not skip this step or use test credentials for a live store, as doing so will cause catastrophic failures in your order processing and customer trust during your critical launch phase.

Step 2: Connect Your Razorpay Account

Inside the Razorpay app dashboard within Shopify, you'll be asked to enter your API Key ID and API Key Secret. To find these, log in to your Razorpay Dashboard, navigate to Settings → API Keys, and generate a key pair specifically for live mode. Copy both values carefully and paste them into the Shopify app interface. Keep your Key Secret strictly private — treat it like a password to prevent unauthorized access to your merchant environment. One common mistake here: using Test Mode keys for a live store. Your store will appear to accept payments but none will actually process, leading to abandoned carts and confused customers. Always confirm you're using Live Mode keys before launch.

Step 3: Enable Razorpay as a Payment Provider in Shopify

In your Shopify admin, go to Settings → Payments. Scroll to the Third-Party Payment Providers section and select Razorpay if it's not already showing as active. If you see Shopify Payments listed as your active gateway (which is not typically available for Indian stores), you'll need to deactivate it before enabling a third-party provider to avoid conflicting payment logic within your checkout sequence.

Step 4: Configure Your Payment Methods Within Razorpay

Inside the Razorpay Dashboard, go to Settings → Payment Methods. Here you control exactly which methods appear at your checkout — UPI, credit and debit cards, netbanking, digital wallets, EMI, and various BNPL services. Enable the methods most relevant to your specific customer demographic to ensure a personalized checkout flow. If you're targeting Tier 1 metros, UPI and cards should be your primary focus for speed and success rates. If you have significant Tier 2/3 traffic, enable netbanking and mobile wallets. EMI is a high-value tool worth enabling if your average order value exceeds ₹3,000, as it significantly lowers the barrier to entry for expensive products.

Step 5: Set Up Your Checkout Appearance

Razorpay gives you granular control over the checkout experience to ensure it aligns with your brand guidelines. Within the Razorpay Dashboard, under Checkout Settings, you can add your company logo to the Razorpay checkout modal, set a preferred checkout language to match your audience, and toggle specific payment categories. This is also where you configure whether customers interact with a Razorpay-hosted checkout page or an embedded checkout. The default modal overlay is highly recommended because it provides a consistent, secure environment that maintains high trust metrics on both mobile and desktop devices.

Step 6: Test the Integration Before Going Live

Always run a comprehensive test transaction before publishing your store or driving paid traffic to it. Use Razorpay's test mode to simulate a payment end-to-end to verify that your data pipelines are functional. To do this: switch your API keys to Test Mode keys temporarily, place a dummy test order on your storefront, and verify that the transaction successfully clears in the Shopify Orders dashboard. Finally, confirm the order status updates to "Paid" in your Razorpay Dashboard. Once confirmed, switch back to your permanent Live Mode keys to ensure your store is ready for actual commerce.

Step 7: Configure Settlement and Notifications

In your Razorpay Dashboard, go to Settings → Settlements. Confirm your settlement schedule; T+2 is standard for most accounts, but high-volume merchants may qualify for faster cycles. Ensure your official bank account is verified to avoid settlement delays. Additionally, set up payment notifications under Settings → Notifications so your operations team receives immediate alerts for successful payments, customer refunds, and payment failures.

The Razorpay–Shopify Integration Readiness Matrix

Use this matrix before going live to confirm your setup is complete. This is a structured pre-launch check, not a general checklist — each item maps to a specific failure point seen in live integrations.

  • Account Layer — Razorpay KYC completed and account activated: Yes / No

  • Account Layer — Live Mode API keys generated and saved securely: Yes / No

  • Account Layer — Bank account verified in Razorpay settlements: Yes / No

  • Shopify Configuration Layer — Shopify store currency set to INR: Yes / No

  • Shopify Configuration Layer — Razorpay app installed from official App Store listing: Yes / No

  • Shopify Configuration Layer — Live Mode API keys entered in Shopify app (not test keys): Yes / No

  • Shopify Configuration Layer — Razorpay enabled as active payment provider in Settings → Payments: Yes / No

  • Checkout Experience Layer — Payment methods configured based on target audience: Yes / No

  • Checkout Experience Layer — Brand logo uploaded to Razorpay checkout: Yes / No

  • Checkout Experience Layer — Checkout tested end-to-end in test mode: Yes / No

  • Post-Payment Layer — Settlement schedule confirmed: Yes / No

  • Post-Payment Layer — Email/SMS notifications enabled in Razorpay: Yes / No

  • Post-Payment Layer — Shopify order status confirmed to update on payment: Yes / No

  • Post-Payment Layer — Refund flow tested at least once: Yes / No

    Every "No" on this matrix before launch is a risk. Address them sequentially before your store goes live to minimize operational downtime.

Common Mistakes and Trade-Offs
Using test API keys on a live store

This is the most frequent setup error, often caused by rushing the launch process. Payments appear to process within the checkout modal, but the transactions are never captured or recorded in your production environment. Always double-check which mode your API keys belong to before going live, and perform a live transaction if you have any doubt about the key configuration.

Skipping the refund flow test

Most teams test the payment flow meticulously but completely ignore the refund flow. If a customer requests a refund and your team is unsure how to initiate it through the Razorpay Dashboard or Shopify, you create a massive support bottleneck on day one. Test the full refund lifecycle before you launch to ensure your operational processes are airtight.

Not configuring payment methods for your actual audience

The default Razorpay setup enables almost all methods, which can lead to a cluttered checkout experience. While broad support is beneficial, it is not optimized for every niche. If your audience skews younger and is based in metro areas, UPI and cards should be your prominent checkout features. If you sell to a broader demographic, ensure netbanking and mobile wallets are enabled and visually accessible.

COD as a separate workflow

Razorpay does not natively handle COD through the standard Shopify integration, a common point of confusion for new merchants. If COD is vital to your business, you'll need to use a separate COD management app or a third-party logistics partner that manages cash collection. Do not assume Razorpay covers this automatically; it is a separate operational workflow that requires distinct software handling.

Settlement timing expectations

Razorpay's standard settlement is T+2, meaning you receive your funds two business days after the transaction is completed. If your store has high daily volumes and tight inventory margins, factor this into your cash flow planning. Instant settlements are available on Razorpay for an additional fee — this is a strategy worth evaluating if your working capital is a primary growth constraint.

FAQs
What is the difference between Razorpay's test mode and live mode on Shopify?

Framer is a design tool that allows you to design websites on a freeform canvas, and then publish them as websites with a single click.

Web Personalisation

Framer is a design tool that allows you to design websites on a freeform canvas, and then publish them as websites with a single click.

UI and UX Design

Framer is a design tool that allows you to design websites on a freeform canvas, and then publish them as websites with a single click.

Search Engine Optimisation

Framer is a design tool that allows you to design websites on a freeform canvas, and then publish them as websites with a single click.

CRM and ERP Solutions

Framer is a design tool that allows you to design websites on a freeform canvas, and then publish them as websites with a single click.

Ecommerce

Framer is a design tool that allows you to design websites on a freeform canvas, and then publish them as websites with a single click.

Email Marketing

Framer is a design tool that allows you to design websites on a freeform canvas, and then publish them as websites with a single click.

Marketing Automation

Framer is a design tool that allows you to design websites on a freeform canvas, and then publish them as websites with a single click.

Chatbots and Conversational AI

Framer is a design tool that allows you to design websites on a freeform canvas, and then publish them as websites with a single click.

Chatbots and Conversational AI

Framer is a design tool that allows you to design websites on a freeform canvas, and then publish them as websites with a single click.

Let's work together

Have a project in mind?

Let's make it real.

Tell us what you're building. We'll bring the design, technology, and thinking to make it happen.

Fill up the following form to start a conversation

with our team

Let's work together

Have a project in mind?

Let's make it real.

Tell us what you're building. We'll bring the design, technology, and thinking to make it happen.

Fill up the following form to start a conversation with our team

Let's work together

Have a project in mind?

Let's make it real.

Tell us what you're building. We'll bring the design, technology, and thinking to make it happen.

Fill up the following form to start a conversation

with our team