Troubleshoot card readers and printers in Selflane Hub
Use this page when the kiosk can’t take cards or print receipts, or when card reader or printer setup shows an error. Find the message you see, then follow what to do.
Check these first
Most reader and printer problems come down to one of these:
- Power. The reader, terminal, or printer is turned on. A Bluetooth reader is charged.
- The same network. A network reader, PAX terminal, or printer is on the same Wi-Fi or Ethernet network as the device.
- Internet. The device is online. Selflane Hub needs Selflane to search for Stripe readers and to take payments.
- Local Network access (iPad and iPhone). In the device’s
Settings→Privacy & Security→Local Network,Selflane Hubis on. Without it, Hub can’t reach network readers, PAX terminals, or printers. - Location and Nearby devices (Android). Hub needs both permissions to find a Bluetooth reader.
To change the reader, leave the kiosk first. Leaving needs manager approval. When a manager leaves the kiosk while the card reader isn’t connected, Payments unlocks, and card reader setup opens if the reader is still down.
The kiosk can’t take cards
When the card reader isn’t connected, guests can’t tap Pay. Under Pay, they see one of these:
| Guest sees | What to do |
|---|---|
Reconnecting to card reader… · please wait or ask a team member | A Bluetooth reader dropped and Hub is reconnecting it. Bring the reader closer and check that it’s charged. Hub tries for up to 3 minutes. |
Card reader unavailable · please ask a team member | Leave the kiosk and open Settings → Payments. Check the reader’s status and follow Manage the card reader. If a reader update is installing, wait for it to finish. |
If the reader disconnects while a guest is paying, the guest sees Card payment temporarily unavailable and Please ask a team member — your order is still saved. The order stays on screen, and the guest can tap Try Again once the reader is back.
Hub reconnects the last reader by itself and keeps searching for it. See Automatic reconnect. If the Card reader card shows one of these, Hub has stopped searching and needs you:
| Message | What to do |
|---|---|
This reader may be in use by another device | A network reader dropped again soon after Hub reconnected 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, unlock Payments, tap Discover a reader, and allow Location and Nearby devices. |
Stripe reader messages
These messages show in card reader setup, under Couldn't connect. Tap Back to devices, then search again.
| Message | What to do |
|---|---|
No card-reader location is set up for this business. Ask an admin to add a Terminal location before connecting. | An owner creates a Terminal location. |
Allow Location and Nearby devices to find readers, or turn them on in Settings > Apps > Selflane Hub > Permissions. | On Android, allow both permissions. If you denied them before, turn them on in the device’s Settings. |
No reader found — make sure it's powered on and nearby, then try again. | The reader you picked went offline or out of range. Turn it on, bring a Bluetooth reader closer, or check that a network reader is online. Then search again. |
Couldn't reach the reader. Check your connection and try again. | Hub couldn’t start the search or finish connecting, or a Bluetooth search found no reader within about 2 minutes. Check the device’s internet connection, and that the reader is on, charged, and nearby. Then try again. |
This reader is taking a payment. Tap Cancel on the reader, then try again. | A network reader is busy with another device. Tap Cancel on the reader, then connect again. |
Couldn't reach the reader. Put it on the same Wi-Fi or Ethernet network as this device, then try again. | Put the network reader on the same network as the device, then connect again. |
In Selflane Hub 1.3.0 or later, a network reader that won’t connect shows its own screen with Try again and Back to readers:
This reader is busy: the reader is taking a payment for another device. TapCancelon the reader, then tapTry again.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, the screen also asks you to checkLocal Network is on for Selflane Hub. TapOpen Settingsto check it. Then tapTry again.
If setup shows 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. See Set up terminal locations.
Network readers show Offline in the list when Stripe can’t reach them. You can’t select an offline reader. Check its power and network connection, then tap Search again.
If an optional reader software update fails, the card shows Software update available again, with no message. See Install a reader software update.
PAX terminal messages
These messages show on the PAX step of card reader setup. PAX terminals need Selflane Hub 1.3.0 or later.
| Message | What to do |
|---|---|
Enter the terminal's IP address, like 192.168.1.50 | The address isn’t a valid IP address. Enter the one the terminal shows on its screen. |
This terminal seems to be on a different network. Put both on the same Wi-Fi. | The address doesn’t look like it’s on the device’s network. Check the address, and put the terminal and the device on the same Wi-Fi. You can still test the connection. |
Couldn't reach the terminal | Test connection got no answer. Check the list below, then test again. |
Couldn't connect to the terminal | Connect failed. Check the list below, then tap Connect again. |
Save the terminal's IP address to connect. | Enter the address and tap Save before you tap Connect. |
When Hub can’t reach or connect to the terminal, check that:
- The terminal is turned on.
- The terminal and this device are on the same Wi-Fi network.
- The IP address matches the one shown on the terminal. A terminal can get a new address after it restarts.
- On an iPad or iPhone, Local Network access is on for Selflane Hub. Tap
Open Settingsto check it.
If the terminal’s IP address changed, enter the new one and tap Save. See Connect a PAX terminal.
Kiosk payment messages
When a payment doesn’t go through, the kiosk tells the guest what happened and whether they were charged. This table lists the messages where a guest is likely to ask for help. For every message, including Canceled and PAX repeat payments, see When a payment doesn’t go through.
| Guest sees | What to do |
|---|---|
Card declined | The guest tries a different card. |
Payment not completed or Payment couldn't be completed | Nothing was charged. The guest taps Try Again. |
Couldn't prepare your order | Nothing was charged. The guest taps Try Again, or Back to cart if that’s the only button. If it keeps happening, check the device’s internet connection. |
We couldn't get your total | Selflane couldn’t price the order. Check the internet connection, then the guest taps Try again. |
This store can't take your order right now | Selflane refused the order. Read the reason shown on the card, fix it in the Back Office (for example, your hours), then the guest taps Try again. |
See a team member to finish your order | Don’t let the guest pay again until you’ve checked. Follow Interrupted kiosk payments. |
Printer messages
These messages show when you set up a printer in Settings → Printers.
| Message | What to do |
|---|---|
Couldn't search for printers, then The search couldn't start. Make sure this device is on the shop's Wi-Fi, then try again. | Connect the device to the shop’s Wi-Fi. On an iPad or iPhone, check that Local Network access is on. Then tap Search again. |
Couldn't search for printers, then Search timed out. Check the printer is on the same network as this device, then try again. | Put the printer on the same network as the device, then tap Search again. |
Couldn't reach the printer. Check that it's on the network and powered on, then try again. | Check power, the network cable or Wi-Fi, and that the printer and device are on the same network. |
The printer didn't respond in time. Check the network and try again. | Check the network, then connect again. |
The printer is offline. Power it on and check the network, then try again. | Turn the printer on and check its network connection. |
Another device is using this printer. Disconnect it or restart this app, then try again. | Disconnect the other device from the printer, or close and reopen Hub. |
That isn't a supported Star or Epson receipt printer. Pick another one. | The device at that address isn’t a supported printer. Use the back arrow and pick another one. See Kiosk hardware. |
Connect failures show under Couldn't connect. Tap Back to printers to return to the Printers pane. An unsupported printer has no Back to printers, so use the back arrow. On an iPad or iPhone, a failure that could be a blocked connection also shows Local Network is on for Selflane Hub with Open Settings.
If a test print fails, Hub shows Test print didn't go through, the reason, and Print test receipt again. A timed-out test print shows Print timed out — the receipt may already have printed. If nothing came out, print again. Check the printer before you print again. See Test print.
The receipt didn’t print
When a kiosk receipt doesn’t print, the guest sees Receipt didn't print — note your order number. on the Payment approved screen. The payment and the order aren’t affected.
- Give the guest their order number from the screen. Hub doesn’t reprint the receipt.
- Check that the printer is on, has paper, and is on the same network as the device.
- Leave the kiosk, open
Settings→Printers, and check that a printer is set up. With no printer set up, every receipt fails this way. - Tap
Test print. If it fails, follow Printer messages.
If the printer refused the connection, Hub tries again for up to about 20 seconds before it shows the message. It doesn’t try again once the receipt could have reached the printer, so it never prints twice.
Related links
- Manage the card reader: status, automatic reconnect, and reader updates.
- Tips and payments: the kiosk payment flow and the messages guests see.
- Interrupted kiosk payments: what to check before a guest pays again.
- Selflane Hub settings: set up, change, or remove the printer.
- Set up Selflane Hub: connect a reader, a PAX terminal, and a printer.
- Kiosk hardware: supported card readers and printers.