> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay-881012b3.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting & FAQs

> Troubleshoot common errors and find answers to frequently asked questions about Shopify.

<div style={{display:"flex",flexWrap:"wrap",alignItems:"center",gap:"0.35rem 0.9rem",border:"1px solid rgba(128,128,128,0.28)",borderRadius:"0.5rem",padding:"0.45rem 0.75rem",margin:"0 0 1.25rem",fontSize:"0.875rem"}}>
  <span style={{fontWeight:600}}>Available in</span>
  <span>🇮🇳 India</span>
</div>

## Integration & Setup

<AccordionGroup>
  <Accordion title="Why can't I find the Razorpay plugin on the Shopify App Store?">
    The Razorpay Shopify plugin has been renamed from **1 Razorpay** to **All-in-one Razorpay Payment Gateway**. If you are unable to find the plugin, search for **All-in-one Razorpay Payment Gateway** on the Shopify App Store or use the [direct link](https://accounts.shopify.com/store-login?redirect=settings%2Fpayments%2Falternative-providers%2F1058839) to access the app on your Shopify store.
  </Accordion>

  <Accordion title="How do I integrate All-in-one Razorpay Payment Gateway with my Shopify store?">
    Follow the [build integration](/docs/payments/payment-gateway/ecommerce-plugins/shopify/integration-steps#1-build-integration) steps to integrate All-in-one Razorpay Payment Gateway with your Shopify store.
  </Accordion>

  <Accordion title="Do I need API keys to integrate a payment app with Shopify?">
    No, API keys are not required to integrate a payment app with Shopify. OAuth is used to handle the authentication process.
  </Accordion>

  <Accordion title="I tried connecting All-in-one Razorpay Payment Gateway to my AxisRazorpay account but was unsuccessful. When I try to reconnect, the screen appears different. How should I proceed?">
    Follow the steps given below to connect All-in-one Razorpay Payment Gateway with your Razorpay account:

    1. When you try to reconnect, you will get the following screen. Click **Manage**.
           <img src="https://razorpay.com/docs/build/browser/assets/images/razorpay-secure-reconnect.jpg" alt="reconnect All-in-one Razorpay Payment Gateway" width="800" />

    2. You will be redirected to a landing page. Click **I am an existing user**.

           <img src="https://razorpay.com/docs/build/browser/assets/images/shopify-existing-merchant.jpg" class="click-zoom" alt="Existing Merchant Shopify" width="600" />

    3. Scroll down and click **Login**.

    <Info>
      **Handy Tips**

      Make sure you log in with **owner** credentials to connect Razorpay with Shopify successfully.
    </Info>

    <img src="https://razorpay.com/docs/build/browser/assets/images/shopify-login-v2.gif" alt="Shopify login" alt="Razorpay login" width="600" />

    4. Click **Activate** on the activation screen on your Shopify Dashboard. <br />
           <img src="https://razorpay.com/docs/build/browser/assets/images/shopify-1razorpay-activate.jpg" class="click-zoom" alt="Shopify Authorize" width="600" />

    All-in-one Razorpay Payment Gateway now appears as a Payment Gateway on your Shopify Store checkout.<br />

    <img src="https://razorpay.com/docs/build/browser/assets/images/shopify-v2-checkout.jpg" class="click-zoom" alt="Shopify Checkout" width="600" />

    This completes your integration.
  </Accordion>

  <Accordion title="Why is the Activate button disabled?">
    The Activate button may be disabled due to the plugin being integrated into another account or keyless authentication not being enabled. To enable the Activate button:<br />

    * **Check for Integration with Another Account:** Verify if you have integrated your Shopify Store with a different Razorpay MID. If yes, revoke access under applications and retry the All-in-one Razorpay Payment Gateway [integration steps](/docs/payments/payment-gateway/ecommerce-plugins/shopify/integration-steps#1-build-integration). <br />
    * **Enable Keyless Authentication:** Ensure keyless authentication is enabled from Razorpay's end. To enable keyless authentication contact our [Support team](https://razorpay.com/support/).
  </Accordion>

  <Accordion title="I am getting the following error message, &#x22;Email ID Mismatch.&#x22; Why?">
    This error occurs when there is a discrepancy between the email IDs used in Shopify and Razorpay.<br />
    You can [update the email ID](/docs/payments/dashboard/account-settings/account-details#update-login-email) on Razorpay to match the one used in Shopify. Verify that the email ID associated with owner access on Razorpay matches the one used in Shopify.
  </Accordion>

  <Accordion title="I get a blank screen when I try to log in to the  account while integrating/migrating All-in-one Razorpay Payment Gateway, and I am unable to proceed further. How to proceed further?">
    A blank screen appears when the email id used to log in to Razorpay doesn't match the email ID registered with owner access on Razorpay. Make sure that you log in using the correct email ID.
  </Accordion>

  <Accordion title="How do I uninstall Razorpay payment apps from Shopify?">
    To uninstall any Razorpay payment app from your Shopify store, follow these steps:

    1. Log in to your Shopify admin panel and navigate to **Settings**→**Payments**.
    2. Click **Add payment methods**.
    3. Click Search by provider and type **Razorpay**. This will show all the Razorpay payment apps installed on your Shopify store. Click the Razorpay app that you wish to uninstall.
           <img src="https://razorpay.com/docs/build/browser/assets/images/search-razorpay-payment-provider.jpg" alt="Search Razorpay in Payment Providers" width="800" />
    4. Scroll down to the bottom and click the **Uninstall** button to remove the app from your Shopify store.
           <img src="https://razorpay.com/docs/build/browser/assets/images/uninstall-app.jpg" alt="Uninstall the app" width="800" />

    This will successfully uninstall the selected Razorpay payment app from your Shopify store.
  </Accordion>

  <Accordion title="What should I do if I am confused between legacy and current plugin versions?">
    To avoid confusion, uninstall the legacy version of the plugin and [re-install](/docs/payments/payment-gateway/ecommerce-plugins/shopify/integration-steps#1-build-integration) the current plugin version (All-in-one Razorpay Payment Gateway).
  </Accordion>

  <Accordion title="Our Payment Gateway stopped displaying after migrating to Shopify. How can we reactivate it?">
    After migrating your website to Shopify, you need to integrate with the official Shopify All-in-one Razorpay Payment Gateway plugin, as your previous Payment Gateway integration from the old platform will not be carried over. Follow the [integration steps](/docs/payments/payment-gateway/ecommerce-plugins/shopify/integration-steps) and once activated, your payment gateway will be displayed at checkout, allowing you to accept payments.
  </Accordion>
</AccordionGroup>

## Migration to All-in-one Razorpay Payment Gateway

<AccordionGroup>
  <Accordion title="Why do I need to upgrade to All-in-one Razorpay Payment Gateway?">
    Shopify has launched a new payment platform, which requires existing and new payment apps to meet a new set of secure guidelines. Razorpay has built a new app, All-in-one Razorpay Payment Gateway, that complies with these new rules.

    <Warning>
      **Watch Out!**

      Your customers' payments will fail if you do not upgrade to the All-in-one Razorpay Payment Gateway app at the earliest. So, you must upgrade to All-in-one Razorpay Payment Gateway to provide an uninterrupted payment experience to your customers.
    </Warning>
  </Accordion>

  <Accordion title="How do I upgrade to All-in-one Razorpay Payment Gateway?">
    You can upgrade to All-in-one Razorpay Payment Gateway by following a simple migration process. Know more about [how to migrate to All-in-one Razorpay Payment Gateway](/docs/payments/payment-gateway/ecommerce-plugins/shopify/migration-steps).
  </Accordion>

  <Accordion title="Who all need to migrate to All-in-one Razorpay Payment Gateway app?">
    All Shopify and Shopify Plus merchants must migrate to the All-in-one Razorpay Payment Gateway payments app to continue accepting payments without service disruptions.
  </Accordion>

  <Accordion title="Who can perform the migration process for All-in-one Razorpay Payment Gateway app?">
    Only a Shopify Store Owner or Administrator can complete the migration for a Shopify account. They will need Razorpay account credentials to connect the two applications.
  </Accordion>

  <Accordion title="What changes for me as a  merchant after I upgrade to All-in-one Razorpay Payment Gateway?">
    Nothing will change for you or your customers if you upgrade to the All-in-one Razorpay Payment Gateway app. If you do not migrate, Razorpay will not appear as a payment option for your customers once the old Razorpay app is deprecated.
  </Accordion>

  <Accordion title="What if I do not deactivate the older Razorpay plugin?">
    If you do not deactivate the older Razorpay plugin, two Razorpay payment gateways will be visible to your customers on your store checkout, which may lead to confusion.
  </Accordion>
</AccordionGroup>

## Checkout and Payment Issues

<AccordionGroup>
  <Accordion title="My customer is getting the following error when they make payments on my Shopify store, &#x22;There was an issue processing your payment. Try again or use a different payment method.&#x22; What should I do?">
    Your customers may get the following error when making payments.

    <img src="https://razorpay.com/docs/build/browser/assets/images/econ-shopify-payment-error.jpg" alt="Shopify page payment error" width="500" />

    Uninstall and reinstall the All-in-one Razorpay Payment Gateway from your Shopify store to resolve the error.

    To uninstall the app:

    1. Open your Shopify store in incognito mode.
    2. Navigate to **Settings** → **Payments**. Click **Manage on All-in-one Razorpay Payment Gateway**.
    3. Go to **Deactivate All-in-one Razorpay Payment Gateway** and click **Uninstall All-in-one Razorpay Payment Gateway**. This uninstalls the All-in-one Razorpay Payment Gateway app.

    Follow the [build integration](/docs/payments/payment-gateway/ecommerce-plugins/shopify/integration-steps#1-build-integration) steps to install the plugin again.

    <Warning>
      **Watch Out!**

      Ensure you uninstall and reinstall the app instead of only deactivating it.
    </Warning>

    If your plugin still does not accept payments, contact [Support team](https://razorpay.com/support/).
  </Accordion>

  <Accordion title="Why is my Shopify checkout showing only Razorpay Direct (cards) instead of all payment methods?">
    You might have only integrated with Razorpay Direct - Credit Card Plugin, which supports card payments only. To accept UPI, Netbanking, Wallets and Cards at checkout, you need to [integrate with All-in-one Razorpay Payment Gateway](/docs/payments/payment-gateway/ecommerce-plugins/shopify/integration-steps), which is Razorpay's full payment gateway app for Shopify.
  </Accordion>

  <Accordion title="The Razorpay payment option has disappeared from my Shopify checkout after I added another payment provider. Even after removing it, Razorpay does not show up and I see the error &#x22;This store can't accept payments right now.&#x22; What should I do?">
    Active payment method customisations typically cause this issue in your Shopify admin. When adding multiple payment providers, these customisations may conflict and prevent Razorpay from appearing at checkout.

    To fix this, follow the steps below:

    1. Navigate to **Shopify Admin** → **Settings** → **Payments** → **Payment Method Customizations**.
    2. **Disable or remove all customizations** listed under this section.
    3. Save the changes and refresh the checkout page.

    Once the payment customizations are removed, the Razorpay payment option should reappear at checkout.

    If the issue persists, contact our [Support team](https://razorpay.com/support/).
  </Accordion>

  <Accordion title="How can I test a payment for All-in-one Razorpay Payment Gateway on the Shopify store?">
    You can test a payment for All-in-one Razorpay Payment Gateway on the Shopify store by switching to test mode. Know more about [how to test a transaction in test mode.](/docs/payments/payment-gateway/ecommerce-plugins/shopify/integration-steps#21-make-a-test-transaction-in-test-mode)

    <Info>
      **Handy Tips**

      Once you successfully make a test transaction, ensure you uncheck the **Enable test mode** option to accept live payments.
    </Info>
  </Accordion>

  <Accordion title="After migrating to All-in-one Razorpay Payment Gateway, the checkout option for All-in-one Razorpay Payment Gateway appears at the bottom of the list of gateways. Is it possible to move the  checkout option to the top of the list of gateways?">
    No. It is not possible to rearrange the order payment options via the store settings of the Shopify Dashboard as it is a limitation from Shopify's end.
  </Accordion>

  <Accordion title="How can I enable automated payment receipts with GST split?">
    Razorpay facilitates only payment collection. The partner is solely responsible for sending invoices or payment receipts with GST details to customers. To provide GST-compliant receipts, partners can use [Razorpay Invoice](/docs/payments/invoices) product when collecting payments.
  </Accordion>
</AccordionGroup>

## Account Management

<AccordionGroup>
  <Accordion title="Can I connect two merchant ids (MIDs) to the same Shopify Store?">
    No, currently you can connect only one MID to your Shopify Store.

    <Info>
      **Handy Tips**

      Make sure you log in using the correct Razorpay merchant id (MID) credentials via the Shopify Dashboard.
    </Info>
  </Accordion>

  <Accordion title="Can I integrate a second Razorpay account with my Shopify store?">
    No, Shopify currently supports only one Razorpay account integration per store. If you want to integrate a different Razorpay account, you need to [deactivate](#8-how-do-i-uninstall-razorpay-payment-apps) the existing integration first and then [activate](/docs/payments/payment-gateway/ecommerce-plugins/shopify/integration-steps) the new account.
  </Accordion>

  <Accordion title="I have two ecommerce websites owned by my company. If I connect both websites to my Razorpay account, will the customers be redirected to the correct webpage after payment?">
    Yes, when customers pay through Razorpay on either of your connected websites, they will be redirected to the website they purchased from.
  </Accordion>
</AccordionGroup>

## Pricing and Settlements

<AccordionGroup>
  <Accordion title="Will I be charged extra for integrating/migrating to All-in-one Razorpay Payment Gateway app?">
    No, there will be no additional charges. Your pricing plan will remain the same as earlier.
  </Accordion>

  <Accordion title="When will my funds be settled?">
    Funds will be settled as per the existing settlement schedule. There will be no change to it.
  </Accordion>
</AccordionGroup>

## Verification and Order Processing

<AccordionGroup>
  <Accordion title="Should I verify a payment on Razorpay before processing an order on Shopify?">
    Yes. The Razorpay Shopify integration works on payment auto-capture mode, so most Razorpay authorised payments get auto-captured. However, there is a 0.5% chance that an authorised payment encounters a gateway capture failure and gets auto-refunded. Before processing an order, verify the payment status on the [Razorpay Dashboard](/docs/payments/dashboard) or reconcile it from the [reports](/docs/payments/dashboard/reports).
  </Accordion>
</AccordionGroup>

## Features and Limitations

<AccordionGroup>
  <Accordion title="Can I enable Subscriptions on my Shopify store?">
    No, Shopify does not support Subscriptions. The Ecommerce platforms that support Subscriptions are Woocommerce, Magento, and Open Cart.
  </Accordion>

  <Accordion title="Does the Shopify All-in-one Razorpay Payment Gateway plugin support 3 or 0 decimal unit currencies?">
    The Shopify All-in-one Razorpay Payment Gateway plugin currently supports only currencies that use 2 decimal units. For example: USD, EUR, INR. It does not support currencies with 0 decimal (for example, JPY) or 3 decimal units (for example, BHD).
  </Accordion>

  <Accordion title="How do I integrate Meta Pixel to accept payments through Meta Ads?">
    Razorpay does not provide a direct plugin integration for accepting payments through Meta Ads. However, you can use Razorpay Payment Pages with [Facebook Pixel and Google Tracking ID](/docs/payments/payment-pages/plugins-add-ons) to track payments and conversions from your Ad campaigns.
  </Accordion>

  <Accordion title="Can I use Razorpay Route API with my Shopify store?">
    No, Razorpay Route API is not supported for Shopify integration. Only the [All-in-one Razorpay Payment Gateway plugin](/docs/payments/payment-gateway/ecommerce-plugins/shopify/integration-steps) is supported for Shopify stores.
  </Accordion>
</AccordionGroup>