Lock Connection Help

Overview

Lock Connection is where you configure integration with KEYVOX smart locks. Once connected, automatic unlocking during check-in becomes possible.

Lock Connection KEYVOX tab

Key Features

  • Integration with KEYVOX account
  • View list of registered lock devices
  • Disconnect integration

Tabs

Tab Name Description
KEYVOX Integration with KEYVOX smart locks
Stripe Integration with Stripe payments
LINE Integration with LINE Official Account

Stripe Payment Tab

The Stripe tab lets you connect a Stripe account to enable online payments. After connecting, you can charge guests for pre-payment, post-payment, and deposits during check-in.

Lock Connection Stripe tab

KEYVOX Integration

Connection Status

Status Description
Connected Successfully connected to KEYVOX account
Disconnected No connection to KEYVOX account

Buttons

Button Description
Login with KEYVOX Perform OAuth authentication with KEYVOX account
Logout Disconnect from KEYVOX

Device List

Places

Registered locks are displayed grouped by location.

Doors

Under each place, registered doors and lock units are displayed.

Display Fields

Field Description
Place Name Name of the location where the lock is installed
Door Name Name of the door
Unit Name Name of the lock unit
Unit ID KEYVOX unit identifier (click to copy)
Unlock Lock The lock ID used for remote unlock (selected by the admin)

Operations

Connecting with KEYVOX

  1. Click the "Login with KEYVOX" button
  2. You will be redirected to KEYVOX login page
  3. Log in with your KEYVOX account
  4. After authentication, you will automatically return to UnlockOS
  5. Registered lock devices will be displayed in a list

Copying Unit ID

Click on a Unit ID to copy it to clipboard. This is used in check-in configuration.

Setting the Unlock Lock ID (required for remote unlock)

To allow guests to use the Remote Unlock button, you must assign an unlock lock to each unit.

  1. Expand the unit in the device list
  2. Select the lock ID from the "Unlock Lock" dropdown for that unit
  3. The setting is saved automatically after selection (a ✓ indicator appears)

If a KEYVOX unit has multiple lock IDs associated with it, all candidates appear in the dropdown. Select the lock corresponding to the door the guest should unlock.

If no unlock lock ID is configured, guests who tap the Remote Unlock button will see a "Lock ID not found" error.

Disconnecting

  1. Click the "Logout" button
  2. Select "Yes" in the confirmation dialog
  3. KEYVOX integration will be disconnected

FAQ

Q: What should I do if KEYVOX connection is lost?

A: Click the "Login with KEYVOX" button again to reconnect.

Q: Can I use KEYVOX with multiple facilities?

A: Yes, you can connect KEYVOX accounts for each facility.

Q: What if locks are not displayed?

A: Please verify that the locks are properly registered in the KEYVOX dashboard.

Q: How do I specify locks in check-in configuration?

A: Copy the Unit ID from the list on this page and paste it into the check-in configuration screen.

Q: The Unlock Lock dropdown is not showing for a unit

A: The dropdown only appears when the KEYVOX unit has at least one lock ID associated with it. Check the KEYVOX dashboard to confirm that a lock is correctly assigned to the unit.