Skip to content

Salto KS door locks

Self check-in without a key handover. When a booking is confirmed, CampOne asks Salto KS to mint a PIN that works on the guest’s door for exactly the booking dates. When the guest checks out, the PIN is revoked. Front-desk staff never touch a physical key.

  • Automatic PIN issuance on Booking → CONFIRMED
  • Automatic revocation on Booking → COMPLETED
  • Audit log of every PIN minted, with the Salto-side key_id
  • A nightly reconciliation pass that detects discrepancies between CampOne’s records and what Salto reports as active
  • A Django signal (salto_key_issued) that downstream code can subscribe to — useful when you want to deliver the PIN to the guest by SMS, email, or your guest portal

Salto KS Connect is a partner program — you don’t self-register. Submit the form at https://saltosystems.com/en-ch/contact/ naming “KS Connect API integration partner”. The Swiss Business Unit will issue:

  • A client_id / API token for the Cloud Connect API
  • Confirmation of the base URL for your environment
  • A keyTemplateId you can issue PINs against (typically the “guest room” template they pre-provision)
  • Rate-limit guidance for POST /keys — peak summer at a busy site can be several hundred PIN issuances per hour

Older Salto installations use SVN (a different generation than Cloud Connect). The adapter has a placeholder for SVN but does not support it today — confirm with Salto that your site is on the Cloud Connect platform before signing up.

Settings → Integrations → Vendor Adapters → Salto KS:

FieldDescription
EnvironmentTest until vendor confirms production credentials
Site IDYour Salto KS customer / site identifier
API tokenThe Bearer token issued by Salto
Default key templateThe keyTemplateId for guest rooms
PIN length4 or 6 digits (vendor-configured per door)

Click Save, then Test connection. The probe calls list active keys — green pill confirms the token works.

  1. Guest’s booking moves from PENDING to CONFIRMED.
  2. CampOne calls Salto: “issue a key for door X, valid from check-in to check-out”.
  3. Salto returns {key_id, pin}. CampOne stores both: key_id in plaintext, pin encrypted.
  4. The PIN is now what the guest needs to enter their accommodation. Delivering the PIN to the guest is up to you — the standard pattern is to subscribe to the salto_key_issued signal and dispatch SMS / email / portal message.
  5. On check-out, CampOne calls Salto: “revoke key_id”. Done.

If a stay is cancelled before check-in, the PIN is revoked immediately.

Once a night, CampOne pulls Salto’s list of active keys and compares it with its own record of SaltoKeyIssuance rows where revoked_at IS NULL. Discrepancies (issued locally but missing at Salto, or vice versa) appear in the integration log so a manual reconcile is fast.

  • The adapter delivers the PIN to CampOne, not to the guest. You decide the delivery channel.
  • Webhook events (door opened, low battery) are not yet ingested. If you want those, ask Salto for the webhook signing secret and we’ll wire it in.
  • Multi-PIN-per-stay (e.g. one for accommodation, one for shower block) is a roadmap item.