Complete Guide to Razorpay-Shopify Integration in 2025

Razorpay has emerged as the dominant payment gateway for Indian e-commerce, offering a comprehensive suite of payment methods that cover the full spectrum of how Indians prefer to pay online — UPI, credit and debit cards, net banking, wallets, and EMI options. For Shopify merchants targeting the Indian market, integrating Razorpay is essential.

The integration architecture follows a standard pattern: Shopify's Payment App API provides the framework for custom payment providers, and Razorpay's SDK handles the actual payment collection. The key advantage of this approach is that payment data never touches the merchant's servers — it flows directly between the customer's browser and Razorpay's secure infrastructure.

Setting up the integration requires creating a Razorpay account, obtaining API keys from the Razorpay Dashboard, and installing a compatible Shopify app. Our SmartSubscription app includes built-in Razorpay support specifically tuned for Indian merchants, handling the INR currency requirements and local compliance obligations automatically.

UPI payments deserve special attention in your integration strategy. UPI now accounts for over 60% of digital payments in India and offers near-zero transaction fees for merchants. Ensuring your integration correctly handles UPI payment flows — including the QR code display, deep link to UPI apps, and async payment confirmation — is critical for conversion rates.

Subscription billing with Razorpay requires using their Subscriptions API, which is distinct from one-time payment flows. The API supports automatic mandate creation for UPI AutoPay and e-NACH for bank accounts, allowing merchants to collect recurring payments without requiring customers to manually authorize each charge.

Testing your integration thoroughly before going live is non-negotiable. Razorpay provides a test mode with specific test card numbers and UPI IDs that simulate various payment scenarios including success, failure, and pending states. Run through every payment method you intend to offer, and verify that your webhook handlers correctly process payment confirmation events before enabling live payments.