A Step-by-Step Guide to Integrating Razorpay with Shopify for Indian Businesses

By WovLab Team | March 24, 2026 | 11 min read

Why Razorpay is the Go-To Payment Gateway for Shopify in India

For any Indian e-commerce business, the decision of how to integrate Razorpay with Shopify is less of a question and more of a strategic imperative. While Shopify Payments remains unavailable in India, Razorpay has decisively filled the void, establishing itself as the default choice for thousands of successful online stores. This isn't by accident. Razorpay's power lies in its deep understanding of the Indian consumer's payment habits. It offers the most comprehensive suite of payment options tailored specifically for the local market, including UPI (the undisputed king of digital payments in India), all major credit and debit cards, 50+ net banking options, and popular digital wallets like JioMoney, Mobikwik, and PhonePe. Furthermore, its support for "Buy Now, Pay Later" (BNPL) services and easy EMI options can significantly boost conversion rates by offering customers flexible payment solutions at checkout.

From a technical standpoint, Razorpay's integration is seamless. Its developer-first approach means robust documentation, reliable APIs, and a dedicated Shopify app that simplifies the entire process. Unlike many competitors, Razorpay provides a unified dashboard where merchants can manage transactions, initiate refunds, and gain powerful insights into their cash flow. This combination of customer-facing flexibility and backend efficiency is unmatched. Let's look at a direct comparison to understand its competitive edge:

Key Insight: Choosing a payment gateway isn't just about accepting payments. It's about reducing friction at the most critical point of the customer journey. Razorpay's extensive payment options and superior user experience directly translate to lower cart abandonment and higher revenue for Indian Shopify stores.

Pre-flight Checklist: What You Need Before Integrating

A smooth integration process begins with good preparation. Attempting to connect Razorpay and Shopify without having all your documentation and accounts in order can lead to delays and frustrating roadblocks. Before you begin the technical steps, treat this section as a mandatory checklist. Ensure you have every item ready to go.

1. An Active Shopify Store: This seems obvious, but ensure your store is at least on a basic paid plan. You cannot integrate third-party payment gateways on a trial plan.
2. A Registered Indian Business: You must have a registered business entity in India. This can be a Private Limited Company, a Limited Liability Partnership (LLP), a Partnership Firm, or a Sole Proprietorship. You will need the official registration documents for the KYC process.
3. Business Bank Account: A current bank account in the name of your registered business is mandatory for settlement. You will need your account number, IFSC code, and a cancelled cheque or bank statement.
4. Essential Business Documents:
   • PAN Card: The business PAN card is required. For a proprietorship, the owner's PAN card is used.
   • GST Certificate: If you are registered for GST, keep your GSTIN handy. While not always mandatory to start, it's essential for compliant operations.
5. An Activated Razorpay Merchant Account: This is the most crucial step. Go to the Razorpay website and sign up. You will need to complete their online KYC (Know Your Customer) process by uploading your business documents. This review process can take a few business days, so do this well in advance. Do not start the Shopify integration until your Razorpay account is fully activated.
6. API Keys from Razorpay Dashboard: Once activated, log in to your Razorpay dashboard. Navigate to Settings -> API Keys. Generate a new set of keys for your Shopify integration. You will need two pieces of information: the Key ID and the Key Secret. Copy these into a secure location. You will need them in the next step.

Expert Tip: The Razorpay KYC and activation is the most common point of delay. Start the Razorpay sign-up process at least a week before you plan to go live. This gives their compliance team ample time to review your documents and gives you a buffer to provide any additional information they may require.

The Official Method: Installing and Configuring the Razorpay Payments App

Once you've completed the pre-flight checklist, the actual process to integrate Razorpay with Shopify is straightforward thanks to the official app. This method ensures stability, security, and access to the latest features. Follow these steps precisely to avoid common errors.

1. Find the App: From your Shopify Admin dashboard, go to Settings in the bottom-left corner. Then navigate to Payments. Click on "Choose a provider" or "Add payment methods". Search for "Razorpay" in the list of third-party providers. Select the official app, named "Razorpay Official".
2. Install the App: Click to install the app. Shopify will show you a confirmation screen detailing the permissions the app requires. Approve this to proceed. You will be redirected to the Razorpay configuration page within your Shopify admin.
3. Enter Your API Keys: This is the most critical step. You will see two fields: Key ID and Key Secret. Carefully copy and paste the keys you generated from your Razorpay dashboard in the previous stage. A single typo here will cause the integration to fail. We recommend pasting them into a simple text editor first to ensure no extra spaces are copied.
4. Configure Payment Action: You will see a "Payment Action" dropdown with two options:
   • Authorize and Capture: This is the most common setting. When a customer pays, the amount is authorized by their bank and immediately 'captured' by Razorpay, meaning the payment is processed and settled to you. Select this unless you have a specific reason not to.
   • Authorize: This option only 'authorizes' the payment, placing a hold on the customer's card for the order amount. You must then manually 'capture' the payment from your Shopify Orders page before the authorization expires (typically within a few days). This is useful for businesses that need to verify stock or details before charging the customer.
5. Enable Test Mode (Initially): For now, check the box to "Enable Test Mode". We will use this in the next section to perform a safe test transaction without moving real money.
6. Activate the Gateway: Once the details are filled in, click the "Activate Razorpay Official" button. Shopify will now show Razorpay as an active payment gateway in your "Payments" settings.

Your store is now technically connected to Razorpay. The final step is to ensure it works correctly before you start accepting real payments from customers.

Testing Your Integration: How to Run a Real-Time Test Transaction

Never assume your integration works perfectly after setup. A single misconfiguration can lead to failed payments and lost customers. Running a test transaction is a non-negotiable final step before going live. This process simulates a real purchase using Razorpay's test environment, ensuring that the entire data flow from Shopify to Razorpay and back is functioning correctly.

Here’s how to do it safely:

1. Confirm Test Mode is Active: In your Razorpay Dashboard, you should see a toggle for Test Mode / Live Mode. Ensure it is set to "Test Mode". Similarly, in your Shopify Payments settings for the Razorpay app, make sure the "Enable Test Mode" checkbox is ticked. The API keys for Test and Live modes are different. The keys you use in Shopify must match the mode selected in your Razorpay dashboard.
2. Create a Test Product: In your Shopify Admin, go to Products and create a new product. Title it "Test Product", set the price to something small like ₹1.00, and make sure it is in stock and active.
3. Simulate a Customer Purchase: Open your Shopify store in a new incognito browser window (to ensure you're not logged in as an admin). Navigate to the "Test Product," add it to your cart, and proceed to checkout.
4. Enter Test Payment Details: Fill in the customer details and proceed to the payment page. When the Razorpay checkout modal appears, use the official test card details provided by Razorpay. Do not use your real credit card.

You will be prompted to simulate success or failure. Choose "Success".

5. Verify the Transaction: After a successful test payment, you should be redirected to your Shopify store's "Thank You" page. Now, check your dashboards:
   • In Shopify: Go to Orders. You should see a new order for the "Test Product" with the payment status marked as "Paid".
   • In Razorpay: In your Razorpay dashboard (still in Test Mode), go to the "Payments" tab. You should see a new entry for ₹1.00, marked as "Captured".
6. Go Live: Once you have successfully verified the transaction in both dashboards, you are ready to accept real payments. Go back to the Razorpay app settings in Shopify, uncheck "Enable Test Mode," and save. Then, switch your Razorpay dashboard from Test Mode to Live Mode. Your integration is now live.

Troubleshooting Common Errors (Like "Payment Failed")

Even with a straightforward process, issues can arise. Seeing a "Payment Failed" error can be alarming, but most problems are due to simple configuration mistakes. Before contacting support, review these common troubleshooting steps. It will save you time and likely solve your issue immediately.

Error 1: "Payment failed. Please try again." (Generic Error at Checkout)

This is the most common error and is usually caused by a mode mismatch.

• Cause A: You are using Live API Keys in Shopify but your Razorpay dashboard is in Test Mode.
• Cause B: You are using Test API Keys in Shopify but your Razorpay dashboard is in Live Mode.
• Solution: The mode must be consistent everywhere. If you want to test, enable Test Mode in Shopify AND switch your Razorpay dashboard to Test Mode. If you want to go live, disable Test Mode in Shopify AND switch your Razorpay dashboard to Live Mode. They must always match.

Error 2: Invalid Signature or "Bad Request: The payment failed due to a technical error."

• Cause: You have copied the Key ID or Key Secret incorrectly. Even a single extra space or a character typo will cause this security error.
• Solution: Go back to your Razorpay dashboard -> Settings -> API Keys. Carefully regenerate a new set of API keys. Copy the new Key ID and Key Secret. Paste them into the Shopify Razorpay app settings, ensuring there are no leading or trailing spaces. Save and re-test.

Error 3: The payment gateway is not showing up at checkout.

• Cause A: The gateway was not properly activated.
• Cause B: Your Shopify plan doesn't support third-party gateways (e.g., a trial plan).
• Solution: Go to your Shopify Admin -> Settings -> Payments. Scroll down to "Third-party payment providers." Ensure "Razorpay Official" is listed and active. If it's not, you may need to re-add and activate it. Also, confirm you are on a paid Shopify plan.

Crucial Insight: Over 90% of integration issues trace back to a mismatch between API keys (Key ID and Key Secret) and the selected mode (Test vs. Live). Always check this first. When in doubt, regenerating and re-pasting your API keys is the fastest way to resolve signature-related errors.

Can't Get it Working? Let WovLab Handle Your Payment Gateway Integration

While the official Razorpay app has made integration simpler than ever, e-commerce is a complex ecosystem. The guide above covers the standard process, but what if your store isn't standard? You might have a custom-coded theme, conflicting third-party apps, or specific business logic that requires a more nuanced setup. When you're dealing with the lifeblood of your business—customer payments—"almost working" isn't good enough.

This is where an expert partner makes all the difference. At WovLab, we are more than just a digital agency; we are technical consultants and system integrators. We've managed payment gateway integrations for dozens of Indian businesses, navigating the unique challenges that arise with custom Shopify builds and complex operational workflows. We don't just follow the manual; we understand the underlying technology.

Our services go beyond a simple setup. We can help you:

• Debug Complex Failures: We dive into webhook logs and API responses to diagnose issues that aren't covered in standard documentation.
• Optimize for Performance: We ensure your payment gateway integration doesn't slow down your site's loading speed, protecting your conversion rates.
• Implement Custom Logic: Need to trigger specific workflows post-payment? Or handle subscription billing with UPI AutoPay? We can build custom solutions that connect your payment data to other parts of your business, including ERPs and marketing automation platforms.
• Ensure Security & Compliance: We ensure your integration is secure, compliant, and built to scale as your business grows.

Don't let technical challenges become a bottleneck for your revenue. If you're struggling to integrate Razorpay with Shopify, or if you want to ensure your payment infrastructure is robust and optimized from day one, contact the experts at WovLab. We handle the technical complexities so you can focus on what you do best: running your business. Visit us at wovlab.com to learn more about our comprehensive e-commerce and payment solutions.