Guest Booking App Help

Overview

The UnlockOS Guest Booking App lets guests easily browse and book rooms or spaces, check availability, and receive an access code or QR code — all from a smartphone or browser.

The booking flow works as follows:

  1. Select dates or times on the calendar
  2. Choose a room type
  3. Choose a plan
  4. Enter guest information and verify your email
  5. Complete payment (if required by the plan)
  6. Receive your access code / QR code to enter the room

Booking Modes: Stay vs Hourly

The app operates in either Stay mode or Hourly mode depending on the facility's configuration.

Mode Description How to Select Dates
Stay Multi-night booking with a check-in and check-out date Tap the calendar twice (check-in date, then check-out date)
Hourly Short-duration booking within a single day Tap the calendar once to choose the date, then select start and end times

Features

Feature 1: Calendar Availability

The calendar on the home screen shows real-time availability for each date using color indicators.

Indicator Meaning
Green (●) Available
Amber (●) Few remaining (50% or fewer rooms left)
Red (●) Fully booked (cannot be selected)

Past dates are grayed out and cannot be tapped.

Stay Mode — Selecting Dates

  1. Tap your check-in date — it will be highlighted in blue with an "IN" label
  2. Tap your check-out date — the full range will be highlighted in blue
  3. If you tap a date earlier than the selected check-in date, the check-in selection resets and you start over

Hourly Mode — Selecting a Date

Tap the date you want to use. On the next screen, select your start and end times in 15-minute increments.


Feature 2: Room Type Selection

After selecting your dates, a list of available room types for that period is displayed.

  • Each room shows its name, description, and capacity
  • Tap a room to proceed to plan selection
  • If no rooms are available, "No rooms available" is shown

Feature 3: Plan Selection

After choosing a room type, available plans for that room are displayed.

  • Each plan shows its name, description, and price
  • Tap a plan to proceed to the confirmation screen
  • If no plans are available, "No plans available" is shown

Feature 4: Guest Information and Email Verification (UnlockPass)

On the confirmation screen, enter your guest information and complete email verification (OTP).

What is UnlockPass?

UnlockPass is a shared email-verification identity that works across all UnlockOS facilities. Once you verify your email at one facility, your name and contact details are automatically carried over to any other UnlockOS facility — so you never have to re-enter the same information.

When UnlockPass is active, you will see the following cues in the booking app:

Where What you see
Login screen "UnlockPass" pill logo above the email input
Right after OTP verification A soft teal toast: "Authenticated with UnlockPass" (shown for 3 seconds)
Email field on the booking form An "UnlockPass" badge and an info (i) button; tap (i) for a plain-language explanation
Email row on My Page An "UnlockPass verified" tooltip

UnlockPass activates automatically. No special sign-up is required — just complete email verification as usual.

Input Fields

Field Required Description
Full Name Yes Name of the guest making the booking
Email Address Yes Where the verification code will be sent
Phone Number No Emergency contact or facility request
Notes No Special requests for the facility

Email Verification (OTP) Flow

After entering your email address, tap "Verify Email & Confirm" to open the verification modal.

  1. Enter or confirm your email address (an error is shown if the format is invalid)
  2. Tap "Send Verification Code"
  3. A 6-digit code will be sent to the email address you entered
  4. Enter each digit in the input boxes (focus moves automatically to the next box)
  5. Pasting the full code also triggers automatic verification
  6. Upon successful verification, your reservation is confirmed and you proceed directly to payment

If the code does not arrive: A "Resend Code" button appears after 60 seconds. Also check your spam or junk folder.

Note: If your email address is not in a valid format (e.g., example@domain.com), tapping "Send Verification Code" will show an error instead of sending. Correct the address and try again.


Feature 5: Payment (Stripe)

If the selected plan has a fee, a Stripe payment screen appears after email verification.

  • Enter your credit card details and tap "Pay"
  • Do not close the screen while payment is processing
  • Once payment succeeds, you will automatically advance to the booking completion screen

Plans with a price of ¥0 skip the payment screen and confirm immediately.


Feature 6: Access Code and QR Code

After your booking is confirmed, an access code is issued for entry.

Access Code (PIN)

  • A 4–6 digit numeric code is displayed in large format
  • Enter this code on the door keypad to unlock
  • The expiry date and time are shown below the code

QR Code

  • At facilities that support QR entry, scan the QR code with the door reader to unlock
  • The QR code shares the same expiry as the access code

If the Code is Expired

The display will show "Expired" and the code will be grayed out. Please contact the facility.


Feature 7: Viewing Reservation History

Tap the "Bookings" tab in the navigation bar to view your past and current reservations.

Status Description
Pending Reservation received, awaiting facility confirmation
Confirmed Reservation confirmed and access code is active
Cancelled Reservation has been cancelled

Tapping a confirmed reservation opens the access code screen for that booking.

Viewing the reservation list requires logging in via email verification.


The "Key" tab in the navigation bar shows all reservations that have an issued access code.

  • If you have multiple reservations, swipe horizontally to switch between them
  • The dot indicator at the top shows which reservation is currently displayed
  • Use the left and right arrow buttons to navigate

The Key tab requires logging in via email verification.


Frequently Asked Questions

Q: What is the UnlockPass badge on the email field?

A: UnlockPass is a cross-facility identity shared across all UnlockOS properties. Your verified email is recognized automatically at any UnlockOS facility, saving you from re-entering your details each time. The badge confirms that your account is UnlockPass-verified.

Q: I did not receive the verification code

A: Please check the following:

  • Make sure your email address is in a valid format (if not, the code will not be sent and an error will appear on screen)
  • Look in your spam or junk mail folder
  • Make sure the email address you entered is correct
  • After 60 seconds, tap "Resend Code" to request a new code

Q: My access code is not showing

A: Verify that your reservation status is "Confirmed." If it still shows "Pending," the facility may still be processing your booking — please wait a moment.

Q: I want to change the date or time of my reservation

A: For Pending or Confirmed reservations, you can change the date and time in the app using the "Change date or time" feature, up to 24 hours before check-in. See Change Date or Time for details.

Q: I want to extend my stay while checked in

A: Active (checked-in) reservations can be extended using the "Extend" feature. An extension fee is required and charged immediately. See Extend for details.

Q: I want to leave earlier than my scheduled check-out time

A: You can use Early Check-out for active (checked-in) reservations. Note that no refund is issued for early departure. See Early Check-out for details.

Q: My payment failed

A: Double-check your card details and try again. If the issue persists, contact your card provider.

Q: My reservation list is empty or not showing

A: The reservation list requires a logged-in session. If you see "Log in to view your reservations," complete the email verification step when making your next booking to log in.

Q: I want to book a date that shows as fully booked

A: A red indicator means all rooms for that date are already reserved. Please select a different date or contact the facility directly.