Shopify

Updated 11 November 2026

Overview

This article covers the Shopify page under Integrations. Shopify is the backbone of the returns flow: ReturnZen reads orders, products, customers, inventory, locations, store credit, timezone and currency from your store, and writes returns, refunds, gift cards, store credit and exchange orders back to it. Nothing works without it. The connection is created during onboarding; this page is where you check it, test it, replace its credentials or disconnect it.

Use the menu on the left to quickly navigate this article.

Before you start

• A custom app in your Shopify admin with the permissions ReturnZen asks for. See Connecting your Shopify store.
• The Owner login. Only the store Owner can connect, test, replace or disconnect the Shopify connection; other members see the page read-only with the note Only the store Owner can connect, test, replace or disconnect the Shopify connection.

The connection

In the admin, go to Tools > Integrations > Shopify.

Screenshot

Tools > Integrations > Shopify, the status pill, the connection details and the Test Connection, Replace Credentials and Disconnect Shopify buttons

• Store domain: your store's myshopify.com address, typed without https://. It is asked for on the connect form, which shows only while no credentials are saved, together with the Client ID and Client Secret from your custom app. Click Connect to Shopify to save them.
• Status: a pill at the top of the page. No credentials saved before a store is connected. Your credentials not verified when a Client ID and Secret are saved but Shopify has not yet accepted them from here. Your credentials accepted once it has. Your credentials cannot be read when the saved pair can no longer be decrypted.

• Store, Client ID, Auth, API version: read-only facts about the connection while it is connected. Auth reads Client Credentials Grant · auto-refresh 24h: access tokens refresh on their own every 24 hours and there is nothing to renew by hand. API version shows the version ReturnZen asked for and whether Shopify's last answer matched it.

  Note: These values cannot be edited while the store is connected. To change the credentials use Replace Credentials; to connect a different store, disconnect this one first.

• Test Connection: asks Shopify now and reports the shop name it answered with: Connection test passed: Shopify accepted these credentials for [shop name]. On a pair that was saved but never verified, a pass connects the store. It costs nothing and changes nothing else.

• Replace Credentials: opens a form for a new Client ID and Client Secret for the same store. The store domain stays fixed. Nothing is saved until Shopify accepts the new pair; if Shopify rejects it or cannot be reached, your current connection stays as it is. A saved pair that can no longer be read is the one exception; see Credentials cannot be read below.
• Disconnect Shopify: opens a confirmation that reads This clears the stored Client ID and Secret for [store], and order lookup, label purchase and processing stay paused until a store is connected again. Shopify shows a Client Secret only once, so make sure you have a copy before you continue. Click Keep Credentials to back out or Disconnect Shopify to confirm.

Banners on the page

• Credentials not verified: the saved Client ID and Secret are already in use for order lookup, label purchase and processing, but Shopify has not accepted them from this page, usually because they were saved during a Shopify outage or behind a blocked network path. Nothing re-checks them on a schedule. Click Test Connection; if Shopify accepts them the status changes to Your credentials accepted. The other ways out are Replace Credentials (needs a new Client Secret from Shopify) and Disconnect Shopify.
• Credentials cannot be read: the page reads ReturnZen cannot read this store's Shopify credentials. Replace them to reconnect. (or, for a member who is not the Owner, Ask the store Owner to replace them.). Click Replace Credentials and paste a fresh pair. In this state nothing is saved unless Shopify accepts the new credentials or cannot be reached. If Shopify cannot be reached, during an outage or a temporary DNS failure for example, the new credentials are saved in place of the ones that cannot be read and the store does not show as connected yet; click Test Connection once Shopify is reachable again. If the store's address cannot be found at all, nothing is saved.
• Shopify API version mismatch: Shopify is answering on a different API version than the one ReturnZen asked for. Your returns still process. The banner reads Shopify is answering on API version [X], not the [Y] this app asked for, and your returns are still being processed. Ask your administrator to update the pinned API version, including any version saved for this store. Pass it to support.
• Missing permissions: when the custom app lacks a permission ReturnZen needs, the page says which. Add it on the custom app in Shopify; see Connecting your Shopify store.

How it works

Disconnecting clears your stored pair. Afterwards ReturnZen can no longer look up orders, buy labels for them or process returns, and the page confirms it. Returns already recorded stay in the workspace, and reconnecting the same store with a new pair picks them up again.

Important: A different Shopify store is a different workspace. The store domain cannot be edited in place; every return recorded in the workspace belongs to it.

FAQ

Do I need to set my store timezone? No. Every date and time in ReturnZen is shown in your store's timezone: the returns list, the return page, reports, the dates written into your Shopify order notes, warranty date ranges, and the date a shopper is told their return window closes. ReturnZen reads the timezone from your Shopify store settings. Change it in Shopify and ReturnZen follows on the next sync.

Does ReturnZen work with bundles? Yes. Shopify's own bundles and Bundly are recognised, and other bundle apps can be described in a list under Policy > General, Bundles. Each piece shows which bundle it came from, you can require the whole set back, and you can decide what kept pieces are worth when only part of a set comes back. See Bundles.

Please reach out to support@returnzen.app with any additional questions.