Skip to content

Device pairing (QR)

What it's for

Pairing activates a device by scanning a QR code — no server address to type, no pending-approval step. The scan itself is the approval: the device is connected to your backend, activated, and assigned to the customer, all in one step. It's the standard way to onboard mobile devices.

How to use it

  1. Open the customer the device should belong to and go to its Endpoints tab.
  2. Generate a pairing QR code.
  3. Have the user scan it in the Valenius app (do this together — the code is short-lived).
  4. Done — the device appears in the customer's client list, already active.

Each code is one-time and expires after 15 minutes. Pairing several devices means generating one code per device.

Pitfalls

  • Treat the code like a password. Whoever scans it becomes an activated device of that customer. Show it directly to the right person; don't email screenshots of it around.
  • "Code rejected" almost always means expired or already used — generate a fresh one; there's no cost to it.
  • The QR encodes your backend's public address — the device must be able to reach it over HTTPS at scan time, or pairing fails with a connection error rather than a rejection.