Forgot password — Cashier flow
import { Card, CardGrid, Steps, Aside } from ‘@astrojs/starlight/components’;
I. Overview
Section titled “I. Overview”The Cashier forgot-password screen (/cashier-login/forgot-password) is the dedicated employee-only password-recovery form that opens from the Cashier Login screen. It enforces that the email you submit belongs to an employee account — owners cannot request a reset here.
II. When to use this vs the shared flow
Section titled “II. When to use this vs the shared flow”| Scenario | Use this screen | Use the shared flow |
|---|---|---|
| Cashier forgot password, at the lane PC | ✅ /cashier-login/forgot-password | ❌ |
| Cashier wants to reset from the dashboard | ❌ | ✅ /forgot-password?type=employee |
| Owner wants to reset password | ❌ (refused) | ✅ /forgot-password?type=owner |
| Manager / supervisor with owner role | ❌ (refused) | ✅ /forgot-password?type=owner |
III. Step-by-step
Section titled “III. Step-by-step”-
Enter your employee email.
- The email must belong to an employee account.
- If you submit an email that belongs to an owner, the API will reject the request.
-
Click “Send code”.
- A 6-digit OTP is emailed to you. The OTP expires after 10 minutes.
- You are routed to
/verify-otpautomatically.
-
Enter the OTP (see Verify OTP).
-
Choose a new password (see Reset password).
-
Sign in again at
/cashier-loginwith the new password.
IV. Common errors
Section titled “IV. Common errors”| Banner | Meaning | Fix |
|---|---|---|
Enter a valid email address. | Email format invalid | Re-type carefully |
This email is not registered as an employee. | Email is unknown, or belongs to an owner | Use /forgot-password?type=owner instead, or contact the owner |
Too many requests. | You clicked “Send code” too many times | Wait 60 seconds |
V. Related
Section titled “V. Related”- Cashier login — Where this link lives.
- Verify OTP — Next step.
- Reset password — After OTP.
- Forgot password — shared flow — Owner variant.