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
- Install the kiosk app on the device.
- On first launch the app shows a device key.
- Dashboard: Channels → Kiosk → Add.
- Name
- Device Identifier: must exactly match the app’s device key
- Description (optional)
- Status Active/Inactive
- Save.
- In the kiosk app, log in with your seller email and password.
- Enable Kiosk on product Channels and payment methods.
- 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
- Device Identifier matches the app key (copy carefully).
- Status Active.
- Trial/subscription valid.
- Store is in the same Test/Live mode you expect for payments.