The Operator Console, visually

One console for your whole fleet — machines, money, ads, and play.

This guide is a plain-language, picture-first tour of the Kiosk-X Operator Console (operator.kiosk-x.ai, plus the native Android app from the downloads hub) and how it connects to everything else in the Kiosk-X family.

The big picture

Your kiosk is more than a vending machine: its screen earns ad money, its QR codes start games and quests, and every one of those loops reports back to the same operator console.

Everything below is one section per console area: what it shows, where the data comes from, and the one thing to check daily.

🏠 Dashboard — your morning glance

Route: / · Check daily: Today's Sales + the alert bell.

The bell in the top bar mirrors the notifications; the avatar menu holds Change Password and sign-out. Every screen you visit becomes a workspace tab so you can flip between, say, a machine detail and its sales.

🏪 Machines & inventory

Routes: /machines, /machines/{serial}, /faults, /products.

Register a machine by the serial inside its door, watch its aisles (planogram, prices, stock), re-enable faulted aisles, and bind the Nayax card reader so card takings settle to your merchant account.

💳 Sales & money

Routes: /playbook, /sales, /reports, /pnl, /tax, /venues, /warehouse, /payouts.

The first hour is /playbook — six steps in this order: confirm the fleet, put a tax rate on file, receive open purchase orders, record each site and its host deal, add crew rates, open the P&L once. Tax and inventory affect every later number; skip them and the first P&L looks too good.

Orders stream in from the machines (cash, card, wallet). Reports slice revenue by period, machine, and product, and reconcile card settlement against your Nayax accounts. Refunds are one tap from any order. /pnl is the identity (gross − tax = net − FIFO − host − …); /venues is the only place host commission is defined — name the serial when you create the venue if the cabinet has already been selling, or the host is owed nothing for that history. /tax schedules do not reprice stamped sales; a cabinet's own jurisdiction rate does, except for a period already remitted or paid out (/api/v1/tax/restatements-blocked).

📋 Subscriptions & billing

Route: /subscriptions — four tabs, mirroring the classic operator portal:

• Each machine needs a monthly device plan (free trial first).
• Renew Equipment (inside a plan's device list) shows each device's expiration date and renewal state.
• Manage Subscriptions hands off to the hosted billing portal (Stripe-simplified billing) for invoices and payment method.

📺 Ad revenue — your screens earn while idle

Route: /ads (summary also on /reports and the dashboard).

The mediation engine ranks fill sources by eCPM under your floor price; every play lands in the proof-of-play ledger, so the revenue split you see is counted from actual plays, not estimates of estimates.

🎮 Play — QuestX & GameWorld

Where: Reports → Player engagement; per-machine toggles on the machine detail page.

• QuestX free-product program — shoppers scan the play QR, finish a quest, and earn a one-time code for a free product (you cap the price). The report shows giveaways, retail value, and the credit funnel.
• GameWorld multiplayer — the kiosk screen hosts join-in games; sessions, players, and rewards granted roll up per machine.

Both are demand generators: the machine gets foot traffic, the play loop gets players, and you see it all next to the sales it drives.

🆘 Support, in the corner of every screen

The floating bubble opens a five-tab widget: Home (quick actions), Messages (your ticket threads), Tickets (open + track), Help (article library), and Tasks — a setup checklist that checks itself off as your account reaches each milestone, with a QR to grab the Android operator app.

🎨 One design language

The console, the Android app, the kiosk screen, and the buyer-facing pages all share the Kiosk-X design system: deep-space surfaces, purple #a855f7 + cyan #06d0f9, Poppins type, and the same motion vocabulary. If a surface looks different, that's a bug — the tokens ship from one file.

Where to go next

• Operator guide — task-by-task API reference, including host venues, stock receipts, tax, and the P&L
• Roles (RBAC) — operator vs full admin vs MFA super-admin vs factory; the operator picker; manufacturer shipping
• /playbook — first-hour money onboarding in the console
• Screen ads & sponsorships — the monetization playbook
• Free-product program — QuestX mechanics
• Payments & Nayax — settlement routing
• Design system — the shared brand contract