Skip to Content
GuidesSet up Selflane Hub

Set up Selflane Hub

Prepare a self-service screen so guests can place orders and pay without staff entering each order. Check Kiosk hardware and your business’s Kiosk access before you start.

Install and sign in

  1. Install Selflane Hub for iOS  or Android .
  2. Open the app and tap Get Started.
  3. Complete the hosted sign-in screen with your Selflane account.
  4. Choose the business this kiosk will serve. Your account needs POS access to that business.

Confirm the selected location before connecting hardware. To change it later, open Settings → Business → Switch business.

Connect the card reader

Each device takes cards through one processor: a Stripe reader or a PAX terminal. Check Kiosk hardware to see what each needs.

Unlock Payments

  1. Open Settings → Payments.
  2. Tap Unlock. A manager chooses their name and enters their PIN to unlock the card reader settings.

The same staff who can approve leaving the kiosk can unlock Payments. See Switch to kiosk. Payments locks again when you sign out, switch business, or close and reopen the app. With the latest Selflane Hub 1.3.0 update, when the app restarts itself, for example to switch processors, it reopens the same business and Payments stays unlocked.

Unlock works without internet once the device has loaded the business while online. Selflane Hub saves who can approve when you choose the business.

Connect a Stripe reader

  1. Power on your Stripe reader. Keep a Bluetooth reader near the kiosk. Connect a network reader to the same Wi-Fi or Ethernet network as the kiosk.
  2. In Payments, tap Discover a reader. If asked to choose a provider, choose Stripe Terminal.
  3. Choose Bluetooth or Network, and confirm the correct Terminal Location.
  4. Tap Discover devices, or Find readers for a network reader. Select your reader and tap Connect.
  5. Check that the reader shows Connected.

Allow the permissions requested to discover nearby readers. If no Terminal location is available, ask an owner to create one.

Connect a PAX terminal

Turn on the PAX terminal and connect it to the same network as the kiosk. Find the IP address on the terminal’s screen.

  1. In Payments, tap Discover a reader. If a Stripe reader is connected, tap Change reader, then Disconnect and search.
  2. Choose PAX. If setup opens on the Stripe step, tap Change first.
  3. Enter the address in Terminal IP address.
  4. Tap Test connection. Check for Terminal found and, if shown, the terminal’s serial number.
  5. Tap Save and switch to PAX. Selflane Hub restarts and opens card reader setup again.
  6. Under Connection, tap Connect.
  7. Setup closes. In Payments, check that the card reader shows PAX terminal, Connected, and its IP address.

If the device already uses PAX and the terminal’s IP address changes, open the PAX step, enter the new address, and tap Save. The app does not restart. Tap Connect if the terminal is not connected.

If you see This terminal seems to be on a different network, put the terminal and the kiosk on the same Wi-Fi.

If you see Couldn't reach the terminal or Couldn't connect to the terminal, check that:

  • The terminal is turned on.
  • The terminal and the kiosk are on the same Wi-Fi network.
  • The IP address matches the one shown on the terminal.
  • On an iPad or iPhone, Local Network access is on for Selflane Hub. Tap Open Settings to check it.

If the terminal disconnects later, Selflane Hub reconnects it. Guests can’t tap Pay until it is back.

Switch back to Stripe

  1. Unlock Payments. Tap Discover a reader, or tap Change reader and then Disconnect and search if the terminal is connected. Setup opens on the PAX step.
  2. Tap Change next to PAX, then choose Stripe Terminal.
  3. In Switch to Stripe?, tap Switch and restart.
  4. After the restart, connect your Stripe reader.

Connect the receipt printer

  1. Connect your EPSON or Star printer to the same network as the kiosk.
  2. Open Settings → Printers and tap Set up printer.
  3. Select the printer and tap Connect.
  4. Tap Print test receipt to check the connection and paper.

The kiosk prints the customer receipt. Configure kitchen printing separately on your POS.

Switch to kiosk

  1. Return to Home and tap Switch on the Switch to kiosk card.
  2. Review the confirmation and tap Switch to kiosk.
  3. Check that the welcome screen shows the correct business.
Kiosk welcome screen showing the selected business, Start Ordering button, and English and Spanish options

On an unattended iPad or iPhone, enable Guided Access in the device’s Settings → Accessibility, then start a Guided Access session in Selflane Hub. Switching to kiosk alone does not lock the device.

On Android, switching to kiosk does not hide the system buttons, so guests can still leave the app.

To return to the operator screen, tap the exit icon in the bottom-right corner of the welcome screen. A staff member who can approve chooses their name and enters their PIN, which is their Passcode in the Back Office. End Guided Access first if it prevents that action.

A staff member can approve leaving the kiosk when they have a Passcode in Team and either of these:

  • Advanced Access on their profile.
  • A job role with Manage Access in Job Roles.

If no job role at your business has Manage Access, any staff member with a passcode can approve. If nobody qualifies, the device does not switch to kiosk. Give a qualifying staff member a passcode in the Back Office, then try again.

Check the guest screens

  1. Tap Start Ordering on the welcome screen.
  2. Choose Here or To Go, then tap Continue.
  3. Check the menu tabs, categories, prices, and Customize options before leaving the kiosk ready for guests.
Kiosk order type screen with Here selected, To Go option, and Continue button

With a PAX terminal, the kiosk shows Finish on the card terminal when the guest taps Pay. The guest taps, inserts, or swipes their card on the terminal and follows its prompts.

Payment needs checking

If the kiosk can’t confirm whether a card was charged, the guest sees Payment needs checking and See a team member to finish your order. The screen asks the guest not to pay again or use the card terminal until a team member has checked.

On Android with a PAX terminal and the latest Selflane Hub 1.3.0 update, the app also checks the terminal’s report after the terminal approves or cancels a sale. It shows Payment needs checking if the guest was charged twice for one order, or paid before canceling.

Don’t take another payment from the guest until you know whether the first one went through. Contact Selflane support if you need help.

What if setup fails?

  • No businesses appear. Ask your owner or manager to grant your account POS access, then sign in again.
  • Kiosk is not enabled. An owner can review Kiosk access in Plan & Billing → Manage Plan → Add-Ons in the Back Office.
  • No reader appears. Check power, Bluetooth permissions, distance, and whether the reader is connected to another device.
  • The PAX terminal can’t be reached. Check the IP address, power, and that the terminal and kiosk are on the same network. See Connect a PAX terminal.
  • The receipt does not print. Check paper, power, and that the kiosk and printer are on the same network. Run the test print again.
Last updated on