🔑 Admin

License

License is where you see your current subscription plan and its limits, activate a purchased license key, and check exactly which features are unlocked on your plan.

📍 Menu path: Admin → License

👤 Who uses it: Admin only — always available regardless of plan tier

Overview

The page has three tabs: Current Plan for an overview of your plan, limits and account details; Activate License for entering a new key; and Features for a full checklist of every gateable feature and whether your plan includes it.

If you are on a paid plan, your organisation's subscription key is shown on the Current Plan tab — this same key is used to activate any additional desktop or mobile device on the same account.

The plan card shows your branch, desktop terminal, mobile device, user and (where applicable) product limits, with "Unlimited" shown for any limit your plan does not cap.

Before You Start

This page is always available to the Admin role regardless of plan tier — it is marked "adminAlwaysOn" so you can always reach it to activate or check on a license, even on the Free plan.
Only users with edit permission can activate a new license key.

Step-by-Step Guide

1 Check your current plan and limits

Open the Current Plan tab to see your plan name, billing price (if any), and status badge (Free, Active, Pending, Expired, or Revoked).
Review the limit pills for Branches, Desktops, Mobiles, Users, and (if applicable) Products.
If you are on a paid plan, note your Account and Account # under the expiry section, and the Expires date if the plan is time-limited.

2 Activate a purchased license key

Open the Activate License tab.
Type your license key into the input — it is auto-formatted into groups of four characters as you type (e.g. XXXX-XXXX-XXXX-XXXX).
Click Activate. On success, your plan, limits and features update immediately across the app.

💡 If the key is not found or invalid, you are signed out and redirected to the login screen with an error — double-check the key with your reseller or support before retrying.

3 Sync your license with the cloud

On the Current Plan tab, click Sync Now to re-validate your license against BazaarPOS's licensing server (useful after a plan change made on another device, or after renewing).
The "Last validated" timestamp updates once the sync completes.

4 Check which features are included

Open the Features tab to see every gateable feature (Billing & Invoicing, GST/Tax Module, Loyalty Program, Reports & Analytics, Audit Log, Import/Export, Backup, Connected Devices, Invoice Builder, and more) with a lock icon on anything not included in your plan.

5 Copy your subscription key

On the Current Plan tab (paid plans only), click Copy next to the Subscription Key box to copy it to your clipboard for activating another device.

Every Field & Button, Explained

Field / Button	What it does
`Subscription Key`	Your organisation's activation key shown on paid plans, with a one-click Copy button, used to activate additional desktop or mobile devices on the same account.
`Plan name & status badge`	Current plan name (e.g. Free, Standard, Advanced) plus a status badge: Free, Active, Pending, Expired, or Revoked.
`Limits (Branches / Desktops / Mobiles / Users / Products)`	The maximum count allowed for each resource on your plan; "Unlimited" is shown where the plan does not cap that resource.
`Sync Now`	Re-validates the license against the cloud licensing server and refreshes plan/feature data; disabled on the Free plan.
`Account / Account # / Expires`	The billing account name tied to this license, its account number (also used to derive sync encryption keys), and the plan's expiry date if applicable.
`License key input (Activate tab)`	Auto-formats to XXXX-XXXX-XXXX-XXXX as you type; only accepts hexadecimal characters.
`Activate button`	Submits the entered key to unlock the corresponding plan; requires edit permission.
`Features checklist`	Every gateable feature with a green check (included) or grey lock (not included) icon based on your current plan.

Tips & Best Practices

Use Sync Now right after renewing or upgrading your plan on another device or through the billing portal — it pulls the latest plan data without needing to log out and back in.
Copy your Subscription Key once and store it somewhere safe (e.g. a password manager) — you will need it every time you set up a new desktop or mobile device on the same account.
Check the Features tab before assuming a feature is broken — many Admin-section pages (Audit Log, Import/Export, Invoice Designer, etc.) are simply hidden below a certain plan tier rather than malfunctioning.

Troubleshooting & FAQ

Activation says the key was not found and logs me out.

This happens when the key is invalid or has already been fully consumed/revoked. Contact support with your purchase details to get a valid key before trying again.

Sync Now is disabled.

Sync Now is disabled on the Free plan, since there is no paid license to re-validate against the cloud.

My newly activated features aren't showing up yet.

Try Sync Now, and if that does not help, refresh the page — some feature-gated menu items are computed once at page load.

Why can I always reach this page even on the Free plan?

License is intentionally exempt from the usual plan-tier gate (flagged "adminAlwaysOn") so that you can always activate a key or check your plan status, even before any paid features are unlocked.

🧑‍💻 Developer Notes

Source component(s):

frontend-app/packages/pos-react-lib/src/pages/LicensePage.jsx

Backend endpoints used:

GET /license/current
POST /license/sync
POST /license/activate

Related tables (db-core repositories):

License
LicenseKey (best-effort)

Redux slices:

license (setLicense / clearLicense)
auth (logout on invalid key)

Feature flag key: billing

The client keeps a local FREE_FEATURES map mirroring the backend's PLANS.FREE.features as a fallback so the Features tab still renders sensibly before the first successful /license/current call. An invalid/not-found key during activation deliberately clears the license and logs the user out, on the assumption that a bad key usually means the account itself needs re-provisioning.