How to Add UPI Checkout to Shopify (Step-by-Step for Indian Stores)

Shopify is the platform of choice for thousands of Indian D2C brands, but its default payment setup doesn't include UPI out of the box — you need to add it through Shopify's app ecosystem. The good news: setting up UPI on a Shopify store takes about 30 minutes, no developers required, and most merchants see immediate conversion lift from offering UPI alongside cards. This guide walks through every step, from choosing the right app to handling refunds.

How Shopify's payment system handles UPI

Shopify supports two ways for Indian merchants to accept UPI:

• Through Shopify Payments (the native processor) which includes UPI alongside cards. Easy but charges Shopify's standard transaction fees.
• Through a third-party payment gateway app installed from the Shopify App Store. More control, often cheaper, supports gateways like VyaparGateway, Razorpay, Cashfree, Instamojo.

For most Indian stores doing serious UPI volume, the third-party app route ends up cheaper and gives you more control over the customer experience. Shopify Payments is convenient if you want one less integration to think about.

Step 1: Install the VyaparGateway Shopify app

From your Shopify admin, go to Apps → search 'VyaparGateway' in the Shopify App Store, click Install. You'll be redirected to grant permissions: the app needs access to orders (to mark them paid via webhook), customers (to attach payment metadata), and payment configuration (to register itself as a payment method).

Step 2: Connect your VyaparGateway account

In the app's settings panel:

1. Paste your VyaparGateway API key (from your VyaparGateway dashboard → Settings → API Keys).
2. Paste your webhook signing secret (same dashboard, → Webhooks → Endpoints).
3. Select your bank account from the dropdown of accounts linked to your VyaparGateway merchant profile.
4. Choose your settlement currency (INR is the default for Indian Shopify stores).
5. Set the intent expiry window (default 15 minutes; can extend to 30 for slower checkouts).

Click Save. The app immediately registers UPI as a payment method on your store.

Step 3: Enable UPI in checkout settings

Go to Shopify admin → Settings → Payments. You'll see VyaparGateway listed as an available provider. Click Activate, choose whether it should appear above or below your other payment methods, and save. UPI is now live in your checkout.

Step 4: Test with a real order

Before announcing UPI to customers, do a small test transaction yourself:

1. Add a low-value product (₹10–₹50) to your cart.
2. Proceed to checkout, select UPI as the payment method.
3. Scan the dynamic QR with your own UPI app, complete the payment.
4. Verify Shopify marks the order as paid within ~10 seconds (the webhook latency).
5. Verify the credit appears in your bank account.
6. Check that the gateway dashboard shows the intent as paid with the matching order ID.

"Run your test with the actual customer email and address you'd use in production — testing with junk data sometimes hides integration bugs that only show up with real-shaped inputs."

Handling refunds

When you initiate a refund from the Shopify admin, the app automatically calls VyaparGateway's refund API, which credits the customer's original UPI source. For UPI, refunds typically settle in seconds (sometimes a few hours, depending on the customer's bank). Partial refunds work the same way — just specify the amount in the Shopify refund form.

Common Shopify-UPI integration gotchas

Issues that catch first-time integrators:

• Test mode confusion — Shopify and VyaparGateway both have test/live mode toggles. Make sure both are in live mode before going to production, and both in test before doing dummy transactions.
• Currency mismatch — Shopify lets you set your store currency separately from your payment method currency. For UPI, both must be INR.
• Webhook URL — the VyaparGateway app configures this automatically, but if you migrate hosting or change domains, you'll need to update it manually in your VyaparGateway dashboard.
• Order tagging — by default, UPI-paid orders aren't tagged distinctly in Shopify. Add a flow in Shopify Flow to tag them if you want easier reporting.
• Shopify Plus considerations — Plus stores have extra checkout customization options that interact with payment methods. Test thoroughly in your staging environment.

Going beyond the basic integration

Once basic UPI checkout works, consider these enhancements:

• Add UPI intent URL buttons for mobile customers ('Pay with PhonePe / GPay / Paytm') — converts better than showing a QR on mobile.
• Configure Shopify Flow to automatically email the customer with order details the moment the UPI webhook confirms.
• Use the VyaparGateway dashboard's reconciliation export at month-end for clean accounting.
• Set up alerts on failed webhook deliveries so you catch any issues before customers do.

Most Indian Shopify stores that switch from card-only checkout to UPI + cards see meaningful conversion uplift within the first month, especially on mobile traffic. The full integration takes under an hour to set up. VyaparGateway helps you issue dynamic UPI QR codes, verify payments, and notify your stack via webhooks—without charging a per-transaction platform fee on top of your plan.