Connect Shopify with Your Own App
You can connect your Shopify store to QrX without installing QrX from the Shopify App Store. You create a small private app called QrX inside your own Shopify, and QrX guides you step by step. Shopify gives QrX only the access you approve, and you can remove it at any time. It takes about 10 minutes and needs no developer.
What You Need
An approved QrX merchant account and a QrX merchant channel for this store.
To be the store owner, or a staff member who is allowed to develop apps in Shopify.
A free platform connection on your QrX plan. A store can only have one connection: if it is already connected through the QrX app from the Shopify App Store, or to another QrX account, QrX tells you.
The Six Steps
Open Merchant channels, choose your channel, open the Shop platforms tab and click Start guided setup. Your progress is saved automatically, so you can leave and continue later.
Create the app. In your Shopify Dev Dashboard, create an app manually. QrX shows every value to copy, in the order of Shopify's form, with a picture: the app name, the App URL that brings you back to QrX, and the permissions line. Untick "Embed app in Shopify admin" and make sure "Use legacy install flow" is unticked, otherwise the install never finishes.
Copy your credentials. Paste your store address, the Client ID and the Client secret of your app. QrX checks them with Shopify at once and stores the secret encrypted. QrX can never show the secret again.
Install the app. Install the app on your store in Shopify. Shopify brings you back to QrX, which confirms that the install is genuine. The link is valid for 10 minutes.
QrX checks the connection. QrX reads your store to confirm the credentials, the store, the permissions, the order details, the products and the locations, and connects the order updates. During these checks QrX only reads from Shopify. Every problem shows how to fix it, and you can check again.
Add the payment method. To let customers choose payment on delivery, add the manual payment method QrX - Payment on delivery in Shopify Payments, with the texts QrX gives you. QrX cannot see this setting, so you confirm it yourself. Skip this step if you only ship with QrX.
Choose which orders QrX imports. Import orders from now on, or from a date you pick, with a preview of how many orders match. A new connection stays paused until you choose.
What QrX Does in Your Shop
It reads your orders, products, locations and stock levels.
It adds tags, marks orders as paid when a customer pays at the door, and creates fulfilments with tracking when you ship with QrX.
It tells Shopify not to send its own shipping email, so your customer does not receive two.
It changes stock only if you turn on stock sync, and only for the locations you match.
It never changes prices, titles, descriptions or customers, and it never deletes anything in your shop.
After the Setup
The Shopify tab shows the health of the connection: credentials, permissions, order updates and the payment method. QrX also checks the connection every 30 minutes and collects orders that a missed delivery left behind. Click Check again to check at once. After you replace the secret in Shopify, use Update credentials. Persistent problems appear in the notification bell. Click Disconnect to disconnect: QrX deletes the stored Client secret and keeps your orders and history.
Common Problems
Shopify opens a page called example.com after the install: your first version still has "Use legacy install flow" switched on. In your app click New version, switch it off, release it, then install the app again.
"The secret does not match this Client ID": copy the secret again from your app's Settings page, without spaces before or after.
Permissions are missing: in your app open Versions, create a new version, paste the permissions line from step 1, release it, then approve the update in your Shopify admin.
Customer details are hidden by Shopify: Shopify has not allowed the app to read customer details. Contact QrX support with your store address.
The app was uninstalled or the secret was replaced: no new orders arrive. Install the app again, or update the credentials, on the Shopify tab.
When to Contact Our Support Team
Contact QrX support when a check stays red after you followed the fix, when QrX says the store belongs to another QrX account, or when you cannot find the Dev Dashboard in your Shopify. Send the details from the Help button in the guided setup. They contain no passwords or secrets.