[Admin] Member check-in passes (QR, Apple and Google Wallet)
Every member whose membership is active (including a trial, or a notice period after cancelling) has a personal check-in pass: a QR code and a 6-digit member number.
Member experience:
- The pass is at the top of My Membership (the club's member page, or the studio member portal): the QR code, the member number, and a Full screen view that keeps the screen awake while it's scanned
- Add to Apple Wallet or Add to Google Wallet puts the same QR in the phone's wallet, so it's there without signing in
- A paused, ended or not-yet-approved membership shows a short explanation instead of a pass
What the QR holds:
whosin://checkin/{club|studio}/{orgId}/{memberCode} — the org it belongs to and the member's 6-digit code (derived from the membership with a server secret). The scanner refuses a pass for another club or studio on the device, before anything is sent.
A pass is a snapshot:
A wallet pass shows what was true when it was added: tier, status and member-since date. It does not update itself. A monthly membership shows no expiry (it renews); a fixed-term membership shows the day it ends. If something changes, add the pass again from My Membership. Validity is always checked at the door, not read from the pass.
Security:
- Passes are member-scoped: a member can only download their own
- Every scan is checked against the live membership: a paused, ended or unpaid membership is turned away, whatever the pass says
- The code stays the same for the life of the membership, so a copied pass works like the original; if you suspect sharing, the scanner's Recent scans and the member's visit history show every check-in
Troubleshooting:
- "The QR won't scan" → turn the member's screen brightness up, or use Full screen; or type the member number in the scanner's Manual lookup
- "This pass is for another club" → the member opened a pass from a different club or studio