Skip to content

How to set up a kiosk and what customers can do

Pair a kiosk device with the dashboard and understand what the kiosk app supports.

Overview

Channels → Kiosk creates a kiosk record. The in-store kiosk app is separate from the seller mobile app. Customers order on the kiosk; you manage catalog and payments in the dashboard.

Before you start

  • Header can be any channel while you manage kiosks, but enable Kiosk on products and payment methods.
  • Download the kiosk app from the links on the kiosk add/list page (App Store and/or Play Store when configured).

How to use it

  1. Install the kiosk app on the device.
  2. On first launch the app shows a device key.
  3. Dashboard: Channels → Kiosk → Add.
    • Name
    • Device Identifier: must exactly match the app’s device key
    • Description (optional)
    • Status Active/Inactive
  4. Save.
  5. In the kiosk app, log in with your seller email and password.
  6. Enable Kiosk on product Channels and payment methods.
  7. Place a test order in Test Mode, then go live.

One physical device maps to one kiosk record. Keep the identifier secret; it is how the API recognizes the device.

Understanding the options

What kiosk customers can do

  • Browse listed, in-stock products for the Kiosk channel
  • Variants and attributes (except rely on radio/dropdown if you also use QR)
  • Sales, coupons including Tiered Discount (the unlocked tier’s Discount only), taxes, charges, tips, and comments (tips/comments from Appearance → Cart & Checkout)
  • Pay with methods enabled for Kiosk: manual, Stripe, Tap to Pay, QR code payment. When a coupon covers the whole bill, those Stripe paths finish on the kiosk without opening a payment page.
  • Guest name and email before ordering (phone optional). Receipts and email-restricted coupons use this address.
  • Platform fee and coupons use the Kiosk channel settings from the dashboard (per-channel platform fee row; coupon limits such as first-order-only or allowed emails need the guest email at checkout).

What kiosk does not do

  • Shopfront appearance (colors, catalog layout, banners, popups, business links, SEO, custom CSS)
  • Fulfillment method picker / delivery
  • Order scheduling
  • Unlisted or out-of-stock products (hidden)
  • Couponly UI
  • Free Products on a Tiered Discount (kiosk always uses that tier’s Discount)
  • Shopfront tiered reward progress dock (that strip is Hosted Shopfront only). Customers can still enter a Tiered Discount coupon code for the money discount.

Kiosk sidebar in the app is essentially logout (to avoid locking the floor device accidentally).

Important

  • Inactive kiosk records reject orders.
  • Identifier mismatch returns a sales channel not found style error.
  • Payment min/max on methods is not enforced on kiosk.

Common problems

Problem

Kiosk cannot load the store.

What to check

  1. Device Identifier matches the app key (copy carefully).
  2. Status Active.
  3. Trial/subscription valid.
  4. Store is in the same Test/Live mode you expect for payments.