QrX for Shopify
The QrX Shopify app connects your Shopify store to QrX. Your Shopify orders flow into QrX with the customer, address and parcels, your shoppers can choose to pay on delivery, and when the payment at the door succeeds, QrX marks the Shopify order as paid.
What You Need
A Shopify store where you can install apps and manage payment settings.
An approved QrX merchant account. New merchants sign up on the QrX portal first (plan, company details and QrX approval). The app does not replace that signup.
A QrX merchant channel for this store.
Setup and availability for your account are confirmed with the QrX team. If you cannot find the app, contact QrX support or book a demo at qrx.eu/book-demo.
Two Ways to Connect
This article describes installing the QrX app from Shopify. You can also connect with your own Shopify app: a guided setup in the QrX portal that needs no Shopify App Store listing. See the article "Connect Shopify with Your Own App". A store can use only one of the two connections.
Step 1: Install and Connect
Install the QrX app and open it from your Shopify admin. You do not need to enter your shop domain.
Click Connect QrX and continue to QrX with the same login as the QrX portal (email, password and the verification code sent to your email).
Pick the QrX channel this store should use and allow the connection. You return to Shopify, and the app shows that the store is connected. If that channel is already connected to another Shopify store, the consent screen says so: allowing moves the connection to this store, and the other store stops receiving QrX orders until you connect it again.
Step 2: Add the Payment on Delivery Method
Shopify does not let an app create this payment method for you, so you add it once yourself:
In the app, open the Pay on delivery section and click Open Payments.
Add a manual payment method named QrX - Payment on delivery. The app gives you the name, additional details and payment instructions to copy.
Return to the app and click I've added it. When the app finds the method, it shows "QrX payment method is ready".
Shoppers who choose this method at checkout pay when the parcel is handed over, by scanning the QrX QR code on the parcel.
What the App Does
Orders: new Shopify orders sync into QrX with the customer, address and parcels. Open them from the Orders list in the app or in PortalX. With QrX warehouse stock on, they reserve stock in QrX. QrX does not change stock levels in Shopify yet.
Payment: when the door payment succeeds, QrX marks the Shopify order paid, and writes tracking to Shopify when a shipping label exists. Orders packed at the QrX pack station are marked fulfilled in Shopify with tracking.
Labels: shipping labels print from your QrX shipping rules. The print status is shown on the Orders list.
Products: tag a product
qrxin Shopify and QrX stores it as a draft. It only goes live in QrX after you publish it in QrX. Remove the tag or delete the product in Shopify and QrX takes it offline.Privacy requests: Shopify customer data requests appear under Privacy requests in the app, where you can download the requested data.
Switching to Simple stock: when you switch QrX stock from Full WMS to Simple stock, the wizard asks for each Shopify location on a warehouse that is merged whether to link it to the warehouse you keep or to unlink it. Shopify stock sync runs at Full WMS only.
Disconnecting
Use Sign out in the app to disconnect the store from QrX. New orders will not go to QrX until you connect again.
Connection controls, stock sync and health
Open Merchant channels, Shop platforms, Shopify. Active fulfilment partners can select shared merchant channels. New connections import orders created from activation. Overview changes the UTC start or pauses new imports. Earlier dates show a preview and need confirmation, because importing may create transactions and send payment messages. Linked orders keep receiving updates. Orders and Activity show outcomes and times, and search and export cover the loaded rows. Failed events can be retried after confirmation.
Stock opens the stock workspace. Full sync replaces the mapped Shopify available quantities, including zero, using live stock. It requires its own user permission, explicit merchant delegation for partners and a fresh confirmation per run. The approval expires after five minutes, and throttled work waits and resumes. Last observed and last sent quantities are separate evidence. Merchants control the mappings and the independent stock push switch.
The full sync confirmation includes a read-only product and location table with QrX free, Shopify available, commitments, QrX reservations and target available. Scroll to load more products. The target deducts the safety buffer and the commitments not already reserved in QrX. Zero and negative targets are shown. Unresolved, multiple-variant and unstocked items show a review warning instead of a guessed quantity. Quantities are observations and are recalculated with compare-and-set when the worker processes them. If the confirmation expires or changes, close it and request a fresh preview. Shopify rate limits delay preview reads, so wait and retry. A preview never changes Shopify inventory.
Connection health in Shopify Overview and in the stock workspace shows recorded access, failed order-event, stalled-stock and comparison incidents. Persistent incidents notify the notification bell after 15 minutes, following your Operations notification preferences. Each incident alerts once, including after its notification is read, and clears after recovery. No observations does not prove the shop is healthy: first observed and last checked times show the age of the evidence.
In Stock sync, select up to 100 failed items, then choose Retry selected, review and confirm. This requires the Full Shopify stock sync user permission and, for fulfilment partners, the merchant's Full Shopify stock sync capability for that channel. The server rechecks delegation and each row's version. Changed rows, in-flight batches, removed mappings and active full syncs are refused together, so refresh and select again after a conflict. Retrying does not change warehouse mappings or start a full sync.
Common Problems
"Could not finish Connect" with a reason: the message names what to do (the connect link expired or was already used, the account is waiting for approval, the app was uninstalled from the store). Resolve that, then start the connection again from the app. "Connect state did not match": start the connection again from the app.
Sign-in fails: use the same email and password as the QrX portal. If you do not have an approved QrX account yet, create one on the QrX website first and wait for approval.
Payment method "Not found yet": check that the manual payment method name is exactly QrX - Payment on delivery, then click I've added it again.
Orders not appearing: check that the store still shows as connected in the app, then open the app again so it can refresh the orders.
When to Contact Our Support Team
Contact QrX support at [email protected] when an order paid at the door is not marked paid in Shopify, labels fail to print after your shipping rules are set up, or the store shows as connected but orders do not sync. Include your shop domain, the Shopify order number and the QrX transaction id if you have it.