Skip to main content

How QR code access works for gyms, studios and membership spaces

· 3 min read

Entry is faster. No manual lists, no name lookups, no awkward pauses. The customer shows their phone — you scan — and they're in.

Short summary

The customer opens their subscription on their phone and shows the QR code. You scan it with any smartphone. The system instantly confirms whether the subscription is active. With API integration, the door can open automatically — no manual check needed.

How it works — step by step​

Provider side:

  1. Enable the QR system in Settings → QR Code Settings (one toggle)
  2. When a member arrives, open your phone camera or any QR reader
  3. Point it at the customer's screen
  4. The system shows the subscription status immediately: ✅ Active or ❌ Expired

End user side:

  1. Open your subscription in the Komashi customer portal
  2. Tap ... next to the subscription
  3. Select QR Code Entry System
  4. Show the QR code on your screen to the staff
note

QR codes refresh automatically every 15 minutes. An expired code cannot be reused.

A QR code is personal to the member it was issued to and must not be shared or copied — a shared or altered code can be refused. QR codes identify and grant access; they do not initiate payments and are not payment instruments.

Manual scanning vs automatic entry​

Manual scanning A staff member scans the QR code with any smartphone. No dedicated hardware needed. The screen immediately shows whether the subscription is valid. This is the simplest setup — no integration required.

Automatic entry via API With the Komashi API, the scan result can be processed automatically. This means the door, turnstile, or barrier opens without any manual step. The member walks in, the system handles the rest.

→ API documentation

Why it's faster​

Without QR access, every entry requires a name lookup, a manual check, or a member card. With QR:

  • No searching for the customer in a list
  • No checking if a membership is still active
  • No delays at the door during busy hours
  • Staff can focus on the member, not the screen

The result: shorter queues, smoother entries, and a better first impression every time a member arrives.

Who it's for​

  • Gyms managing active memberships
  • Fitness studios with class-based or unlimited plans
  • Coworking spaces with day passes or monthly access
  • Clubs and communities with member-only spaces
  • Any physical business where subscription = access