Skip to content
Leat Help Center

Linking a tablet or phone to the Business App with a link token, and managing your devices

A device is a tablet or phone running the Business App, linked to one of your business profiles. Everything staff do on it, such as giving points or redeeming a gift card, is booked on that business profile. You manage your devices in the dashboard under Apps → Business App → Devices.

You create the link token yourself in the dashboard: go to Apps → Business App → Devices, click Link device, choose the business profile and click Create link token. You get a 5-digit code that you enter in the Piggy Business app. The full steps are below.

  1. Install the Piggy Business app from the App Store or Google Play on the tablet or phone.
  2. In the dashboard, go to Apps → Business App. You land on Devices.
  3. Click Link device, choose the business profile the device belongs to and click Create link token. The dialog shows a 5-digit code.
  4. On the device, open the app, tap Link device, enter the 5 digits and tap Link.
  5. The app shows Device linked to and the name of the business profile. Tap Correct to finish, or Incorrect to go back if it's the wrong one.

A code works once, so create a new one for every device. Use it within a day. After that, and after it's been used, the app says The device link token can't be found.

The device then appears in the list. Reload the page if you don't see it yet.

The device list

The Devices page lists every linked device with its Name, Business profile, UDID, Serial number, Type (iOS or Android), Version of the app, Has latest version, Last seen and Created at, the moment it was linked. Search by name or UDID, or filter on Business profile.

  • Has latest version shows No when a newer version of the app is available. Update the app on that device. See Business App problems.
  • Last seen is the last time the device contacted us. It's updated at most once an hour, so it can be up to an hour behind.

A device that hasn't been seen for a year is removed automatically.

The device page

Click a device to open it. The page has 3 sections.

Details holds the settings you can change. Click Edit details, make your changes and click Save changes.

  • Name: what the device is called in the dashboard, for example "Till 1".
  • Debug mode: shows the countdown on the device's screens that close by themselves. Handy when you're checking the timers in a configuration.

Linked to shows what the device belongs to:

  • Shop: the business profile the device is linked to. To move a device to another business profile, see below.
  • Configuration: the configuration the device uses, or None. You link devices to a configuration from the configuration itself. See Setting up a Business App configuration.

System ID shows the Serial number and UDID, which is how the device identifies itself.

Under Actions at the top of the page:

  • Update settings sends the latest saved configuration to the device straight away. The app has to be open on the device. Otherwise it picks up the configuration the next time it's opened.
  • Send push notification sends a test notification. If the app is open, the device shows We have received a push notification! Use it to check that Update settings can reach the device.
  • Delete removes the device. See below.

Move a device to another business profile

A device stays linked to the business profile it was linked to. To move it:

  1. On the device, open the side menu, tap Settings and then Unlink. Confirm with Unlink.
  2. Link it again with a code created for the other business profile.

The device is added as a new device, so give it its name again and add it to its configuration.

Remove a device

In the dashboard, open the device and choose Actions → Delete. On the device itself, you can also go to Settings → Unlink. Either way, the app goes back to the Link device screen the next time it contacts us, and the device disappears from the list.

Transactions made on the device aren't deleted. They stay on the contact and the business profile.

Anyone holding the device can unlink it. The app's Settings screen isn't protected by the passcode.

The Settings screen on the device

Open the side menu on the device and tap Settings to see:

  • Device info: the device's name, the business profile it's Linked to, whether debug mode is on, and its app and system versions.
  • Fetch the latest settings: loads the latest saved configuration, like Update settings in the dashboard.
  • Unlink: unlinks the device.

At the bottom, Settings info lists the settings the device actually received. If the device doesn't behave the way its configuration says, check there first.

Back to the help center