The Ultimate Guide to Payment Gateway Integration for Shopify in India

By WovLab Team | March 21, 2026 | 8 min read

How to Choose the Right Indian Payment Gateway for Your Shopify Store

Selecting the right partner for payment gateway integration for Shopify in India is a critical business decision that directly impacts your cash flow, customer trust, and conversion rates. While Shopify Payments is an option, many Indian merchants prefer third-party gateways for their wider range of payment methods and competitive pricing. When evaluating options, don't just look at the headline transaction rate; consider the entire ecosystem. Key factors include the onboarding process (how fast can you go live?), the settlement cycle (T+1, T+2, or T+3 days), and the breadth of payment options offered. For the Indian market, support for UPI, major mobile wallets (like Paytm, PhonePe), and EMI options is non-negotiable. Furthermore, examine the quality of customer support and the ease of integration. A robust gateway provides clear documentation and a responsive technical team, which is invaluable when issues arise. Analyzing these factors holistically ensures you choose a gateway that supports your growth rather than hindering it.

Choosing a payment gateway is not just a technical task; it's a strategic financial decision. Prioritize a provider whose settlement speed matches your business's cash flow requirements.

A Technical Walkthrough: Integrating Razorpay vs. PayU on Shopify

The technical side of payment gateway integration for Shopify in India is thankfully straightforward for most major providers. Shopify’s ecosystem is designed for plug-and-play functionality. Let's compare the setup for two of India's most popular gateways: Razorpay and PayU. The process for both begins in your Shopify admin panel under Settings → Payments.

To integrate Razorpay:

1. In the "Supported payment methods" section, click "Add payment methods."
2. Search for "Razorpay" and select it from the list.
3. You will be prompted to enter your [Key ID] and [Key Secret]. You can generate these credentials from your live Razorpay dashboard under Settings → API Keys.
4. Before activating, it's crucial to enable "Test mode" and use Razorpay's test credentials to run a few dummy transactions. This ensures everything is configured correctly.
5. Once testing is successful, disable test mode and click "Activate Razorpay."

To integrate PayU:

1. Follow the same initial steps: Settings → Payments → Add payment methods.
2. Search for "PayU Money" or "PayU" and select it.
3. Here, the required credentials are your [Merchant Key] and [Salt]. These are found in your PayU dashboard under Profile → My Account.
4. Like Razorpay, PayU has a test/sandbox environment. You must use test credentials to validate the payment flow on your store before going live with real merchant keys.
5. After successful tests, input your live credentials and activate the gateway.

The core difference lies in the credential names, but the process is identical. The key is to always test in the sandbox environment before processing live payments.

Configuring Transaction Fees, Settlements, and GST Compliance

Understanding the financial mechanics behind your chosen payment gateway is just as important as the technical setup. One of the most frequently misunderstood aspects is Shopify's own transaction fee. If you use a third-party provider instead of Shopify Payments, Shopify levies its own fee on each transaction, which typically ranges from 2.0% for the Basic plan down to 0.5% for the Advanced plan. This is *in addition* to the Transaction Discount Rate (TDR) charged by your gateway (e.g., Razorpay or PayU). You must factor this combined cost into your pricing and margin calculations.

A common pitfall for new Shopify merchants is ignoring the platform's additional transaction fee when using an external gateway. Your total cost per transaction is [Gateway TDR] + [Shopify Platform Fee].

Settlements are the actual deposits of customer payments into your business bank account. Gateways operate on a settlement cycle, typically T+2 days, meaning funds from a transaction on Monday are settled by Wednesday. You must actively monitor your gateway's dashboard for settlement reports. Reconcile these reports against your Shopify orders and bank statements to ensure accuracy and track your cash flow effectively. Razorpay's dashboard, for instance, provides detailed reports that break down each transaction, the fees deducted, applicable taxes (GST), and the final settlement amount. For GST compliance, the process is largely automated. The payment gateway will deduct GST on its TDR fee and provide you with a monthly invoice. You can download this invoice, which will have your GSTIN, and use it to claim Input Tax Credit (ITC), reducing your overall tax liability.

Testing and Troubleshooting Common Shopify Payment Gateway Errors

Even with a smooth integration, you may encounter occasional errors. A rigorous testing protocol is your first line of defense. Before launching, you must process several transactions using your gateway's test mode. This involves using a set of dummy card numbers, UPI IDs, and net banking credentials provided in the gateway's developer documentation. Your testing checklist should include:

• A successful transaction that correctly marks the order as "Paid" in Shopify.
• A failed transaction (e.g., using an incorrect CVV or OTP) to see how the error is presented to the user.
• Processing a refund from the Shopify dashboard and confirming it's reflected in the gateway's test environment.
• Checking that customer data (name, email, phone) is correctly passed from Shopify to the gateway dashboard.

Despite testing, some common errors can pop up in a live environment:

• Payment Authorization Failed: This is often a customer-side issue, like insufficient funds or incorrect card details. However, if it happens frequently, it could indicate a configuration mismatch. Ensure your account is fully activated and approved for all required payment methods.
• Order Marked as Abandoned After Payment: This is a critical error where the customer pays, but the communication back to Shopify (the "webhook" or "callback") fails. The order isn't confirmed. This can happen due to network timeouts or incorrect webhook settings. Immediately contact your gateway's support with the specific Order ID and Payment ID to resolve it.
• Invalid Credentials: This error during setup means you've copied the API Key/Secret or Merchant Key/Salt incorrectly. Re-copy them carefully, paying attention to avoid any extra spaces or characters.

Keeping a log of these incidents and the resolutions provided by your gateway's support team can help you build an internal troubleshooting guide.

Beyond the Basics: Customizing the Checkout Experience for Higher Conversions

While a standard integration works, optimizing the checkout experience is key to minimizing cart abandonment and building brand trust. The goal is to make the transition from your Shopify store to the payment page as seamless as possible. On standard Shopify plans, customization of the checkout process itself is limited. However, you can significantly enhance the user experience by configuring the gateway's hosted payment page. Almost all Indian gateways, including Razorpay and PayU, allow you to customize their payment interface from their dashboard. You should immediately:

• Upload Your Brand Logo: This is the most crucial step. A customer seeing your logo on the payment page provides instant reassurance that they are in the right place.
• Set Your Brand Color: Change the default color scheme of the payment page to match your store's primary color. This creates a visually consistent and professional experience.
• Prioritize Payment Methods: If you know 70% of your customers pay via UPI, work with your gateway to display UPI as the default or most prominent option. This reduces clicks and speeds up the checkout process.

For businesses seeking ultimate control, upgrading to Shopify Plus is the answer. This unlocks the ability to edit the `checkout.liquid` file, offering deep customization possibilities. With Shopify Plus, you can modify the layout, add trust seals, display custom messages, or even implement a one-page checkout. This level of control allows you to A/B test different checkout experiences and use data to drive conversion rate optimization.

A non-branded, generic payment page is a major source of customer drop-off. Customizing the gateway's UI with your logo and brand color is a simple, high-impact change that every merchant should make.

Streamline Your Fintech Setup: Partner with WovLab for Expert Integration

A basic payment gateway integration for Shopify in India is just the starting point of building a robust e-commerce financial operation. As your business scales, complexities emerge. You might need to accept international payments, which involves navigating FEMA compliance, dynamic currency conversion, and different fee structures. You may want to launch a subscription service, requiring deep integration with recurring billing APIs and e-mandate systems like eNACH or UPI Autopay. Or, you might be running a marketplace that requires a custom solution for splitting payments between multiple vendors.

This is where a strategic partner like WovLab becomes essential. We go beyond the standard setup. Our expertise lies in architecting and implementing sophisticated fintech solutions that align with your specific business model. We handle the complex challenges so you can focus on growth:

• Advanced Integrations: We connect your payment gateway with your ERP system, accounting software, and marketing analytics tools, ensuring a single source of truth for your financial data.
• Subscription & Recurring Billing: We build and implement robust subscription models on Shopify, leveraging gateway APIs for seamless recurring payments and lifecycle management.
• Global Payments Strategy: We help you configure and manage international payment acceptance, optimizing for cost, compliance, and customer experience across different geographies.
• Automated Reconciliation: Forget manually matching transactions. We build automated workflows that reconcile orders, payments, fees, and bank settlements, saving you hundreds of hours.

At WovLab, we see payment integration not as a one-time task, but as a core component of your digital infrastructure. Our team of developers and consultants ensures your payment stack is not just functional, but a competitive advantage. Partner with us to build a seamless, scalable, and secure financial backbone for your e-commerce business.