TTLock Setup

This guide walks you through connecting a TTLock lock to Reservine. If you're not sure which lock to choose, check the smart locks overview.

Prerequisites

Before you begin, make sure you have:

• A TTLock smart lock -- physically installed on the door
• A TTLock gateway (WiFi bridge) -- for remote management over the internet
• The TTLock mobile app -- the lock must be paired with the app
• A stable WiFi connection at the gateway installation location

Step-by-Step Setup

1. Preparing the Lock and Gateway

If you haven't paired your lock with the TTLock app yet:

1. Install the lock on the door following the manufacturer's instructions
2. Open the TTLock mobile app and create an account (or log in)
3. In the app, tap Add Lock and follow the on-screen instructions
4. After pairing the lock, add a gateway -- in the app, go to the Gateway section and add the device
5. Verify that the gateway is online (green indicator light on the device, "Online" status in the app)

2. Activating the TTLock Extension in Reservine

1. Log in to the Reservine admin panel
2. Go to Settings > Extensions
3. Find the TTLock card in the smart locks section
4. Click Connect (or Activate Trial if you want to try it out first)

3. Connecting Your Account

After clicking Connect, a dialog will appear with two options:

Option A: Connect an Existing TTLock Account

1. Select Connect Existing Account
2. Enter the email and password of your TTLock account
3. Click Log In
4. Reservine will verify your credentials and obtain an authorization token

Option B: Create a New TTLock Account

1. Select Create New Account
2. Enter an email and choose a password
3. Click Create Account
4. Reservine will automatically create a TTLock account and link it

4. Selecting and Assigning Locks

After successfully connecting your account, Reservine will automatically load all locks from your TTLock account:

1. A list of all available locks will appear with their names and statuses
2. For each lock, click Assign to Branch
3. Select the branch the lock belongs to from the list
4. Confirm the assignment

If you have multiple locks on one account, you can assign each lock to a different branch.

5. Verifying Functionality

1. Go to Settings > Smart Locks (monitoring)
2. Verify that your lock is displayed with the Online status
3. Check the battery level
4. Create a test reservation and verify that a PIN code is generated

Lock Management

Bulk Operations

If you have multiple locks, you can:

• Assign multiple locks to a branch at once
• Monitor the status of all locks in the unified dashboard
• Synchronize locks using the Sync button for an instant status update

Gateway Management

Gateway devices are essential for remote lock control. In the settings, you can:

• View a list of all gateways on your account
• Check their connection status (online/offline)
• Identify which locks are assigned to which gateway

Token Renewal

TTLock authorization tokens have a limited validity period. Reservine renews them automatically, but if issues arise:

1. Go to Settings > Extensions > TTLock
2. Check the connection status
3. If the status is Disconnected or Token Expired, click Reconnect
4. Re-enter your login credentials

Troubleshooting

Security

• Reservine does not store your TTLock password -- only authorization tokens are used
• PIN codes are unique to each reservation and time-limited
• All communication is encrypted via HTTPS
• In the lock monitoring dashboard, you can track all access events