Shopify Payment Gateway Integration Checklist for India

Shopify Payment Gateway Integration in India: A Practical Checklist

For Shopify payment gateway integration in India, choose a gateway that supports your business type, complete its KYC, connect it through Shopify, and test every payment and refund flow before launch. Razorpay and Cashfree are common options, but the right choice depends on your products, settlement needs, payment methods, business documents and Shopify plan.

A payment gateway is not just a checkout button. It affects customer trust, UPI and card acceptance, payment failures, refunds, reconciliation, cash flow and the amount of manual work your team handles after an order is placed.

Use this checklist before switching your Shopify store from test mode to live payments.

1. Confirm How Shopify Payments Work in India

Shopify provides the storefront, cart, checkout and order management system. A payment gateway processes the money paid by the customer and communicates the payment result back to Shopify.

For India-based merchants, third-party payment gateways are commonly used. Razorpay, Cashfree, PayU and other providers may offer Shopify integrations, subject to their current product availability, onboarding rules and approval process. Shopify Payments availability and supported features can change by country and account type, so check the current Shopify documentation and your admin panel before making a decision.

The usual payment flow looks like this:

1. A customer adds products to the Shopify cart.
2. The customer enters contact, delivery and billing details.
3. The customer selects a payment option such as UPI, card, net banking or wallet.
4. The gateway processes the transaction.
5. Shopify receives the payment status.
6. The order is marked as paid, failed, pending or requiring review.
7. The gateway settles the money into your bank account after deducting applicable charges and adjustments.

This flow involves several systems. Shopify, the gateway, the customer’s bank or UPI app and your bank account must all communicate correctly. A successful-looking checkout does not remove the need for reconciliation.

What a payment gateway does not solve

A gateway will not automatically fix:

• Incorrect product pricing or GST settings
• Poor checkout instructions
• Slow website performance
• Wrong shipping charges
• Failed address validation
• Fraudulent orders
• Delayed refund decisions
• Incorrect order-to-payment matching
• Customer confusion about delivery timelines

Payment integration should be treated as one part of your ecommerce operations, not as a standalone technical task.

2. Choose a Gateway Before Installing an App

Do not select a gateway only because its logo is familiar. Compare the gateway against your order value, customer locations, product category, refund frequency and expected payment mix.

A D2C brand selling low-value products may care most about UPI success rates and a simple mobile checkout. A school collecting fees may need payment links, reports and controlled refunds. An NGO may need to confirm whether the gateway supports its legal structure and donation-related use case. A clinic may need clear payment descriptions and refund handling.

Razorpay and Cashfree

Razorpay and Cashfree are frequently considered by Indian Shopify merchants because they support common Indian payment methods and provide merchant dashboards, payment links or related tools. The exact features available to your account can depend on onboarding approval, business category, integration type and changes to the provider’s products.

Razorpay may be suitable when you want a widely used gateway dashboard, multiple payment options and integrations with other business tools. Cashfree may be suitable when you want payment processing and related payout or payment collection capabilities, depending on what is available for your account.

This is not a claim that one will always perform better. Payment success can vary by customer bank, UPI app, card network, device, location and temporary service conditions.

Gateway comparison checklist

Ask the gateway for current commercial and compliance information instead of relying on an old blog post or a recommendation made for another business.

3. Prepare Your Business and KYC Documents

Payment gateways in India generally require business verification before enabling live transactions. The exact document list varies according to your legal structure and the gateway’s onboarding process.

Commonly requested information may include:

• PAN details
• Bank account information
• Cancelled cheque or bank proof
• Business address
• Mobile number and email address
• Website or Shopify store URL
• Business constitution documents
• GST details, where applicable
• Identity and address proof of authorised persons
• Partnership deed, incorporation documents or trust-related records, where relevant

The name on your gateway account, bank account and business documents should be consistent. Differences in spelling, abbreviations, proprietor names or registered business names can cause verification delays.

Sole proprietorship

A sole proprietor may be asked for personal identity documents along with business and bank details. The gateway may assess whether the website clearly explains what is being sold and who operates the business.

Private limited company or LLP

A company or LLP may need incorporation information, authorised signatory details, bank proof and relevant tax registrations. Make sure the person completing the application is authorised to represent the business.

Partnership firm

Partnership documentation and details of the partners may be required. The gateway may ask for additional proof if the bank account name and partnership name do not align.

Trust, society or NGO

An NGO should confirm whether its registration type and proposed collection activity are supported. Donations, membership payments, event fees and sales of merchandise can have different compliance considerations. Keep registration documents, bank details and the purpose of collection ready.

GST and invoices

GST treatment depends on your registration status, products, customer location and nature of supply. Shopify can help display tax information and support order records, but it does not replace advice from your chartered accountant.

Before going live, decide:

• Whether product prices are inclusive or exclusive of GST
• How GST will be shown at checkout
• Whether invoices will be generated automatically
• How shipping charges are treated
• How returns and credit notes will be recorded
• How gateway charges and GST on those charges will be booked

Do not assume that a payment receipt from Razorpay or Cashfree is the same as a tax invoice for your customer.

4. Configure the Shopify Store Before Integration

The gateway is easier to test when the Shopify store itself is correctly configured.

Complete the basic store settings

Review these areas in Shopify:

• Store currency in Indian rupees
• Store contact information
• Business address
• Shipping zones and rates
• Local delivery or pickup settings, if applicable
• Tax settings
• Order notification email
• Customer account preferences
• Return and refund policy
• Privacy policy
• Terms and conditions
• Shipping and delivery information

Use a real business email address rather than an individual mailbox that may be inaccessible to the operations team later.

Set up products correctly

Each product should have:

• Accurate title and description
• Price and compare-at price, if used
• Tax classification reviewed with your accountant
• SKU or internal item code
• Inventory status
• Weight, where shipping calculations depend on it
• Variant information
• Delivery restrictions, if any

Payment issues are often blamed on the gateway when the actual problem is an incorrect order total, an unavailable product or a shipping rule that does not apply to the customer’s PIN code.

Review checkout expectations

Indian shoppers often expect UPI, card, net banking and sometimes cash on delivery. A store selling to smaller towns or first-time customers may need both prepaid and COD options. COD is not a payment gateway method, but it affects payment operations, cancellations, return-to-origin costs and fraud controls.

If you offer COD, define:

• Eligible PIN codes
• Maximum COD order value
• Confirmation process
• Cancellation rules
• Partial COD or prepaid balance rules
• Whether additional COD charges apply
• How failed deliveries are handled

Your payment strategy should match your delivery strategy.

5. Complete the Shopify Payment Gateway Integration

The exact menu names can change as Shopify and gateway providers update their systems. Use the gateway’s current Shopify instructions rather than copying an old tutorial.

A typical integration involves the following steps.

Step 1: Create the merchant account

Register with the selected provider using your legal business details. Complete the required KYC and wait for approval for the payment methods you need.

Do not use a personal bank account for a business account unless the provider explicitly allows that structure and your records are consistent.

Step 2: Confirm live access

Some providers allow you to create an account before all payment methods are activated. Confirm whether UPI, cards, net banking, wallets and international payments are each enabled for your account.

A merchant account can be approved while a specific payment method remains restricted or under review.

Step 3: Install the supported Shopify integration

In Shopify admin, open the payment settings and review available third-party providers. If the gateway supplies an official Shopify app or activation process, use the documented method.

Avoid installing an unrelated app that claims to connect multiple gateways unless you understand who operates it, what permissions it requests and how payment data is handled.

Step 4: Connect the merchant account

The connection may use an authorisation flow, merchant credentials or keys supplied by the gateway. Keep test credentials and live credentials separate.

Do not paste secret keys into theme files, public scripts, spreadsheets shared with freelancers or unsecured chat messages. If a developer needs access, use appropriate account permissions and remove access after the work is complete.

Step 5: Configure payment methods

Enable only the methods you are prepared to support. If UPI is enabled, decide how your team will handle pending, failed or reversed payments. If international cards are enabled, review additional compliance, settlement and dispute considerations.

Step 6: Review redirect and callback behaviour

Some payment flows redirect the customer to the gateway and then return them to Shopify. The order should not be treated as paid only because the customer reached a thank-you page.

The gateway’s server-side status and Shopify’s order status should be checked. Webhooks or callback notifications are important because a customer may close the browser after payment while the gateway is still processing the transaction.

Step 7: Check order and email updates

After connection, verify that:

• Paid orders appear correctly in Shopify
• Failed payments do not create confusing fulfilment instructions
• Payment status is visible to staff
• Customers receive the intended confirmation email
• The transaction reference can be matched to the order
• Refund status is recorded correctly

6. Test Every Payment and Refund Scenario

Never test only one successful UPI payment. A proper Shopify payment integration test includes both normal and abnormal outcomes.

Use the gateway’s test or sandbox mode where available. Then perform a controlled live transaction with a small amount before opening the store to customers. Confirm the provider’s current test-mode instructions because test credentials and supported scenarios vary.

Minimum test cases

Test the following:

• UPI payment from a mobile device
• Card payment
• Net banking payment, if enabled
• Wallet payment, if enabled
• Payment cancellation at the gateway page
• Incorrect or failed payment
• Customer closing the payment window
• Browser refresh during payment
• Delayed payment confirmation
• Duplicate clicking on the payment button
• Order creation after successful payment
• Refund of the full amount
• Partial refund, if your business needs it
• Cancellation before fulfilment
• Payment reversal or webhook update
• Customer receiving the correct email
• Admin seeing the correct order status

UPI-specific testing

UPI is central to Indian ecommerce, but its flow can vary by device. A customer shopping on a mobile device may use an installed UPI app. A customer shopping on a laptop may scan a QR code or enter a UPI ID, depending on the gateway interface.

Test on more than one device and network. Check what happens when the customer approves payment but returns to the browser late. A transaction may show as pending before the final status is received.

Refund testing

A refund is not complete merely because someone clicks “refund” in Shopify. Confirm:

• Whether the refund is initiated through Shopify or the gateway
• Whether the gateway accepts full and partial refunds
• Whether the refund amount includes shipping or other charges
• How long the customer may wait for the credit
• Whether the original payment method receives the refund
• How the refund appears in gateway reports
• How the refund is reflected in your accounting records

Your support team should have a standard reply for refund status. Avoid promising an exact credit date unless the gateway confirms it for that transaction.

7. Plan for Fees, Settlements and Reconciliation

Payment gateway charges generally include processing fees and applicable taxes. The commercial terms depend on the provider, payment method, business category, transaction type and negotiated arrangement. Shopify may also apply charges depending on your plan and payment setup, so review Shopify’s current terms alongside the gateway’s terms.

Do not compare gateways only by the advertised processing rate. Consider the total operating cost:

• Processing charges
• GST on applicable gateway fees
• Refund-related charges or adjustments
• Chargeback or dispute costs
• International payment costs
• Currency conversion costs
• Shopify-related transaction charges, where applicable
• Manual reconciliation time
• Support and integration maintenance

Settlement reconciliation checklist

For each settlement period, match:

1. Shopify order number
2. Gateway transaction ID
3. Gross order amount
4. Gateway fee
5. GST on gateway fee
6. Refunds or reversals
7. Chargebacks or adjustments
8. Net settlement amount
9. Bank credit date

A payment gateway settlement is usually a batch of transactions, not one bank credit per order. Your team needs a repeatable method to match the batch to Shopify orders.

Export reports regularly and keep records according to your accounting and statutory requirements. If your store has multiple gateways, maintain separate reconciliation sheets or accounting mappings for each provider.

Settlement timing

Settlement timing can depend on the payment method, business verification, risk review, weekends, bank holidays, refund activity and the provider’s agreement with your account. Do not build inventory or advertising plans around an assumed settlement date until you have confirmed the gateway’s terms.

For a small business, a short delay can affect stock purchases, courier payments and advertising cash flow. Discuss expected settlement behaviour with the provider before launch.

8. Secure the Store and Reduce Payment Risk

Shopify manages important parts of the hosted checkout environment, but store owners remain responsible for account security, staff access and operational controls.

Protect admin access

Use individual staff accounts where possible. Turn on multi-factor authentication and avoid sharing the owner login with a developer, agency or warehouse team.

Review access when:

• An employee leaves
• A freelancer completes the project
• An agency contract ends
• A new payment gateway is connected
• A store ownership change occurs

Keep credentials private

API keys, secret keys and gateway login details should not be stored in public repositories, theme code or shared documents. If credentials are exposed, rotate them through the provider’s dashboard and review recent transactions.

Watch for suspicious orders

A successful payment does not guarantee that an order is genuine. Review unusual combinations such as:

• A high-value order from a new customer
• Billing and shipping addresses that do not match
• Multiple failed cards followed by one success
• Several orders using the same contact details
• A customer insisting on a different delivery address after payment
• A request to ship before payment status is confirmed

Do not cancel legitimate orders automatically based on one signal. Create a review process suitable for your order value and category.

Understand disputes and chargebacks

A cardholder may dispute a transaction through the bank or card network. The gateway may ask for evidence such as order details, delivery proof, customer communication and refund records.

Keep documentation for the relevant retention period advised by your accountant, gateway and applicable rules. A clear refund policy and delivery record can help your team respond to disputes, but they do not guarantee a favourable outcome.

Privacy and customer data

Use only the customer information needed for fulfilment, support, accounting and legal obligations. Review the privacy policies of Shopify, the gateway and other apps connected to your store.

Avoid sending payment card data through email, WhatsApp or spreadsheets. The gateway should handle sensitive payment information through its approved systems.

Frequently Asked Questions

Is Razorpay suitable for Shopify payment integration in India?

Razorpay is one of the commonly considered payment gateways for Indian Shopify stores and may support UPI, cards, net banking and other methods depending on account approval and current product availability. Suitability depends on your legal structure, product category, settlement requirements, Shopify setup and support expectations.

Is Cashfree available for Shopify stores?

Cashfree may provide payment integration options for Shopify merchants, subject to its current integration method, onboarding rules and account approval. Check the latest Cashfree and Shopify documentation before installing an app or requesting technical work.

Can I accept UPI payments on Shopify in India?

Yes, Indian Shopify merchants commonly use third-party gateways to accept UPI payments. The exact UPI experience depends on the gateway, the customer’s device, the UPI app and the payment flow enabled for your account.

Do I need a GST number to use a payment gateway?

Not every business has the same GST registration requirement, and the gateway’s document requirements may differ by business type. You should confirm your GST position with a chartered accountant and provide the gateway with accurate legal and tax information.

How long does Shopify payment gateway integration take?

The technical connection may be straightforward, but the overall process also depends on KYC, gateway approval, Shopify configuration, testing and any changes required for policies or checkout settings. Do not publish a fixed launch date until the account is approved and payment, refund and settlement tests are complete.

Why does a successful payment sometimes remain pending in Shopify?

The gateway may still be waiting for confirmation from a bank, UPI app or card network. Check the gateway transaction status and webhook update before fulfilling the order, and follow the provider’s process for delayed or disputed payment statuses.

Where to Start

Begin with these practical steps:

1. List the payment methods your customers actually need, including UPI, cards, net banking and COD.
2. Confirm your business structure, bank account name, GST position and website policies.
3. Compare Razorpay, Cashfree and other supported providers using settlement, refund, reporting and support requirements.
4. Complete the gateway’s KYC before planning the launch.
5. Configure Shopify products, taxes, shipping, returns and customer emails.
6. Connect the approved gateway using the current Shopify-supported method.
7. Test successful, failed, pending, cancelled, refunded and partially refunded payments.
8. Create a daily or weekly reconciliation process for Shopify, gateway and bank records.
9. Secure staff access and document who can issue refunds or change payment settings.

If you need help reviewing the Shopify setup or connecting a payment gateway, talk to the Govindani Infotech team on WhatsApp; project-specific pricing is confirmed by the team there.