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

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

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

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: 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 or cancel my reservation

A: Changes and cancellations cannot be made through the app after confirmation. Please contact the facility directly.

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.