Self-Service Kiosk
Kiosk mode turns a tablet or touchscreen terminal into a full-featured self-service point: the guest chooses dishes themselves, builds the order, and pays — without staff assistance. The order is automatically sent to the kitchen and appears in the general order feed, just like a regular order placed via QR menu.
The interface runs in a browser on any tablet: Android, iPad, or Windows terminal. It is configured in the App Store — via the "Self-Service Kiosk" card in the integrations block of the selected location. The extension is included in Premium and higher plans.
Next to the "Configure" button on the card, there is "Open Kiosk" — this is a standard link to the storefront with the ?kiosk=1 parameter. The mode is remembered in the device's browser itself, so a tablet "stuck in kiosk mode" can be restored by opening the URL with ?kiosk=0.
What the kiosk can and cannot do yet#
The kiosk shows the location menu with options and add-ons, lets guests edit their cart, and offers tips at checkout. Payment is available at the counter, online through a connected provider, or by card on a configured terminal. The restrictions in the Payment section below apply.
At checkout the guest can enter a promo code by hand or scan it with a barcode/QR scanner attached to the kiosk (see "Promo code and scanner" below). Kiosk steps do not yet offer upsell prompts, SBP payments, emailed receipts, gift-card payments or a loyalty card. Features available on other screens do not automatically become available in the kiosk.
In Russia, the server rejects guest orders containing alcoholic products. The guest should remove alcohol from the cart and ask a staff member, who handles the sale through the POS. Outside Russia, 18+ items can be sold at the kiosk too — with an age check by a staff member (see "Age check 18+" below).
Kiosk settings, including the Exit PIN and tip prompt, belong to the location. Configure each location separately in a chain. The link activates kiosk mode on a particular device; terminal pairing is performed on the kiosk computer.
Guest Order Flow#
The kiosk guides the guest through a fixed route:
- Attract screen — displayed in idle mode. The guest taps the screen to start.
- Order type selection — "Eat in" (at the table) or "Take away" (pickup). Available types are configured in the settings — you can keep only one so that the step is skipped automatically.
- Menu — a full touch-optimized interactive catalog: large category tiles, photos of dishes, options (size, doneness, etc.), and add-ons. The guest adds items to the cart directly from the screen; a counter and order total are always visible at the bottom.
- Cart — a list of selected dishes with the ability to change the quantity or remove a menu item.
- Payment — the guest selects a payment method and confirms the order (more details below).
- Order number — after confirmation, the screen displays the number. The guest says it at the counter or waits to be called. After a few seconds, the kiosk returns to the splash screen on its own, ready for the next guest.
You can go back between any steps — the order is not created until it is confirmed.
Cutlery and curbside pickup. If the location's ordering settings have “Ask how many cutlery sets” and “Curbside pickup” switched on, a “Cutlery” counter and an “I’ll pick up at the car” tick (car, colour, plate, parking spot) appear at payment for “Take away” orders. The QR code on the order-number screen opens the order page — the guest can wait in the car and tap “I’m here” there: staff get a notification. More — Expo screen → Cutlery and curbside pickup.
Payment#
On the payment screen, the kiosk displays the following buttons:
| Method | Description |
|---|---|
| Pay at counter | The guest picks up the order and pays the staff. The order is created immediately with the "Placed" status. Enabled via a toggle in the kiosk settings. |
| Online Payment | Card via a connected provider (Stripe, BOG, TBC, and others). The kiosk redirects the guest to a secure payment page and returns them back; the order is marked as paid as soon as the provider confirms the payment. |
| Card on Terminal | Payment on a bank terminal connected to the same computer via the hardware bridge. Appears only if the terminal is linked to the kiosk (see below). |
Online buttons are pulled from the location's Payments settings: only the providers that are enabled and support the venue's country and currency are displayed. There is no separate toggle for online payment in the kiosk settings.
Card on a terminal next to the kiosk. If a bank terminal is connected to the same computer via the hardware bridge, a third button appears on the kiosk — payment by card right on the spot, without redirecting to a provider's page. The terminal is linked to the kiosk in the "QR Codes" section → "Devices" tab (the panel must be opened directly on the kiosk computer itself — it only detects its own local terminals). After a successful payment, the kiosk marks the order as paid and, if enabled, prints a receipt and fiscalizes the sale. The fiscal receipt lists the items and the service charge as a separate line; tips are not included in the fiscal receipt (they are not the venue's revenue), so the receipt total is lower than the card charge by exactly the tip. The guest's paper receipt shows both the service charge and the tip.
Card decline — the guest can retry the attempt or proceed to pay at the POS: the order remains the same, preventing duplicates. If the connection drops during the charge, the kiosk checks with the terminal; when the outcome cannot be verified, the retry button is not displayed — the guest is invited to the POS to prevent double charging.
Promo code and scanner#
The checkout screen has a Promo code field. The guest types the code and taps Apply — or simply holds a coupon with a barcode or QR code to the kiosk scanner: the scanner works like a keyboard, the kiosk recognises a fast burst of characters ending with Enter and applies the code itself, no need to tap the field first. The server checks the code against the same coupons as the online storefront (Commerce: coupons and promo codes); if it fits, a "Discount" line appears in the total, otherwise "This code can't be applied".
With a promo code applied, card payment on the kiosk terminal is not offered — only at the counter or online (online payment re-checks the coupon on the server). A hint below the field says so.
Age check 18+ (outside Russia)#
If the location has the age check turned on (the same setting as the POS: POS → Settings → Age check; 18+ items are those tagged "18+"/"21+", in a marked category or with a product-type tag), the kiosk won't take payment for an order with such an item without a staff member:
- A yellow Age check: 18+ block appears at checkout with the list of items; the payment buttons are disabled.
- The guest calls a staff member, who checks the ID and enters the staff PIN (the same PIN as for leaving kiosk mode) → Confirm age.
- The server checks the PIN; with the right PIN it marks the order itself as age-confirmed at the kiosk (when and for which threshold — no date of birth or ID data). This mark cannot be forged from the kiosk.
- If the guest changes their mind, Remove 18+ items drops them from the cart.
If no staff PIN is set for the location, age can't be confirmed at the kiosk: the guest is offered to remove the 18+ items or order at the counter. Wrong PINs count together with exit attempts — after a series of errors the check is closed for 15 minutes.
In Russia this setting does not apply to the kiosk: the server rejects guest orders with alcohol (see above).
If neither an online provider nor a terminal is available, the "Pay at counter" button is always displayed — even when the toggle is turned off, ensuring the kiosk is never left without a payment method. Providers can be connected in the Payments section.
Card payment on the kiosk terminal#
If a bank terminal is connected to the kiosk computer via the hardware bridge, the guest pays on the spot, without navigating to a provider's page or approaching a cashier: the kiosk displays a "Pay by card on terminal" button, sends the amount to the terminal, and guides the guest step by step — "insert card", "processing payment", "paid". Once approved, the order is immediately marked as paid (including the terminal transaction details), and the receipt is printed and fiscalized via the bridge if printing and POS integration are configured.
What happens in non-standard situations:
| Situation | What the guest sees |
|---|---|
| Card declined | "Payment failed" and two buttons: try again (a new attempt is sent to the terminal as a separate transaction) or pay at the POS |
| Terminal does not respond before timeout | The kiosk stops waiting and offers payment at the POS; the order remains unpaid |
| Connection to the bridge dropped mid-charge | The kiosk does not offer a retry — funds may have been debited; the guest is directed to the cashier, who will verify the transaction on the terminal |
| Bridge is not running on this computer | The terminal button is not shown at all — standard payment methods remain available |
Linking the kiosk to the terminal is done once directly on the kiosk computer: "QR Codes" section → "Devices" tab → device code and selection of the bridge terminal. The bridge only listens to the local computer, so the setup must be accessed right from it. Do not confuse this with the separate "Devices" section in the admin panel — that section manages staff devices, not the kiosk.
On the same screen, if the corresponding options are enabled, the guest enters their name and selects tips; the venue's service charge is automatically added to the total.
Idle Auto-Reset#
If a guest does not interact with the screen for a specified time (configured in seconds), the kiosk:
- displays a warning with a countdown (15 seconds; the "I'm still ordering" button brings the guest back to their order);
- clears the incomplete order;
- returns to the screensaver.
This protects against "abandoned" carts at busy locations. Completed and paid orders are not affected by the reset.
Interface Protection#
In kiosk mode, a guest cannot:
- switch to the standard menu or QR interface;
- open settings or other sections of the app;
- exit the mode accidentally.
To exit the mode — for example, to reload settings — there is a hidden gesture: 5 consecutive taps in the top right corner. If a PIN is set in the settings, the kiosk will prompt for it; if no PIN is set, it will exit immediately.
Ctrl + Shift + K also asks for the PIN when one is set. Without a PIN, both methods exit immediately. Always set an Exit PIN and lock down the browser using the device settings: the kiosk PIN does not lock the address bar or system commands.
The PIN is checked by the server: it is not published in the storefront's public profile, so it cannot be read from the page code. After 10 wrong attempts within 15 minutes, checking is locked for 15 minutes — even the correct PIN is refused during that time; if staff need to exit urgently, restart the device. Without an internet connection the PIN cannot be checked — the kiosk does not take orders offline either.
Staff menu#
The correct PIN opens the staff menu:
- Reprint last receipt — a copy of the last order's paper receipt marked "RECEIPT COPY", when the guest's receipt jammed or they left without it. The fiscal receipt is not issued again: a copy of the fiscal document is provided at the till.
- Cancel the guest's current order — clears the cart and returns the kiosk to the welcome screen when a guest walked away mid-order. An order already placed for "pay at counter" is cancelled at the till.
- Exit kiosk mode.
- Back to kiosk — close the menu.
The mode is saved on the device: the tablet remains a kiosk after a reboot or page refresh until explicitly exited from the mode.
Kiosk setup in the admin panel#
- Open Admin Panel → App Store.
- Go to the integrations list by location and select the location you need.
- Find the "Self-Service Kiosk" card and click "Configure".
- In the wizard that opens, set the parameters:
- Enabled — activation toggle.
- Order types — "Dine-in", "Takeaway" or both (at least one is required).
- Payment at POS — whether to show a payment-to-staff button.
- Idle timeout — from 15 to 600 seconds, 60 by default.
- Ask for guest name — optional, displayed in the order.
- Tips — whether to show a tip prompt on the payment screen.
- Exit PIN.
- Save the settings. Next to it is an "Open Kiosk" button — it opens your location's menu in kiosk mode. Open it on the tablet (or copy the address into its browser) — the device will remember the mode.
The welcome text on the splash screen is taken from the location's Appearance settings ("Welcome text" field).
Hardware and Browser#
The kiosk works in any modern browser. Recommendations for stationary use:
- Android tablet or iPad: lock the browser in kiosk mode (Guided Access on iOS, pinned apps or owner mode on Android).
- Windows terminal: Edge or Chrome kiosk mode (
--kioskflag) so that the user cannot close the tab. - Screen size from 10 inches — a smaller screen will result in an inconvenient interface.
- Set portrait or landscape orientation and lock it in the tablet settings.
An internet connection is required: the order is created in real time.
What you need to get started#
- A tablet or touch terminal with a browser — Android, iPad or Windows.
- The kiosk switched on in the App Store — the "Open kiosk" button is there too.
- A menu with photos and prices — the kiosk shows the same storefront as the QR menu.
- A payment method: online payment on the storefront, or payment at the POS by order number.
- The bridge — if the guest pays by card on a bank terminal connected to the same computer.
- A queue display — if the guest needs to see the number of a ready order.
Stop-list changes and connection loss#
The kiosk re-reads the menu by itself: on the attract screen every 5 minutes, and when a new order starts if the last read is more than a minute old. So an item put on the stop-list ("86"), a new price or a removed dish reaches the kiosk without a reload — by the next guest. The menu a guest already has open does not change under their fingers; if an item was removed meanwhile, the server checks availability again and rejects orders with unavailable items. The kiosk shows the reason; return to the cart, remove the unavailable item, and submit again.
If a checkout request remains queued, the kiosk shows No connection — your order will be sent automatically. Keep the page open and wait for checkout to continue: this is not an order confirmation. Back or an idle reset ends the wait and withdraws the queued request; if it has already arrived, the kiosk sends a cancellation. If the connection drops during a terminal charge, ask the cashier to check the transaction.
Limitations#
- Terminal payment through the bridge has not been run on real hardware. It is written and will only reach POS computers with a new bridge release — plan for payment at the POS as the primary scenario.
- Online payment is not available everywhere. There are few live payment integrations, and on the Russian brand there is currently no online payment at all (Payments).
- The queue display shows one pickup point. Several windows and spoken announcement of the number are in the backlog.
- A connection is needed to complete checkout. If it drops, the kiosk may wait to send the order; the waiting screen does not mean the order has been accepted.
Troubleshooting#
| Symptom | Cause | What to do |
|---|---|---|
| An item is visible but the order is rejected | The menu was opened before a stop-list change | Read the reason, return to the cart and remove the item; then refresh the menu |
| "No connection — your order will be sent automatically" | Checkout is waiting to send the request | Keep the page open, restore the connection, and wait for confirmation |
| The exit shortcut opens a PIN dialog | The location has an Exit PIN | Enter the staff PIN; this is the expected exit protection |
The kiosk drops out of kiosk mode. The mode is remembered by a URL parameter — pin the tab in the tablet operating system's own kiosk mode and disable gestures.
Payment does not go through. Check which method is selected: if it is card-on-terminal, that scenario has not been verified on live hardware yet; if it is online payment, check whether a provider is connected for your country.
The order is not printed in the kitchen. Printing goes through the bridge on the POS computer, not through the kiosk tablet.
The screen does not reset after a guest. Check the idle auto-reset setting.
A guest cannot see a dish. Same as on the storefront — check the 86 list and the availability schedule.
Related Sections#
- Orders — how kiosk orders appear in the feed and update statuses
- Kitchen (KDS) — kitchen display screen where kiosk orders arrive
- POS — staff workstation for orders taken by employees
- Payments — connecting online providers for kiosk payments
- QR Menu — alternative scenario: guest orders from their smartphone
Frequently Asked Questions#
Do I need a separate app or special software?#
No. The kiosk runs in a standard browser on any tablet or touchscreen monitor. No additional installations are required.
How is the kiosk different from a QR menu?#
With a QR menu, guests scan a code with their phone and place orders on their device. A kiosk is a stationary tablet provided by the venue: guests walk up to it and place orders right there. Both options can be used simultaneously.
How do kiosk orders appear to the staff?#
They appear in the "Orders" section and on the kitchen display (KDS) just like orders placed via QR menu or POS — with the "Dine-in" or "Takeaway" order type and the guest's name if it was requested. The "kiosk" source is recorded in the order data, but there is currently no separate badge on the order card: for staff, it looks like a standard guest order.
Can I limit the menu for the kiosk?#
There is currently no dedicated "kiosk version" of the menu — the full catalog of active menu items for the location is displayed. Dishes hidden in the menu settings are not shown to the guest.
What happens if the tablet loses internet connection mid-order?#
If the kiosk shows "No connection — your order will be sent automatically", keep the page open and wait for checkout to continue. Do not treat the order as accepted before confirmation. Going back or an idle reset cancels the wait, so checkout must be started again.