StoreCashierDocumentation Free 1.6.6 Pro 1.5.6 Apps 1.5.0

Pair a device PRO APP

Pairing connects one installed app to your website for one cashier. The administrator adds the device on the site and gets a one-time code (and a QR code); the cashier types the code into the app (or scans the QR on Android). From then on the app sells as that cashier, at the chosen location(s), and uses one POS device seat of your license. This page also covers seats, editing locations, new codes, revoking and deleting devices.

Where: site — Inventory Management → Settings → POS Apps · app — first screen after installing

Who can do it#

The POS Apps screen is open to administrators, users with full StoreCashier access and staff with the Settings → Manage settings permission. Others see “You are not allowed to manage POS app devices.” The cashier list offers administrators, StoreCashier and WooCommerce managers, and POS staff who have the Use POS permission.

Step 1 — Add the device on the site#

Add device card with seat counter, device name, cashier, default location and Also sells for check boxes
Settings → POS Apps → Add device. The seat line shows how many POS device seats of your license are used.
FieldWhat it doesExample / default
POS device seats: x of y in useSeats of your StoreCashier license that are taken by paired devices, and the total your package allows (Pro 0, Pro + POS Apps 2, Business 5, plus extra-device add-ons). The badge shows the package.1 of 2 in use · Pro + POS Apps
Refresh device licensesAsks the license server for the current seat usage and renews the device license of every paired device now (normally this happens by itself weekly).—
Add POS devicesOpens your account page to buy extra POS device seats.—
Device name *Name shown on the site (devices list, sync issues) and in the app header. Use the counter or machine name. The name typed here wins over the name typed in the app.Counter 1 laptop
Cashier *The WordPress user the app sells as. The app uses exactly this user’s POS permissions: payment accounts, maximum discount, price editing, holds, returns, register, Mobile Plans permissions and allowed locations. Cannot be changed later — add a new device for another cashier.Daniel Brooks
Default business location *The location the app sells for when it starts. Only locations the chosen cashier may use can be selected.Nova Mart – Downtown
Also sells forExtra locations this device may switch to (shown when you have more than one location). The default location is always ticked. See Several locations on one device.Nova Mart – Uptown
Add device & show pairing codeCreates the device (status Waiting for pairing) and shows the pairing code once.—

The pairing code and QR code#

Pair the POS app card with a QR code, the code K7QM-4XPA, the site address and the expiry time
The code is shown only once. It works once and expires after 15 minutes.
  • Code — 8 characters, shown as ABCD-EFGH. Upper / lower case, spaces and the dash do not matter when typing it.
  • Valid 15 minutes and once. It is not shown again; if it expired or got lost, use New pairing code in the device’s actions.
  • QR code — contains the site address and the code, for the Android app’s Scan QR code button.
  • Site address — what to type in the app (your home URL).

Step 2 — Pair in the app#

The app pairing screen with language, site address, pairing code and device name
First start of the app: language, site address, pairing code, device name.
  1. Choose the language at the top right (English or বাংলা) — it can be changed later in Settings.
  2. Site address: your shop address, e.g. https://shop.example.com. It must be HTTPS (local development addresses are the only exception).
  3. Pairing code: the 8 characters from the site.
  4. Device name: pre-filled with “Windows POS” / “Android POS”. Only used when the admin left the name empty.
  5. Tap Pair device. On Android you can instead tap Scan QR code and point the camera at the QR on the POS Apps screen — the site and code are filled in for you.
  6. The app shows “Downloading products, customers and settings…”, then opens the register. It is ready to sell, also offline.

Behind the scenes the app sends the code with its stable device id; the site checks that a seat is free, gets a signed device license (certificate) for this device from the license server, gives the app a secret access token and the device license, and marks the device Active. The token is stored encrypted on the device.

Pairing messages#

Message in the appMeaningFix
This pairing code is invalid or expired.Wrong code, already used, or older than 15 minutes.Site: device actions → New pairing code.
Your plan's POS device seats are all in use — ask the shop admin to add devices or release an old one.Every seat is taken.Revoke / delete a device you no longer use, or buy an extra device. The code stays valid — try again with the same code.
Your shop's StoreCashier plan does not include POS app devices…The license is the plain Pro package (0 devices).Upgrade to Pro + POS Apps / Business or add extra devices.
The shop's website could not get a device license from the StoreCashier license server right now…The site could not reach the license server, or the license is suspended / expired.Wait a few minutes and try again with the same code; check the license in StoreCashier Pro.
Too many attempts10 failed pairing attempts from the same network within 15 minutes.Wait 15 minutes.
The server cannot be reached / HTTPS requiredWrong address, no internet, or http://.Check the address, use https://.

On the site, adding a device while all seats are used shows the same warning before any code is issued:

POS Apps screen showing the warning that the license does not include POS app devices
A license without free seats: the site explains it and links to “Add POS devices to my license”.

Step 3 — Manage devices#

Devices table with name, platform, cashier, location, app version, last seen, status and app license
The Devices list (example with four devices).
ColumnWhat it shows
Name / Platform / CashierDevice name, Windows or Android (filled after pairing), the WordPress user it sells as.
LocationDefault location in bold, then the other locations (“first = default”).
App version / Last seenReported by the app on every request — useful to see who still runs an old version or has been offline for long.
StatusWaiting for pairing (code issued, not used yet) · Active (paired) · Revoked (locked, must be paired again).
App licenseThe device license state: Licensed, Offline grace, Device seat needed soon, License expired, Seat released, No device seat, No free device seat, Not checked. Explained in Device license.
Actions menu of a device: Edit, New pairing code, Get device seat, Revoke, Delete
Device actions.
ActionWhat happens
EditChange the name, the default location and the other locations (the cashier is fixed). The app picks up the change at its next sync. Sales already queued for a location you remove are refused at upload and appear in Sync issues.
New pairing codeIssues a fresh 15-minute code for this device — for a first pairing that expired, or to re-pair the same device (e.g. after “Pair again”). Re-pairing the same installation keeps its seat and its unsynced sales.
Get device seatShown when an active device has no valid seat (missing, released, expired, or a device paired before Pro 1.5.6). Requests a seat and a device license now; the app receives it at its next sync.
RevokeLocks the app at once (it asks for a new code), and frees its seat. Sales not yet uploaded stay on the device and upload after it is paired again. Use it for a lost or replaced device.
DeleteRemoves the device row and frees its seat. Sales it already uploaded are kept on the site.
Edit device form with name, fixed cashier, default location and Also sells for
Edit device.

Pairing again#

The app shows the pairing screen again when the device was revoked, when its token is no longer valid, or when you press Pair again on a license banner. In that mode the site address is fixed and the screen says “Sales saved on this device are kept and will upload after pairing.” Get a new code from the device’s actions and enter it. Use a different site (erases local data) is only for moving the device to another shop — it warns how many unsynced sales would be lost.

To retire a device yourself: app Settings → Log out & unpair this device. This is blocked while sales are waiting to sync, removes the token and all local data, and you should also revoke the device on the site.

Does the same PC need a new seat after reinstalling?

No. The app keeps a stable device id; pairing the same installation again re-uses its seat. A fresh Windows user profile or a new tablet counts as a new device.

Can I pair before the cashier user exists?

No. Create the user first (Store Staff) and give them POS permission and the right locations, then add the device.

The device shows “Waiting for pairing” for days.

The code was never used. Use New pairing code when you are at the device, or delete the row.