Explanation

Activation and licensing

One scan of the kiosk's QR code links it to a booth record and installs its license. This page explains what the code carries, what a license is, what happens when it expires, and what removing the link undoes.

A kiosk out of the box has no identity and no license. The pulsing Unlicensed badge on its welcome screen means both. Activation gives it both at once, from one scan of the QR code the kiosk shows. The steps are in Activate the booth; this page is about what happens underneath.

What the QR code carries

The code is a fingerprint of the kiosk's hardware, nothing more. When the kiosk shows it, it has already told the cloud "this fingerprint is waiting", and it then keeps asking the cloud whether anyone has approved it. It asks every two and a half seconds. The code is good for fifteen minutes; Refresh QR starts a new wait.

The approval comes from the BoothIQ app, signed in to the account that owns the booth record. The app sends the fingerprint together with the booth to link and what to license it with: the booth's subscription, or a license key issued to that account's email. The cloud checks that the booth is allowed to be activated and answers the waiting kiosk.

The kiosk then installs two things together: the license, and its cloud identity (the booth it now is, and the key it uses to talk to the cloud). If either cannot be saved, the other is rolled back, so a kiosk is never half-linked. On success the status under the code reads "License activated!" and the badge goes.

Nothing is ever typed into the kiosk. There is no key entry on the kiosk, and the API key shown on the website's Connection Details is not used for linking; it is there for BoothIQ support.

What a license is

The license is a signed file tied to this kiosk's hardware, stored on the kiosk. It is validated on the kiosk, at startup, without the internet, and a timer checks it every minute for expiry. There are three kinds:

KindExpiresComes from
SubscriptionOn the plan's end date, renewed online while the subscription is active; for a key, a set number of days after activationThe booth's plan (web or app), or a subscription key issued by BoothIQ
PerpetualNeverA license key issued by BoothIQ
TrialA set number of days after activationA trial key issued by BoothIQ

Keys are tied to the email address they were issued to, which is why the app lists only your own keys when you activate. Once a key is used it cannot be used again; replacing a kiosk means activating the new one with the same booth record, which the app handles with its "Replace hardware" choice.

When a subscription license runs out

A subscription license carries the end date of its billing period. The kiosk does not renew it early: a timer checks the license every minute, and the moment it finds the date passed, the kiosk asks the cloud for a new one. If the subscription is still active, the cloud answers with a fresh license for the new period and the booth is back within about a minute. If the renewal fails (no internet, or the subscription has ended) the kiosk keeps trying, first every thirty seconds and then less often, up to once every ten minutes.

While the license is expired, customer sessions stop: the welcome screen answers "Not Activated" and the badge returns, but the admin area still opens, and the booth's records are untouched. The first successful renewal puts it straight back to work. A paid-up booth therefore has a pause of a minute or so at each period end, and a longer one if it was offline at the time. The kiosk itself gives no warning before expiry; the app's booth card shows "Expiring" when a subscription is set to end, and the web's Manage plan dialog shows the end date.

A payment that Stripe takes for the next period updates the cloud's record of the license; it does not push a new license to the kiosk. The kiosk's own renewal request is what fetches it.

Other states that stop the booth

The kiosk refuses to start a session, and says why, when the license is:

The kiosk saysWhat it means
"Trial Expired" or "License Expired"The date has passed and renewal has not succeeded. A subscription needs an active plan; a trial needs activating with a paid license.
"Hardware Mismatch"The license belongs to a different computer. This happens when the kiosk's hardware was replaced; contact support for a transfer.
"License Revoked"BoothIQ withdrew the license. The booth shows a "License Revoked" toast when that command arrives.
"Invalid License"The license file on the kiosk is damaged. Re-activate, or contact support.

A kiosk whose clock has been moved backwards is treated as tampered with and asks for a recovery code from support.

Cloud Sync › Unregister Booth removes the kiosk's cloud identity so it can be linked to a different booth record. It also deactivates the license, and the kiosk says so before it goes ahead: the booth needs activating again afterwards. If records are still waiting to upload, the warning counts them and offers Sync Now first; whatever has not been synced when you confirm is lost from the cloud's point of view.

Removing the link is for moving a kiosk between booth records, not for fixing a sync problem. For a booth that has stopped syncing, start with the internet connection and the Cloud Sync status.

Where the license shows

  • On the kiosk: Settings › License Status.
  • In the app: the booth card's badge ("Subscribed", "Licensed", "License expired") and Settings › Subscription & Billing.
  • On the web: the plan chip on the Booths page, and the Licenses page for keys.

Last verified against the software on 2026-10-20.