Smart Locks Overview
Connect a vendor, assign locks or map QRLOCK rooms, then test access. Plan about 10–15 minutes.
This guide explains PIN smart locks and QRLOCK digital keys in AVA.
Quick reference
| Task | What it does | Where you go |
|---|---|---|
| Connect vendor | Links AVA to your lock system | QRLOCK Digital Keys, Igloohome Setup, TTLock Setup, or Wishome Setup |
| Assign locks | Maps rooms to devices | Set Up Smart Lock Assignments |
| Set PIN rules | Controls vendor-supported PIN length and default expiry | Settings → Room Access → Smart Lock (PIN) |
| Customize instructions | Updates guest-facing lock steps | Smart Lock Instructions |
| Fix issues | Resolves PIN or lock errors | Smart Lock Troubleshooting |
Where to find it
Settings → Room Access → Smart Lock (PIN)QRLOCK digital keys
QRLOCK uses a hosted guest link or direct QR image, not a PIN. You must connect QRLOCK credentials and map each PMS room explicitly. QRLOCK mappings can coexist with PIN-vendor mappings for the same PMS room. AVA keeps each vendor's mapping and uses the selected vendor for changes.
Choose QR Master page (link) to keep the hosted QRLOCK page. Choose QR image (direct image) to show the QR in AVA and guest emails. Direct image mode uses the existing card and does not issue a replacement.
Follow Set Up QRLOCK Digital Keys for the complete setup.
How smart locks work
- AVA connects to your lock vendor.
- AVA generates a unique PIN for each stay.
- Guests receive the PIN at check-in.
- PINs expire at your configured PIN Code Expiration Time on the checkout date. AVA resolves date-only stays using your hotel's configured timezone. A Singapore checkout on August 3 ends on August 3, not August 4.
- Day-use stays can override that expiry so the PIN matches the stay's checkout time.
Vendor PIN length limits
AVA keeps generated custom PINs within each vendor's supported range.
| Vendor | Generated custom PIN length |
|---|---|
| Igloohome | 4–6 digits |
| TTLock | 4–9 digits |
| Wishome | 6–10 digits |
Existing vendor PINs keep their current validity window. Revoke or regenerate an affected PIN from the reservation when needed.
Supported vendors
- Igloohome (OAuth connection)
- TTLock (username + password connection)
- Wishome (account credentials)
- QRLOCK (QR Master credentials and mapped digital-key rooms)
Some lock models support fewer PIN actions than others. After you click Refresh Locks, AVA disables actions the lock cannot do.
Before you start
Confirm these basics:
- Locks are installed and online
- You have an admin account for the vendor
- Lock names or QRLOCK room mappings match your PMS rooms
- You know which vendor you are changing before saving mappings
Next steps
- Connect your vendor: QRLOCK, Igloohome, TTLock, or Wishome
- Assign locks to rooms
- Customize guest instructions
Still Stuck?
Contact success@vouch-technologies.com if:
- ❌ Vendor connection fails after re-auth
- ❌ All PIN tests fail across rooms
- ❌ Locks do not appear after refresh
Helpful to include:
- Vendor name (Igloohome, TTLock, or Wishome)
- Screenshot of Room Access settings
- Time the issue started