StoreCashierDocumentation Free 1.6.6 Pro 1.5.6 Apps 1.5.0

Device license (POS device seats) PRO APP

The POS apps have no license key. Your website’s StoreCashier Pro license includes a number of POS device seats; each paired app uses one. The website requests a signed device license (certificate) for the app when it pairs, renews it every week and checks it on every upload. This page explains the seats, the status card in the app, every status and message, and how to fix each one.

Where: app — Settings → Device license · site — Settings → POS Apps (seat line and “App license” column)

How it works#

  • One key per purchase. The key goes into the StoreCashier Pro plugin only. The apps never talk to the license server — only your website does.
  • Seats by package: Pro 0 · Pro + POS Apps 2 · Business 5 · each Extra POS device add-on +1. Windows and Android count the same.
  • At pairing the site reserves a seat and hands the app a device license tied to that device and that shop. If no seat is free, pairing is refused and the code stays valid.
  • On every request the app sends its device license back; the site checks it before accepting a sale or any other change. Reading data (catalogue, reports) keeps working even when the license has a problem.
  • Renewal: a device license is valid 30 days and is renewed after 7 days. The site renews it during its weekly license refresh and when the app checks in; the app picks up the new one automatically.
  • Offline grace: the site still accepts a device license up to 7 days after it expired, so a device can be away from the shop for about 37 days before uploads wait for a renewal. Selling offline itself is never blocked.
  • Freeing a seat: Revoke or Delete the device on the site. There is no “deactivate” in the app.
Sales are never lost because of a license problem. When the site refuses an upload for a license reason, the sale stays in the outbox (status waiting) with the reason, a banner explains what to do, and the sale uploads as soon as the problem is fixed.

The Device license card in the app#

Device license card: status Active, shop, package Pro + POS Apps with 2 seats, plan, device, valid until, next renewal, last refresh, stored in
Settings → Device license (read-only).
RowWhat it shows
StatusThe state the site reports for this device (see the table below).
ShopThe shop domain the device license belongs to.
PackageStoreCashier Pro / Pro + POS Apps / Business and “N POS device seats in the plan”.
PlanLifetime, Yearly or Monthly (+ “until” date for subscriptions).
This deviceDevice name and the last 6 characters of the device id (useful when talking to support).
Valid until / Next renewalExpiry of the current device license (30 days) and when the site renews it (7 days).
Last refreshWhen the app received the current license, and when it last checked with the site.
Stored inWhere the license and token are kept: Windows DPAPI (Electron safeStorage) or the Android Keystore.
Check nowAsks the site at once (needs internet) and retries waiting uploads. Toast “Device license checked.”

The card ends with “Managed by your shop — ask the administrator (WP Admin → Inventory Management → Settings → POS Apps). Revoking or deleting a device there frees its seat.”

Statuses (app and site)#

App statusSite “App license” badgeMeaningWhat to do
ActiveLicensed (green)Valid device license.Nothing.
Expired – accepted until <date>Offline grace (amber)Expired, inside the 7-day grace.Connect the device to the internet so the site can renew it.
Expired – uploads wait until the shop renews itLicense expired (red)Older than expiry + 7 days.Connect the device; the site renews when it can reach the license server. Check that the shop’s license is active.
Removed from the shop – pair this device againSeat released (red)The seat was released (device revoked, seats reduced, or released from your account).Site: Get device seat (if a seat is free) or pair again with a new code.
No device license yetNo device seat (red)The device has no seat.Site: Get device seat, or free a seat first.
No free device seatNo free device seat (red)No seat and all seats are used.Revoke a device you no longer use or add POS devices.
No device license yet – works until <date>Device seat needed soon (amber)Paired before Pro 1.5.6; works for a 14-day transition period and gets a seat automatically when one is free.Make sure a seat is free before the date.
Not required by this shopNot checked (grey)Enforcement is switched off (development sites).Nothing.

Banners and messages#

Orange banner This device was removed from the shop license — pair it again, with a Pair again button; the queued sale shows the same reason
A license banner. The waiting sale stays in the queue with the reason.

License banners appear below the header (after the “app too old” banner). Each has one button: Pair again, Check now or Device license.

MessageCause (site code)Fix
Your plan's POS device seats are all in use — ask the shop admin to add devices or release an old one.app_license_seats_fullRevoke an unused device or add POS devices, then Get device seat.
Your shop's StoreCashier plan does not include POS app devices — ask the shop admin to add POS devices to the license.Seats = 0 (Pro package)Upgrade or add extra devices.
The shop's website could not get a device license from the StoreCashier license server right now. Try again in a few minutes.app_license_unavailableWait; check the site’s internet and the Pro license.
This device has no POS device license yet — ask the shop admin to check Settings → POS Apps (device seats).app_license_requiredSite: Get device seat.
This device was removed from the shop's license — pair it again.app_license_invalid (revoked)Pair again with a new code (sales are kept).
The device license of this device is not valid — pair it again.app_license_invalid (signature / format)Pair again.
The device license of this device has expired. Keep the device online so the shop can renew it.app_license_expiredKeep online; Check now.
This device license belongs to another device or shop — pair this device again.app_license_device_mismatchPair again with a code from this shop.
Connect to the internet so the shop can renew the device license of this POS (valid until <date>).Warning from 5 days before expiry / during graceGo online for a moment.
StoreCashier Pro licence is not active on the site – sales are kept on this device until it is activated.license_inactiveActivate the Pro license on the website.

When an upload is refused for a license reason the app asks the site for a fresh license immediately; if it gets one, the same sale is retried at once.

On the site#

  • The seat line “POS device seats: x of y in use” and the package badge are on the Add device card.
  • A warning lists paired devices that cannot upload (missing, expired or released seat) and suggests Get device seat or revoking an unused device.
  • Refresh device licenses re-reads the seat usage and renews every device license now.
We replaced a broken tablet. How do we move its seat?

Revoke (or delete) the old device on the site — its seat is freed at once — then add the new device and pair it.

The shop is closed for six weeks. Will the apps stop?

Selling offline never stops. Uploads wait if a device license expired more than 7 days ago; as soon as the device is online again, the site renews it and the sales upload.

Is my license key stored on the tablet?

No. The device only holds its own device license (useless on any other device or shop) and its access token, both encrypted.