Subscriptions overview

Subscriptions are how HotelBee handles recurring facility access without a reservation per visit. The model is intentionally simple: plans + subscriptions + a kiosk. This article explains each piece and how they connect.

Plans (the catalog)

Backoffice → Subscription Plans → +. A plan has a name, description, price, taxes, duration in days, max entries (or null = unlimited), the linked POS point (where the sale is recorded), and the facilityIds it covers. Common shapes:

• Day pass — 1 day, 1 entry, single facility, low price.
• Weekly pass — 7 days, unlimited entries, single facility.
• Monthly membership — 30 days, unlimited entries, multi-facility (Gym + Sauna + Pool).
• 10-visit punchcard — 365 days, max 10 entries, single facility.

Subscriptions (the instances)

Subscriptions module → +. Pick a client (or create inline), pick a plan, set the start date — the end date is computed from plan.durationDays. Save and the subscription is active. From the subscription view, you can print the access card (QR), email it to the guest, take an additional payment, or cancel.

The kiosk (validation)

The kiosk is a separate web page that lives at /kiosk/{propertyId}/{kioskToken}. Each kiosk has a token (Subscriptions → Kiosk Tokens) that maps it to a specific facility. Mount the kiosk on a tablet at the facility door; guests scan their QR or tap their card and the page returns one of:

• ACCESS GRANTED (green) — valid subscription covers this facility.
• SUBSCRIPTION EXPIRED (orange) — past end date.
• SUBSCRIPTION CANCELLED (grey) — cancelled by staff.
• NOT COVERED FOR THIS FACILITY (orange) — valid subscription, wrong place.
• UNKNOWN CODE (red) — code doesn't match any subscription.

Each scan is logged for audit. Unlimited-entry plans don't decrement; max-entry plans do, and the kiosk surfaces the remaining count to the guest. The kiosk has a built-in camera scanner using html5-qrcode and also accepts HID keyboard wedge input from card readers.