Instruction
Difficulty level:
Implementing the Salto KS integration: test and production checklist
Practical implementation guide for the Salto KS integration (access control with IQ gateway and locks), with a checklist for test and production. The steps describe the order; then use the per-environment checklists.
Things to watch
- The IQ gateway must be online and activated with a PIN ("IQ is activated").
- The PIN + the IQ secret form the time-based OTP; do not change the PIN outside i-Reserve without re-activating.
- Test fully in acceptance first; production has its own account, site and IQ.
- The server time zone must be correct (OTP and time window use UTC).
Checklist — test environment (acceptance)
- ☐ Salto site exists; Site UID noted.
- ☐ IQ online gateway linked and online; IQ id noted.
- ☐ Locks registered in the site and reachable via the IQ.
- ☐ Salto KS account (username + password) with rights on the site.
- ☐ i-Reserve Auth tab: environment = Acceptance, Site UID filled, Site ID fetched via "Resolve site ID", account filled; connection tested.
- ☐ IQ OTP setup: IQ id filled, GET PIN, new PIN set via Set PIN; status = "IQ is activated".
- ☐ Details tab: "lock may open from status", time before, open-action field and check-in status set.
- ☐ Mapping: products linked to the right locks (GET locks).
- ☐ Integration set to active.
- ☐ End-to-end tested: booking → status → open action → lock opens; open time and check-in status verified.
Checklist — production environment
- ☐ Environment set to Production; production account, production site (Site UID) and production IQ used.
- ☐ IQ online in production and activated with a PIN ("IQ is activated").
- ☐ Real locks mapped correctly to the production products.
- ☐ Statuses (opening allowed + check-in) aligned with the real booking flow.
- ☐ First live opening verified (lock opens + open time/check-in updated).
- ☐ Rollback known: setting the integration inactive stops new open actions.
Make sure the Site exists (note the Site UID), the IQ gateway is online (note the IQ id) and the locks are registered; arrange a Salto KS account with rights on the site.
In Administration > Integrations add a Salto KS integration; choose the environment, fill Site UID + account, fetch the Site ID with Resolve site ID and test the connection.
In the IQ OTP setup block enter the IQ id, click GET PIN, set a new 4-digit PIN via Set PIN and verify the status shows "IQ is activated".
On the Details tab set "lock may open from status", time before, open-action field and check-in status; in the mapping link each product to the right lock (GET locks).
Set the integration active, move a test booking to the status and run the open action; verify the lock opens and the open time/check-in are updated.
