Skip to content

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 Ivanovich
Category: Guest
Type: One-time
🔑 Code: 482913
Property: 42
Until: 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:

  1. Tap “🔍 Проверка QR” — the Mini App opens inside Telegram.
  2. Allow camera access.
  3. Point the camera at the person pass QR code.
  4. The Mini App shows the card:
✅ Pass is valid
Name: Ivanov Ivan Ivanovich
Category: Guest
Type: One-time
Code: 482913
Property: 42
Valid until: 05.10.2026

On 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 (status used).

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 Ivanovich
Guest · One-time · code 482913
Property: 42 · Until: 05.10.2026
👤 Ivanova Maria Petrovna
Staff · Permanent · code 771204
Organization: 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.