Visitor & gate troubleshooting
Gate desk menu missing or "not authorized" — Gate desk requires society admin or
society staff role (gate_can_operate). Confirm your account has guard/staff access and your
society is on the Operations tier — see pricing.
OTP verification returns not OK — The OTP may be mistyped, already used on an expired pass, or past the 24-hour validity window. Ask the resident to create a fresh pass on Visitors, or log a walk-in if they are already at gate.
QR scan fails — Ensure the full QR is visible and belongs to the active society. Residents can share the OTP as a fallback.
Walk-in stuck at "at gate" — The flat owner must tap Approve or Deny on Visitors. Check that the correct flat was selected and the owner has claimed that flat. Admins can also approve walk-ins.
"Invalid status" on approve/deny — approve_visit and deny_visit only work when status is
at gate. Pre-approved passes verified by OTP move to approved automatically — log entry
instead.
Cannot log entry — Pass must be approved first (via OTP/QR verify or walk-in approval). Use Log entry only after approval succeeds.
Resident did not get walk-in notification — Confirm the flat has claimed owners with the app installed and notifications enabled. Check Notifications in the app.
Pass shows expired — Pre-approved passes expire after 24 hours. Create a new pass.
Visitor list empty on Visitors — You only see passes you created, walk-ins for your flat, or (if admin/staff) society-wide passes. Claim your flat first if you have not.
Need hardware boom barrier — Plinth records approvals and entry/exit; physical barriers are separate hardware. Gate desk is the software log and approval layer.