Verify Person Pass (/verify_person)
Verify Person Pass
The /verify_person command lets security verify a person pass (guest, staff, contractor) by 6-digit code (primary) or search by full name (fallback). Available to roles: guard, admin, super_admin.
How to use
/verify_person🔍 Verify person pass
Enter the 6-digit access code or at least 3 characters of the name:Method 1 — by code (primary)
Enter exactly 6 digits, e.g. 482913.
Valid pass:
✅ Pass is valid
Name: Ivanov Ivan IvanovichCategory: GuestType: One-time🔑 Code: 482913Property: 42Until: 05.10.2026ℹ️ One-time pass burned.Rejection:
❌ Pass not confirmed: already used.Possible reasons: not found, already used, expired, cancelled.
Method 3 — by QR (Mini App)
The pass holder receives a QR image at creation (and can reissue it with the “🔁 QR” button). Security scans the QR via the Telegram Mini App.
How to open: the “🔍 Проверка QR” button at the bottom of the bot chat (web_app menu button). It appears automatically for guard, admin, super_admin roles after /menu or /start.
How to verify:
- Tap “🔍 Проверка QR” — the Mini App opens inside Telegram.
- Allow camera access.
- Point the camera at the person pass QR code.
- The Mini App shows the card:
✅ Pass is validName: Ivanov Ivan IvanovichCategory: GuestType: One-timeCode: 482913Property: 42Valid until: 05.10.2026On rejection the reason is shown: Pass not found, Pass already used, Pass expired, Pass cancelled, Invalid QR code.
The QR contains only a cryptographic pass identifier (
pp_<token>), with no name or access code. For a one-time pass, scanning also burns it (statusused).
Limitations: the Mini App opens only inside Telegram; verification is available to guard/admin/super_admin roles only; a rate limit applies (30 checks/min per user). Regenerating the QR (the “🔁 QR” button) instantly invalidates the old code — a previously printed QR stops working.
Method 2 — by name (fallback)
Enter at least 3 characters of a last or first name. The bot shows up to 10 matches:
🔎 Found: 2
👤 Ivanov Ivan IvanovichGuest · One-time · code 482913Property: 42 · Until: 05.10.2026
👤 Ivanova Maria PetrovnaStaff · Permanent · code 771204Organization: Romashka LLC · Until: 31.12.2026
Press a button to confirm entry:[✅ Confirm: Ivanov Ivan Ivanovich][✅ Confirm: Ivanova Maria Petrovna]Press the button next to the right person — the bot confirms entry. For a one-time pass this sets status used (the pass is burned); for other types only the verification event is recorded.
Input errors
❌ Enter a 6-digit code or at least 3 characters of the name.Tips
- A one-time pass can be burned only once — a second check returns
already used. - Name search is case-insensitive and matches substrings.