Skip to Content

Manage the card reader in Selflane Hub

Guests can only pay by card while the kiosk’s card reader is connected. Use the Payments pane to check the reader, swap it for another one, or install a reader software update.

Open Settings → Payments. In Selflane Hub 1.3.0 or later, you can also tap the Card reader row on Home.

To connect a reader for the first time, follow Connect the card reader. For setup errors, see Troubleshoot card readers and printers.

Requirements:

  • A manager to unlock Payments, with the latest Selflane Hub 1.3.0 update. See Manager approval.
  • A Stripe reader or a PAX terminal. See Kiosk hardware.
  • Selflane Hub 1.2.0 or later (1.3.0 on iPad and iPhone) for automatic reconnect, reader software updates, and network readers. PAX terminals need Selflane Hub 1.3.0 or later.

Unlock Payments

With the latest Selflane Hub 1.3.0 update, Payments opens locked. The pane shows Payment settings are locked and A manager PIN is required to change the card reader.

  1. Tap Unlock.
  2. A manager chooses their name and enters their PIN on the Payment settings screen.

While Payments is locked, you can see the reader’s status. Discover a reader, Change reader, Disconnect, Forget reader, and Install update are grayed out. Try now and Stop reconnecting work without unlocking, because they only retry the reader you already have.

Payments locks again when you sign out, switch business, or close and reopen the app. Earlier versions open Payments unlocked.

Payments stays unlocked in two cases:

  • Leaving the kiosk for a reader problem. When a manager leaves the kiosk because the card reader is unavailable, Payments unlocks. If the reader still isn’t connected, card reader setup opens.
  • The app restarts itself. When Selflane Hub restarts on its own, for example after Save and switch to PAX or an update, Payments stays unlocked if the restart takes less than a minute.

Card reader status

The Card reader card shows the reader’s name and status. A battery reader also shows its charge. The charge turns red at 20% or less.

StatusWhat it means
ConnectedThe reader is ready to take payments.
Reconnecting…A Bluetooth reader dropped and is trying to reconnect by itself. See Automatic reconnect.
Waiting for readerSelflane Hub is looking for the reader you last connected, searching now or waiting to search again.
Connecting…The reader is installing a required update as it connects.
Not connectedNo reader is connected. Tap Discover a reader to connect one.

For a Stripe reader, the Terminal Location row shows the location the reader is registered to. You can’t change it here. To use another location, disconnect the reader and connect again. If the reader reports a location that isn’t in the business’s list, the row shows Unknown location. If there’s no location at all, it shows No location set up. See Create a location.

A PAX terminal shows as PAX terminal with its IP address, and has no Terminal Location row.

A Stripe reader’s name is the label it has in Stripe, such as Front counter. A reader with no label shows as Bluetooth reader or Network reader with the last 4 characters of its serial number.

While Settings is open, a message shows when a Stripe reader connects, naming the reader and its location, for example Front counter connected · Main Street. When a reader disconnects, including when you tap Disconnect or Change reader, you see Reader disconnected.

Change the reader

  1. Unlock Payments.
  2. Tap Change reader.
  3. In Change reader?, tap Disconnect and search. To keep the current reader, tap Keep this reader.
  4. The button shows Disconnecting…. When the current reader is gone, card reader setup opens. Connect the new reader as in Connect a Stripe reader or Connect a PAX terminal.

The current reader has to disconnect first, because a reader can’t search for another while it’s connected. If you leave setup without connecting a new reader, the device has no reader until you connect one.

Disconnect the reader

Unlock Payments and tap Disconnect. The button shows Disconnecting… until the reader is gone. If the reader was reconnecting, this can take up to 15 seconds.

Disconnecting also makes Selflane Hub forget the reader, so it won’t reconnect by itself. The kiosk can’t take cards until you connect a reader again.

You can’t change or disconnect the reader while a software update installs.

Choose Bluetooth or Network

When you connect a Stripe reader, card reader setup asks how the reader connects:

  • Bluetooth (Pairs with this device): for the Stripe M2. Keep it near the device.
  • Network (Wi-Fi or Ethernet): for a Stripe smart reader, such as the S700, S710, or WisePOS E. Register it to your Terminal location, and put it on the same Wi-Fi or Ethernet network as the device. Readers that are offline show Offline and can’t be selected.

A PAX terminal always connects over the network by its IP address. See Connect a PAX terminal.

If a network reader won’t connect, setup shows one of these:

  • No network readers at this location: no reader is registered to the Terminal location you picked. Pick another location, or register the reader under Locations in the Back Office .
  • This reader is busy: the reader is taking a payment for another device. Tap Cancel on the reader, then tap Try again. To pick another reader, tap Back to readers.
  • Couldn't reach the reader: check that the reader and this device are on the same Wi-Fi or Ethernet network. On an iPad or iPhone, also check that Local Network access is on for Selflane Hub. Then tap Try again.

If you open card reader setup while a Bluetooth reader is reconnecting, setup shows Reconnecting to <reader>…. Tap Stop reconnecting to search for readers.

Install a reader software update

When Stripe has an optional update for a connected reader, the card shows Software update available, how long it takes (for example about 2–5 min), and, if Stripe sets one, a Required by date.

  1. Unlock Payments.
  2. Make sure the reader shows Connected, is charged, and is near the device. Install update is grayed out while the reader is Reconnecting….
  3. Tap Install update.

The card shows Installing update with a percentage. Card payments pause while it installs, so install updates when the kiosk is quiet.

If an optional install fails, the card shows Software update available again, with no error message. Check that the reader is charged and nearby, then tap Install update again.

If a reader needs a required update when it connects, Selflane Hub installs it as part of connecting. The card shows Connecting… and Updating reader with a percentage, then Keep the reader nearby and charged. This can take a few minutes.

Automatic reconnect

Selflane Hub remembers the last reader you connected on this device. It reconnects that reader by itself when the reader drops, the app restarts, or a network reader restarts overnight.

  1. Bluetooth readers reconnect first. Right after a drop, a Bluetooth reader shows Reconnecting… for up to 3 minutes while it tries to reconnect by itself. To stop waiting and search for the same reader instead, tap Stop reconnecting. Network readers and PAX terminals skip this step.
  2. Selflane Hub searches for the reader. The card shows Waiting for <reader> to come back and searches for the reader right away. Searching… shows during each search, which can take up to 2 minutes. If a search doesn’t find the reader, Selflane Hub tries again after 30 seconds, then 1, 2, and 5 minutes, then every 5 minutes.

While the card shows Waiting for <reader> to come back:

  • Try now searches right away. It’s grayed out while a search runs.
  • Forget reader stops reconnecting and forgets the reader. Unlock Payments first.
  • Discover a reader opens card reader setup to connect a different reader. Unlock Payments first.

Bringing Selflane Hub back to the screen also starts a search right away. While you search for or connect a reader yourself, the automatic search waits, and it starts again 30 seconds after you finish.

On the kiosk, guests can’t pay until the reader is back. While a Bluetooth reader is Reconnecting…, the Review screen shows Reconnecting to card reader… · please wait or ask a team member. Otherwise it shows Card reader unavailable · please ask a team member.

The device remembers only one reader. If you switch to another business and connect a reader there, the first business’s reader is forgotten. Switching processors with Save and switch to PAX or Switch and restart also forgets the reader. Card reader setup opens after the restart instead.

When reconnecting stops

Selflane Hub stops searching and waits for you in two cases. The card’s status shows Not connected.

MessageWhat to do
This reader may be in use by another deviceA network reader dropped again within 10 minutes of Selflane Hub reconnecting it. Make sure no other device is using the reader, then tap Try now.
<reader> can't be found without Bluetooth permission. Tap Discover to allow it.On Android, Selflane Hub doesn’t have the Location and Nearby devices permissions it needs to search for a Bluetooth reader. Try now isn’t shown. Unlock Payments, tap Discover a reader, and allow the permissions when asked.
Last updated on