Fix BuiltKIOSK problems

What to do when the kiosk won't pair, shows "temporarily unavailable", doesn't print, can't take cards, or orders don't reach the kitchen.

TroubleshootingUpdated

Pairing says the code is wrong or expired#

  • Codes last 15 minutes and work once. Generate a new code (Store Management → Pair Device on a register, or Terminals → Pair Terminal in BuiltOFFICE) and type it straight away.
  • Make sure you picked Kiosk (register) or Self-serve Kiosk (BuiltOFFICE) when you made the code.
  • Network timeout — check Wi-Fi means the tablet can't reach the internet. Fix the Wi-Fi and try again.
  • If the register says Terminal limit reached, your plan has no free device slots. Revoke an old device in BuiltOFFICE (Terminals) or upgrade.

Customers see "This kiosk is temporarily unavailable"#

  • If staff also see Staff: this kiosk was unpaired from the store., the kiosk was removed in BuiltOFFICE. Tap Pair this kiosk again and use a new code.
  • Otherwise the store's subscription or licence needs attention. The owner should check BuiltOFFICE (see Plans and billing), then tap Retry on the kiosk.

I can't open Settings#

  • Settings won't open while the admin PIN is still 0000. When asked, tap Set PIN and choose your own.
  • Forgot the PIN? Contact support.

Nothing prints#

  1. Open Kiosk Settings and check Printer. Sunmi kiosks use Sunmi. Other tablets use Network (enter the printer's host and port, then Save host/port) or Bluetooth (tap Pick paired device).
  2. Tap Test print.
  3. For a Bluetooth printer, pair it in the tablet's Android Bluetooth settings first.
  4. Use Hardware diagnostics in the admin menu to check the printer.

If a customer's receipt didn't print, they can tap Print again on the thank-you screen.

"Card terminal" can't be selected#

  • Configure the terminal first: Card terminal → Configure card terminal, fill in the details, tap Test connection, then Save terminal.
  • Sync orders to POS must be on. Card sales are recorded through it.

The card terminal doesn't respond#

  • Check the terminal is on and on the same network, and that its IP address hasn't changed. Run Test connection again.
  • The customer can tap Card terminal not responding? Cancel to go back to the cart.
  • If the screen shows Card payment unavailable — please see staff, nothing was charged and the order was not placed. Help the customer pay at the register.
  • If your registers show a kiosk payment alert, check the card terminal's own history before charging the customer again. See Card terminal problems.

Orders don't reach the kitchen#

  • If the kiosk shows Order not sent to the kitchen, ask the customer to bring the receipt to the counter and enter the order by hand.
  • Check that your kitchen display is online (see Fix BuiltKDS problems).
  • In Kiosk Settings, tap Send test order to KDS to check the link.
  • If you use a kitchen printer at the kiosk, check Print kitchen ticket on every order and the Kitchen printer settings.

Orders are stuck on the kiosk after an internet outage#

The kiosk sends saved orders automatically when the connection returns. To check, open Kiosk Settings and tap Unsent orders.

An item is missing from the kiosk menu#

Check in BuiltOFFICE that the product is active with Show on Kiosk on, its category isn't POS only, the kitchen hasn't marked it out of stock, and — if you use time-based menus — that it is in the menu for this time of day. See Choose what the kiosk sells.

The kiosk shows an update screen#

Download the latest BuiltKIOSK APK from the Downloads page on pos.builtsofthub.com and install it over the old one. Your pairing and settings are kept.

Was this helpful?

Still need help?

Open a ticket from the app

In any BuiltSOFTHUB app, open Help & Support and choose Report a problem. Our replies appear under My tickets.

Email us

Write to support@builtsofthub.com. Tell us the store name and what you were doing when it happened.