Kiosk
How do I resolve an invalid license alert?
Resolution steps for the Invalid License alert — caused by a location mismatch between the kiosk and its assigned license; fixed in seconds via Manager Mode > Advanced > Register Kiosk.
📋 Overview
The Invalid License alert means the kiosk's current location does not match the location assigned to its license. The kiosk doesn't have a hardware problem — it just needs to re-fetch a license that matches where it actually is.
The kiosk will not process transactions while this alert is active. Run through the resolution steps below as soon as you see it.
Invalid is not the same as Expired. Invalid = location mismatch (fixed by Register Kiosk). Expired = the license itself has reached its end date (fixed differently). If your alert says the license is expired or expiring soon, that's a separate article.
🛠️ How to Resolve
Step 1. Navigate to Register Kiosk
- Open Manager Mode
- Tap Advanced
- Tap Register Kiosk
Step 2. Confirm the License Updates Successfully
When you press Register Kiosk, the kiosk fetches and applies a valid license number that matches its current location.
- Success: a green check appears next to Register Kiosk and the Invalid License alert clears from the main Manager Mode screen.
- Failure ("unable to get a license" or alert doesn't clear): continue to Step 3.
Step 3. Contact Mashgin Support
If the alert persists or you see an "unable to get a license" error, the kiosk is likely initialized to the wrong location and needs to be reassigned on Mashgin's side. Reach out to 📧 help@mashgin.com with:
- The kiosk serial number (printed on the back or side of the kiosk)
- The physical location the kiosk is currently deployed at
- The exact error message shown on screen
Mashgin Support will reinitialize the kiosk against the correct location, after which the Register Kiosk step will succeed.
💡 Tips
If this alert appears right after a kiosk is physically moved between locations, that's expected behavior — the kiosk's previous license is now invalid for its new location. Re-registering picks up the correct license.
If Register Kiosk repeatedly fails on a kiosk that hasn't moved, network connectivity is the next thing to check — the kiosk needs internet to fetch a fresh license.
🔗 Related Articles
Need help? Contact support at 📧 help@mashgin.com or call (855) 475-0889