Troubleshooting

Staff cannot scan

Troubleshoot a staff member who can't scan cards: a missing permission, the wrong username, or a branch assignment mismatch.

Updated 9 September 2026العربية

If a staff member can't scan or their scans don't seem to do anything, work through these three checks.

Checklist

  1. Check the role's permissions

    Only roles with the add_points permission can add stamps or points; deduct_points is needed to remove them. The seeded Cashier role has both; a custom role may not. See Staff roles and permissions.

  2. Confirm they're using the right username

    Staff log in with a username and password sub-account created by the owner directly — not their personal email address. Make sure they're signed in with the exact account the owner set up for them, not a different one or an old test login. See Invite staff.

  3. Check their branch assignment

    If a staff member is assigned to a specific branch, confirm that's the branch they're actually working at — see Branches.

About the seeded roles

Waya starts every shop with two seeded roles: Cashier, which has add_points and deduct_points only, and Branch Manager, which has every permission except campaigns. If a staff member needs a mix of permissions that doesn't match either one, the owner can create a custom role instead of stretching a seeded one to cover a permission it was never meant to have.

Next steps

Put Waya on your counter — free forever up to 100 customersStart free