How to Integrate Cashfree Payment Gateway in Shopify (Complete Step-by-Step Tutorial)

For Indian e-commerce merchants and D2C brands, offering localized, high-speed payment methods like UPI (Google Pay, PhonePe, Paytm), credit/debit cards, Net Banking, and Buy Now Pay Later (BNPL) is essential for minimizing checkout drop-offs. Cashfree Payments is one of India’s leading payment aggregators, offering ultra-competitive transaction rates (typically 1.90% to 1.95% + GST) and industry-leading payment success rates.

However, many merchants struggle with merchant KYC verification, test mode configuration, and webhook setup. In this step-by-step developer tutorial by CV World, we guide you through the entire integration process from merchant onboarding to live checkout testing.

Step 1: Create and Verify Your Cashfree Merchant Account

1. Navigate to the official Cashfree Payments portal and sign up with your registered business email and mobile number.
2. Complete your Merchant KYC submission by providing:
   • Business Entity Type (Sole Proprietorship, Partnership, LLP, or Private Limited).
   • PAN Card of the business entity and authorized signatory.
   • Certificate of Incorporation, GST Certificate, or MSME/Udyam Registration.
   • Cancelled cheque or verified bank statement showing business current account details for automated daily settlements.
3. Once Cashfree risk operations approve your account (typically within 24 to 48 hours), your dashboard transitions to Active (Production) status.

Step 2: Generate Production API Keys

To connect Shopify securely with Cashfree, generate your secure API authentication keys:

1. Log in to the Cashfree Merchant Dashboard.
2. Ensure the toggle at the top left is switched from Test to Production mode.
3. From the sidebar navigation, go to Developers → API Keys.
4. Click Generate New API Key.
5. Safely copy both the App ID and the Secret Key. (Treat the Secret Key like a password; never share it publicly).

Step 3: Install the Cashfree Payments App on Shopify

1. Log in to your Shopify Admin dashboard.
2. Navigate to the Shopify App Store and search for Cashfree Payments.
3. Click Install to grant the payment integration permissions to your store.
4. You will be redirected to the Cashfree configuration portal. Paste your production App ID and Secret Key into the designated fields.
5. Click Save & Activate.

Step 4: Enable Cashfree in Shopify Payment Settings

Ensure Cashfree is activated as an official checkout payment option:

1. In Shopify Admin, go to Settings → Payments.
2. Under the Supported payment methods or Alternative payment providers section, locate Cashfree Payments.
3. Click Manage.
4. Ensure all payment method icons (UPI, Visa, Mastercard, RuPay, Net Banking) are checked.
5. Verify that Test Mode is UNCHECKED for live processing.
6. Click Save.

Step 5: Performing a Live ₹1 Test Transaction

Never announce store availability without validating the live checkout flow:

1. Create a temporary hidden test product priced at ₹1 INR.
2. Open an incognito browser window, add the product to cart, and proceed to checkout.
3. Enter shipping details and select Cashfree Payments as the payment method.
4. Scan the dynamic UPI QR code with PhonePe or Google Pay and complete the payment.
5. Verify that Shopify immediately redirects to the Thank You / Order Confirmation page with an order ID.
6. Check the Cashfree Dashboard under Transactions to confirm the payment shows as SUCCESS.

Troubleshooting Common Cashfree Integration Errors

Need professional help configuring payment gateways, one-click checkouts, or custom Shopify stores? Check out our complete e-commerce development solutions at CV World.

Cashfree Webhook Resilience & Auto-Settlement Setup

Ensuring payment confirmation reliability is paramount for high-volume stores. In Cashfree Merchant Dashboard → Developers → Webhooks, configure active webhooks for PAYMENT_SUCCESS_WEBHOOK and ORDER_PAID_WEBHOOK. This guarantees that even if a customer accidentally closes their mobile browser before the redirect completes, Cashfree’s server-to-server webhook instantly marks the order as paid in your Shopify admin, preventing missed order fulfillments.

Cashfree UPI Intent & Mobile Checkout Optimization

In Indian conversational commerce, UPI accounts for over 80% of digital retail transactions. Configuring Cashfree’s UPI Intent Flow allows mobile shoppers on Android and iOS to tap a single button that instantly launches their installed UPI app (PhonePe, Google Pay, or Paytm) with pre-filled payment amounts. This eliminates manual VPA entry, reduces transaction drop-offs by up to 35%, and achieves payment confirmation in under 5 seconds.

Frequently Asked Questions