Skip to main content

Wishome Setup

Quick Setup

Enter your Wishome credentials, then test a PIN. Plan about 10 minutes.

This guide helps you connect AVA to Wishome smart locks.

Quick reference​

SettingWhat it controlsWhere you set it
PIN Code Expiration TimeWhen codes expire on checkout dayRoom Access → Smart Lock (PIN)
Random Custom PIN Length6–10 digit PIN lengthRoom Access → Smart Lock (PIN)
Offline Password VersionWishome offline PIN rules (v1 or v2)Wishome Credentials section
Wishome AccountVendor connection for code generationWishome Credentials section

Where to find it​

Settings → Room Access → Smart Lock Vendor → Wishome

Before you start​

  • Wishome locks are installed on guest rooms
  • You have a Wishome portal account
  • You know your Offline Password Version (from Wishome)

Step 1: Select smart lock method​

  1. Go to Settings → Room Access.
  2. Select Smart Lock (PIN) as the room access method.
  3. Click Save.

Step 2: Choose Wishome vendor​

  1. In Smart Lock Vendor, select Wishome.
  2. Confirm the Wishome settings appear.

Step 3: Configure PIN settings​

  1. Set PIN Code Expiration Time (default: 11:00 AM).
  2. Select Random Custom PIN Length (6–10 digits).
PIN length limits

Wishome supports custom PINs from 6 to 10 digits. AVA keeps generated custom PINs inside this range.

Step 4: Connect your Wishome account​

  1. Enter Wishome Account Name and Wishome Password.

  2. Select Offline Password Version (v1 or v2).

  3. Click Connect Wishome Account.

    ✓ You see Wishome credentials saved status.

Step 5: Test a PIN​

  1. Go to Smart Lock Setup.

  2. Select a room and click Test PIN Generation.

    ✓ A test PIN usually appears within 10 seconds. Bridge-backed locks may show Pending briefly before the PIN appears.

Troubleshooting​

Credentials incomplete​

What you see: “Wishome credentials incomplete.”

Fix:

  1. Re-enter Wishome Account Name and Wishome Password.
  2. Confirm Offline Password Version.
  3. Click Connect Wishome Account again.

Token expired​

What you see: A token-expired warning in Wishome Credentials.

Fix:

  1. Re-save your credentials to refresh the token.

Update credentials​

If you need to change accounts:

  1. Click Remove Wishome credentials.
  2. Enter the new credentials and click Connect Wishome Account.

Still Stuck?​

Contact success@vouch-technologies.com if:

  • ❌ Credentials save but locks never appear
  • ❌ PIN tests fail for all rooms
  • ❌ Token refresh does not resolve errors

Helpful to include:

  • Wishome account name
  • Screenshot of the Wishome section
  • Time the issue started