Merchant Channels: how this screen works
A merchant channel is one of your shops or sales channels in QrX. Each channel has its own company details, payment provider, SMS and tracking choices, QrX app storefront and shop connections. This guide explains the channel list and every tab of the channel editor.
What you see on this screen
New Channel (top right): add a new sales channel.
Refresh (the round arrows): load the list again.
Search channels by name...: type part of a name and the list updates.
The channel list: one row per channel with Name (and its web address part below it), Currency, Locale (the main language), Status and Modified. Click Name or Modified to sort. Click a row, or the pencil under Actions, to open the channel.
Status badges: Ordering (shoppers can order in the QrX app), Visible (the shop is shown in the QrX app), Local Only (local ordering only) and Suspended (the channel is paused by QrX).
With more than 25 channels, use the arrows at the bottom to go to the next or previous page.
Add a new channel
Click New Channel.
Fill in the Channel Name (required) and, if you like, a short Description.
Click Create Channel. QrX opens the new channel in the editor so you can finish the setup.
If your plan has reached its channel limit, QrX shows an upgrade message and nothing is created.
Edit a channel
Channels shared with you show Partner Access: merchant name below the channel name in the list. The same merchant name appears below the title in the partner editor. These channels belong to that merchant, not your account. Your existing access rights stay the same.
A fulfilment partner who can open this channel sees the same editor, with the channel name in the title. Channel name, website, currency, locale and description are shown and cannot be changed. The partner can change Tracking, Defaults and Shop platforms, then press Save. Payments, Company, the API key and QrX Mobile App & Ordering stay with the merchant, and those tabs are not available. A channel the partner cannot open shows Merchant channel not found. The merchant who owns the channel still edits every tab, as described below. The partner's own defaults are edited here on the Defaults tab; the label contract and warehouse stay under Settings > Partner Access > Received > Fulfilment settings.
At the top you see the channel name and five tabs. Each tab has its own menu on the left. Your changes are kept while you switch tabs; press Save (top right) to store them. Save is only active when something changed. Use the refresh button to throw away unsaved changes and load the channel again. The arrow at the top left takes you back to the list.
Some parts save on their own and do not need the Save button: SMS switches, banners, offers, product lists and shop platform connections. This is mentioned below where it applies.
Settings tab
General: Channel Name (required), Website URL, Currency (fixed, shown for information), Locale (the main language of the channel) and Description.
API & identifiers: the API Key your own systems use to talk to QrX for this channel. The key is stored securely and is only shown in full right after you create a new one. Click the orange Regenerate API Key button and confirm with Yes, regenerate: the new key is saved at once. Copy it straight away with the copy button; it will not be shown again. Any system that still uses the old key stops working until you update it.
API access (under the API key): choose which parts of the QrX API this key may use. A key starts with Full access: it may use every part of the QrX API, also parts that are added later. To limit it, switch on Restrict this key and tick the parts the key may use. They are grouped under Returns, Inbound and Stock, for example Read stock levels, items, locations, movements, counts and containers or Adjust stock and create or change items and locations. Tick at least one part, then click Save API access; this block saves on its own. Before access is taken away, QrX asks Restrict this API key? and lists what stops under Stops working. Confirm with Restrict the key. Every part that is not ticked stops working at once, also for integrations that work today. A change can take up to 30 seconds to apply. The key then shows Restricted. Only someone who may manage sales channels can change the API access; others can only see it.
New parts under API access: Purchasing (read purchase orders and their prices; create, send and close purchase orders), Fulfilment (read pick lists) and Tasks (read team tasks). The inbound and stock parts now also cover receipts, items, locations, movements, counts and containers. A restricted key does not get the new parts by itself: tick them when the key needs them.
Payment options: choose the Payment Provider this channel uses and switch Pay by Email Link on or off.
Tracking: Send tracking updates to customers controls whether QrX sends track and trace emails and updates to your customers. UPS delivery photos adds a delivery photo to UPS updates for a small extra charge per shipment; it is greyed out when the feature is not available.
Show warehouse steps on the tracking page (under Tracking, off by default): when on, shoppers see "Being picked" and "Packed" on the tracking page before the carrier scans the parcel. This only changes the page; no extra email or SMS is sent. It needs branded track and trace on your plan; without it the switch is greyed out with the note Needs branded track and trace on your plan. A switch that is already on can still be switched off.
SMS: see below.
SMS
Payment SMS (phone verification + PIN) is Always on. It keeps payment at the door secure. The text below it says whether QrX includes it or whether it is billed to you.
Track & Trace SMS (delivery updates) is a paid extra and off by default. When you switch it on for the first time, QrX shows the exact price per SMS and an estimate per month. Click I accept the additional costs to turn it on.
Price per SMS shows the standard rate, rates per country and the QrX platform fee. If you send through your own Bird account (set up under Messaging settings), only the platform fee applies.
Once SMS is on you see This month with the number of SMS sent and the cost so far. With Track & Trace SMS on you can set a Monthly spend cap (optional): when the cap is reached, Track & Trace SMS pauses and falls back to email. Payment SMS is never paused.
These switches save immediately.
Payments tab
On the left you pick a provider. A green check shows the provider that is selected for this channel, and a line at the top says whether the provider you are looking at is the selected one. Save your other channel changes before you start a connection.
Mollie: click Connect with QrX to sign in to Mollie and allow QrX. When connected you see your Mollie organisation and profile, with Reconnect and Disconnect. If Mollie still needs information from you, a link takes you to your Mollie onboarding. Under Mollie Methods choose which payment methods shoppers can use.
Stripe: click Connect Stripe to connect an existing Stripe account or create a new one. For a new account, fill in the Legal Company Name, Company Email and Country first. If setup is not finished, the button says Continue Stripe setup. Under Stripe Payment Methods choose the methods for Stripe payment links.
MultiSafepay: click Register with MultiSafepay to open a MultiSafepay sign-up through the QrX partner link. Under MultiSafepay payment methods choose the methods to show; leave it empty to show every method enabled on your MultiSafepay account.
Payment-only fee: shows the QrX fee for payments without a shipment (a fixed EUR amount or a percent of the payment). Only QrX can change these rates.
QrX Mobile App & Ordering tab
This tab controls how your shop looks and works in the QrX app, where shoppers find and buy your products.
Ordering: Ordering Enabled lets shoppers order in the QrX app. Hide Home Categories hides the category row on your shop's home page. Show in Consumer App makes your shop visible in the app. Shop type is shown as a filter in the app's shop list.
Delivery & pickup: see below.
Banners and Offers: large images and offer cards on your shop's home page in the app (up to 10 each). Click Add Banner or Add Offer, add a title, subtitle, tag, button text and an image (required), choose where a tap goes (None, Product, Product List or Category), set the sort order and Active. A phone preview shows how it looks. You can add other languages. Banners and offers save with their own Save button.
Product Lists: curated groups of products, for example "Best sellers". Click New List, give it a List Name, and switch on Show on Home to show it on your home page. Per list use Manage products to pick the products and Home items to set their order and which ones appear on the home page.
Delivery & pickup
Offer delivery: switch delivery on or off. Then set the Delivery fee (empty means free), Free delivery from (order value that gets free delivery) and Minimum order.
Pickup: pickup is offered at each of your locations with pickup switched on. Click Manage locations to open the Locations screen.
Use time slots: let customers choose when they receive or collect their order. Set the Preparation time (minutes), Days ahead (1 to 14) and Time zone. Under Weekly windows click Add window and choose the Day, From, To and Applies to (Delivery and pickup, Delivery only or Pickup only). Use the icons to copy or delete a window.
These settings are stored with the channel's Save button.
Company tab
Identity: Legal Company Name, Trade Name and Tax Number / VAT (all required), plus Tax Office, Default VAT % (used for products without their own VAT), registration numbers.
Contact: Company Email and Company Phone (required) and the company website.
Billing contact: the Billing email where QrX sends your invoices (empty means the company email; Use company email copies it) and the Billing contact name.
Address: street, postal code, city and country (required), region, and optional latitude and longitude. Pick the Country from the list, shown as code and name (for example "NL - Netherlands"): type to search, and use the X to clear it.
Branding: upload your logo or paste a link to it. Press Save to keep it.
Shop platforms tab
Shopify: follow the three steps: install QrX from Shopify Admin, click Connect QrX in the app and allow this channel, then add QrX - Payment on delivery in Shopify Payments. Click Connect Shopify to start. When connected you see the store and its status, plus Open app, Test (checks that Shopify still accepts the connection), Stock sync and Disconnect. You never paste Shopify tokens here.
WooCommerce and Adobe Commerce: fill in the Store URL / endpoint, store identifier, API version and the access details, switch on Enable this platform and click Save on this panel. Secrets are stored encrypted and never shown again; leave the field empty to keep the stored secret.
Tips and common questions
"Channel name is required": enter a name before you create the channel.
"This field is required" on the Company tab: fill in the marked company fields; the channel cannot be saved without them.
"Delivery & pickup has errors. Fix them before saving.": QrX opens Delivery & pickup. Check amounts (for example 4.95), make sure each window ends after it starts, and add at least one window or switch time slots off.
"Select at least one supported Mollie payment method.": choose one or more methods under Mollie Methods.
"Save your channel changes before connecting.": press Save first, then start the Mollie or Stripe connection.
"Could not start Stripe Connect. Save the channel email and try again.": fill in the company email on the Company tab, save, and try again.
Someone else saved the channel at the same time: QrX shows a message and lets you reload the latest version.
"Shopify rejected the stored token.": open the QrX app in Shopify so QrX can refresh the connection, or click Reconnect.
Need help? Click Chat at the bottom of the Help Center.
Defaults
Leave settings empty to keep current behaviour. An empty selection keeps all eligible methods available. Per parcel: entered weight, then method fallback, then channel fallback. Parcels above the maximum are blocked. After scanning a single item, use this method and process the order automatically. Captured weight wins.
Separate merchant and fulfilment defaults
Merchant channel defaults apply when the merchant packs or ships. A fulfilment partner sets independent defaults for each channel on the channel’s Defaults tab. Choose allowed methods, the default method, single-item method and weight, and fallback and maximum parcel weights. Methods follow the selected label contract. Empty partner settings keep automatic selection and do not inherit merchant restrictions. Switching the label contract in Fulfilment settings clears the saved shipping defaults; choose methods for the new contract on the Defaults tab afterwards. Packing slip settings (template and automatic printing) are stored separately too: the pack station uses the values of the account that packs. Captured weight takes priority. Reprints keep purchased labels unchanged.
Shipping method defaults
Choose a default box for each shipping method and a separate box for single-item orders. Singles use their box first, then the method box. A manual packing choice wins. Boxes belong to the merchant or fulfilment partner doing the packing. Leave a box unset to keep the existing behaviour.
When a fulfilment partner edits Defaults here, Save updates that partner’s own defaults. Merchant defaults remain separate. Boxes come from the account doing the packing, even with the merchant’s label contract. An unset maximum does not limit weight; a box weight of 0.1 kg does not prevent saving.
Packing slips
Use the merchant’s design at the packing station. Default packing slip template: Choose an active packing slip template belonging to this merchant channel. Print a packing slip automatically with the label. Empty settings keep automatic printing of the standard slip. Manual printing stays available. A fulfilment partner’s packing slip settings are stored separately from the merchant’s; the partner’s pack station uses the partner’s own values. Partner PDF previews also use the partner’s own template. Previewing does not replace the archived printed packing slip.
Pack station
Allow confirming items without scanning: when this is off, the pack station hides the hand button (Confirm without scanning) on the order lines of this shop and refuses an override sent another way. Turn it off for a shop whose products have no barcodes yet. Packers also need the Pack without scanning permission, and every override is logged. Like the packing slip settings, this is stored per account that packs: a fulfilment partner sets its own value for the channel, separate from the merchant’s.
Shopify
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: importing may create transactions and send payment messages. Linked orders keep receiving updates. Orders and Activity show outcomes and times; search and export cover loaded rows. Failed events can be retried after confirmation. Stock opens the stock workspace. Full sync replaces 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. Approval expires in five minutes. Throttled work waits and resumes. Last observed and last sent quantities are separate evidence. Merchants control mappings and the independent stock push switch.
Shopify health, selected retry and product preview
Connection health in Shopify Overview and the stock workspace shows recorded access, failed order-event, stalled-stock and comparison incidents. Persistent incidents notify the notification bell after 15 minutes. Operations notification preferences apply. 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 Retry selected. Review and confirm. This requires 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. Refresh and select again after a conflict. Retrying does not change warehouse mappings or start a full sync.
Full stock 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 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. Confirmation expires after five minutes. Close and request a fresh preview if it expires or changes. Shopify rate limits delay preview reads; wait and retry. Previewing never changes Shopify inventory.
For partner-held stock, the assigned warehouse determines the stock operator before setup; the saved mapping keeps that source afterward. Warehouse stock and settings shows the operator. Its Shopify stock module and warehouse settings apply, even when the merchant stock module is off. Only goods owned by this merchant are included. Partners with Stock settings permission can configure their assigned warehouse; full sync still needs its separate permission, merchant delegation and confirmation. Revoked access stops syncing.