Auth & account FAQ
import { Card, CardGrid, Aside } from ‘@astrojs/starlight/components’;
Login problems
Section titled “Login problems”“Incorrect email or password.”
Section titled ““Incorrect email or password.””- Verify the email is exactly the one given by the store owner.
- Check Caps Lock and try with the password visible (👁 icon).
- Reset your password via the link on the sign-in screen.
“This account is suspended.”
Section titled ““This account is suspended.””Your account was disabled by the store owner. Ask the owner to re-enable it under Employees.
“Only employee accounts can sign in here.”
Section titled ““Only employee accounts can sign in here.””You opened /cashier-login with an owner account. Owner sessions cannot operate the cashier workspace. Use:
| Your role | Sign in at |
|---|---|
| Owner | /vendor-login |
| Employee (POS only) | /cashier-login |
| Employee (dashboard) | /login |
“Network error” / spinner never stops
Section titled ““Network error” / spinner never stops”- Vendor Desktop first login requires internet — connect to the network.
- Browser sign-in always requires internet.
- If the spinner runs > 30 seconds, refresh the page and try again.
Validation errors before clicking Sign in
Section titled “Validation errors before clicking Sign in”| Field | Error | Fix |
|---|---|---|
Enter a valid email address. | Re-type — make sure it contains @ | |
| Password | This field is required. | Fill in the password |
Password reset
Section titled “Password reset”I never received the OTP email
Section titled “I never received the OTP email”- Wait 1–2 minutes — emails can be delayed.
- Check the spam / junk folder.
- Verify the email address you entered (typo is the #1 cause).
- Click Resend code on the OTP screen.
- If still nothing after 5 minutes, ask the owner to check the mail server logs.
“Invalid or expired code”
Section titled ““Invalid or expired code””- The OTP expires after 10 minutes.
- Every Resend invalidates the previous code.
- Type the latest code from your most recent email.
“Reset session expired” on /reset-password
Section titled ““Reset session expired” on /reset-password”The reset token lives in sessionStorage — it disappears if you:
- Closed the tab.
- Switched browsers.
- Waited more than 15 minutes between Verify OTP and Reset password.
Restart from /forgot-password and request a fresh code.
I want to reset from another device
Section titled “I want to reset from another device”You can request the reset email on any device, but the Verify OTP and Reset password steps must be completed on the same browser session as the initial request (because of sessionStorage). Use the device where you opened /forgot-password.
Owner vs cashier access
Section titled “Owner vs cashier access”Why are owners blocked at /cashier-login?
Section titled “Why are owners blocked at /cashier-login?”The cashier workspace is fullscreen POS with no dashboard menu. Granting an owner account there is a security risk:
- The cashier UI hides the Owner role switcher and admin tools.
- Owner permissions include
settingswrite — a cashier lane should never change store config. - For owner supervision at the lane, the owner should open
/point-of-sale/salefrom the vendor web (after signing in at/vendor-login).
I am the owner. Can I use /cashier-login with my personal email?
Section titled “I am the owner. Can I use /cashier-login with my personal email?”No — only employee accounts (created from Employees → + New) can sign in there. Owners should:
- Use
/vendor-loginfor back-office tasks. - Open
/point-of-sale/salefrom the dashboard nav (supervisor mode) for ad-hoc ringing.
Can an employee use /vendor-login?
Section titled “Can an employee use /vendor-login?”No. /vendor-login only accepts vendor_type === "owner". Employees sign in at /cashier-login or /login.
Sessions & cookies
Section titled “Sessions & cookies”“Remember me” — what does it do?
Section titled ““Remember me” — what does it do?”| Setting | Effect |
|---|---|
| ✅ ON (default for cashier) | Refresh token persisted in localStorage for 30 days |
| ❌ OFF | Refresh token kept in sessionStorage — cleared when you close the browser |
I share a lane PC with another employee
Section titled “I share a lane PC with another employee”- Tick “Remember me” OFF so each shift re-authenticates.
- Or sign out at the end of your shift (Settings → Profile → Sign out in the POS workspace).
How do I sign out?
Section titled “How do I sign out?”From the POS workspace:
- Open Settings → Profile.
- Scroll to the bottom.
- Click Sign out.
- Confirm the dialog.
Or just close the app — if “Remember me” is OFF the session ends immediately.
Multi-store
Section titled “Multi-store”I belong to multiple stores — how does /cashier-login decide where I land?
Section titled “I belong to multiple stores — how does /cashier-login decide where I land?”The login form looks up your employee profile and auto-selects:
- If
store_idis set in your profile → that store. - If
pos_register_idis set → that lane is pre-selected. - Otherwise the store & lane pickers stay visible until you pick.
I switched stores mid-shift and my catalog changed — is that normal?
Section titled “I switched stores mid-shift and my catalog changed — is that normal?”Yes — catalog, prices, customers and tax rates are all per-store. Switch stores with the store selector in the top bar; the cart is cleared automatically.
Still stuck?
Section titled “Still stuck?”Send to your store owner or to support@lionpos.com. For platform-wide outages, check the status page first.