From first install to everyday use.
Choose the job you need to do. Each guide starts with a visual walkthrough, followed by the complete instructions.
Debug a Nayax reader
Locate the failed checkout, MDB, payment, vend or settlement step.
Open guide →NayaxNew ZHZN machine and Nayax setup
Install the APK, record its machine ID, bind the reader and complete acceptance.
Open guide →InstallerInstall & operate Android
Set up the Android computer inside the vending machine, then prove it starts safely and stays in kiosk mode.
Open guide ManufacturerTest, sign & ship
Test this physical cabinet, record what is actually fitted and verify both signatures before shipping.
Open guide Machine operatorReceive & run a machine
Receive the cabinet, set it up in Operator X and prove a real purchase before opening it to shoppers.
Open guide Shopper & supportBuy, collect & get help
Choose a product, follow the displayed payment steps and collect it. You do not need Operator X or a service PIN.
Open guide Fleet managerManage a fleet & release safely
Give every machine an accountable owner, work unresolved cases and expand releases only after real operating evidence.
Open guideMore manuals & technical reference
Reference for operators, manufacturers and integrators. These pages do not report live machine state; check Operator X for current status.
Visual installation atlas — every critical flow
27 illustrated workflows: Android and Wi-Fi basics, ZHZN/Reyeah/companion, manufacturer sign-off, Operator, shopper, fleet and a cabinet-specific checklist
Machine address and installation checks
Review complete numbered addresses and separately confirm cabinet placement for ZHZN, Reyeah and VC EL
Machine apps and Operator: start here
Reyeah, ZHZN and VC EL / DFY — choose the right installer and complete machine acceptance
Operator Android and Apple
Verified signed releases, installation, phone workflows and hardware-dependent features
Android cabinet remote access
AnyDesk setup, OEM and Android limits, native screen scope, secure support handoff and unattended reboot acceptance
Reyeah operating manual
Identify, install, claim, fill, sell, reconcile and maintain a Reyeah JD cabinet
Publish apps to kiosk screens
Map a hosted app or game and phone controller to an owned compatible kiosk
ZHZN release verification
Exact signed APK identity, Android compatibility, version-code requirements and release evidence
VC EL screen repair and identification
Vending Concepts VC EL Series XT-202303207146 — isolate flicker, identify the controller and qualify integration
Silkron / Vendron integration status
SDK, licensing, platform and controller requirements before Operator can drive a Vendron machine
Nayax, MoMa and revenue reconciliation
Reader activation, merchant settlement, transaction attribution, integration gaps and daily reconciliation
Manufacturer portal / 制造商门户
Assigned serials, APK evidence, physical factory acceptance and batch shipping — English / 简体中文
How it all works
The whole system in pictures — apps, cloud, MQTT, URLs, end to end
Design system
The Kiosk-X brand as tokens — palette, gradients, type, motion — shared by the vending screen, operator view, and console
Quickstart
First request in under a minute
The Operator Console, visually
Picture-first tour of the console + Android app and how they connect to the vending app, QuestX, GameWorld, and ContentX Ads
Operator guide
What to use and when — organized by daily jobs
Hybrid fulfillment
Walk-up sales + cloud api_drop remote dispense
Payments & Nayax
Card readers, settlement routing, and how money reaches the right Nayax account
Activating a Nayax reader
Runbook for a migrated Reyeah cabinet whose VPOS has never taken a card — actor check, tap-first test, Default Credit, re-profile, wiring, VTM cleanup
Cards without MDB: Spark & Marshall
Driving the reader from our cloud or our app instead of the VMC's cashless bus — why our QR dispense path already fits, and what each option costs
APK rollouts (OTA)
CI-signed builds on S3, staged fleet rollouts, device upgrade loop, adoption tracking
Pricing
Every QR use case priced on one page — ad slots, worlds, quests, multiplayer, SaaS, programmatic yield
Screen ads & sponsorships
Sell the attract loop: direct-sold campaigns, ContentX creatives, programmatic DOOH fill
Ad mediation engine
Multi-network mediation: auction/waterfall/reservation modes, five price bases, PoP deadlines, creative approval, real-network adapters
Free-product program
QuestX-powered earn-a-free-product flow: QR, quests, one-time codes, $0 promo accounting
Age & identity verification
Per-machine Didit QR gate: verify → pay in one phone flow, card-reader gating, privacy posture, honest hardware limits
Machine client app
How the on-device kiosk app integrates: sync loop, vend events, faults
Vending manufacturers manual
Reyeah and ZHZN setup, controller-specific drivers, product-fall, cloud APIs and Nayax
Power bank — the visual manual
Seven diagrams: what is wired to what, manufacturer wiring, the one QR sticker per cabinet, how a rental takes payment and a bank comes out, rental states, what the customer pays, the factory attach questions
Power-bank rental (Qbee / ZHZN cabinets)
Pricing and the hold, deploying the gateway, what the TCP port exposes, operator API, revenue, the 2am table, rental states, protocol quirks
Charge bank end to end — wiring, factory attach, sign-off
Bench wiring for standalone and side-car builds, cloud wiring, the door QR, the factory three-question attach and its sign-off gate, the scene matrix
Cabinet handbook — factory sign-off to first sale
Visual guide to roles, distinct acceptance records, shipping, authorized first install, shopper use and fleet operations
Manufacturer acceptance manual (ZHZN)
Approved APK and credentials, physical tests, Android diagnostics, both factory signatures, accessories and shipping handover
制造商验收手册 (ZHZN · 中文)
经批准的安装包与凭据、实机测试、安卓诊断、两份工厂签核、配件及发运交接
First-time install (operator or employee)
Delivery, Android and Wi-Fi, authorized claim, reviewed address and separate on-site confirmation, payment, fill and physical acceptance before go-live
ZHZN newcomer course — crate to Operator
Nine modules including preparation: Android, Wi-Fi, cabinet hardware, manufacturer evidence, authorized first install, shopper and power-bank checks, daily operation and handover
ZHZN newcomer checklist
One line per step of the newcomer course, with the proof to send after each block
Training: factory sign-off → first install
Supervised walkthrough using isolated training fixtures, with clear separation from real cabinet and payment acceptance
First install at the factory (ZHZN)
Factory runbook: identity material, what a cabinet must never ship with, agent install, VMC/MDB pairing, the ten acceptance tests, build record, QA sign-off
Receiving a cabinet (ZHZN)
Field runbook: verify against the build record, first-boot bootstrap, on-site Wi-Fi via service code + SoftAP, planogram, test vend and card tap, operator acceptance, reinstalls and RMAs
Upgrading the agent remotely (ZHZN)
OTA runbook for whoever publishes a release: the fleet signing key, building and publishing a signed artifact, the migration ladder and minFrom floors, staging a rollout, reading coverage, and how to hold, pin or roll back
Per-cabinet device credentials (ZHZN)
Why the shared fleet secret is now only a bootstrap credential: how a cabinet enrols itself, what the fleet view says about a cabinet still on the shared secret, rotation, revocation, and the residual window a 409 comes from
Changing a machine's Wi-Fi
The offline service-code + SoftAP path for a cabinet that is already dark, the cloud-queued path for one that is not, and the revert-on-failure guarantee
The cabinet clock
The always-on clock over the ad loop: where venue-local time comes from, why a wrong clock shows nothing, contrast in the worst case, and the once-a-minute repaint
Machine care
Daily checks, assigned service credentials, Android updates, remote-support limits and recovery for the identified machine
Authentication
API keys, OAuth client credentials, Intelliverse Cognito
Roles (RBAC)
Operator, full admin, MFA super-admin, factory — who sees whose fleet, sign-off and shipping
Machines
List, inspect, and update machines
Geo platform
Self-hosted maps end to end — tiles + dark style, forward/reverse geocoding, OSM POI search, OSRM drive times. Zero Google keys
Inventory
Aisle stock, restocking, price updates
Orders
Order history, detail, revenue summary
Accounts
Create operator accounts (admin)
Game integrity
Multiplayer game v2: screen attestation, server-observed result validation, promo velocity cap
Errors & rate limits
Envelope, status codes, 429 behavior
Readiness report
Latest live endpoint verification + latency
Lifecycle feature matrix
The canonical machine lifecycle, per manufacturer and channel, with every cell backed by an executable eval and a live run ledger
Market opportunities 2026
Research snapshot: net-new opportunities in unattended machines — top 15 prioritized, operator needs, next-quarter shortlist
Operator Reads agent
Firecrawl-powered industry-insights curation: per-operator activation, fleet-derived relevance, n8n workflow wiring, ranked feed API
Location Scout agent
AI placement research from natural-language asks: subscription gating, NL grammar, the loop-engineered research engine with evidence, keyword verticals, n8n wiring
DFY Vending — Portfolio Autopilot
Done-For-You pipeline: pre-order → scout → agent-negotiated lease (graphed) → eSign → install team → auto-inventory. Human checkpoints always gate; the portfolio view is all you see
Machine lifecycle
The canonical machine state machine — every stage, flavor entry point, and legal transition, with the diagram generated from the code so it can never drift
Protection plan coverage
Machine Protection Plan states — offer flow, active ⇄ grace, suspension/lapse, claims — generated from the coverage code
Autopilot investments — where your money goes
Funded capital end to end: per-operator pools, the itemized 2% maintenance fee, manufacturer timelines with honest ETAs, refunds, and the real risk disclosures
Operator access groups
Cognito roles, fleet and territory assignments, MFA, workflows and verification