Skip to main content

Admin: Kiosk Machines

Kiosk Machines is a section of the Admin Portal. It answers four questions about every physical kiosk:

  • Which machine is it, and is it online?
  • Who runs it, and which Shop does it belong to?
  • How much money did players move on it?
  • How much commission was paid for it?

This page shows each job step by step. The names in bold are the names on the screen.

note

The pictures use demo data. Names, codes, and amounts are examples.

Kiosk machines: the menu on the left, the totals on top, and one row for each kiosk


The menu​

PageWhat it is for
Kiosk machinesEvery kiosk, its status, its operator, and its money for the period you pick
Devices & setup codesMachines that are not registered yet, and the one-time codes used to register them
OperatorsThe Shops, people, and companies that run kiosks
SettlementsCommission statements for an operator and a period
Emergency codeThe 6-digit code a technician types on a kiosk

Who can open it​

Each page needs a permission. A System Admin sets permissions in Role & Permission Management.

PermissionWhat it opensWho has it by default
Kiosk Machine ManagementKiosk machines, Devices & setup codes, OperatorsFinance Admin, Operation Admin
Kiosk settlementsSettlementsFinance Admin, Operation Admin
Kiosk emergency codeEmergency codeOperation Admin

System Admin and Super Admin can open everything.


Words used on these pages​

WordMeaning
Kiosk IDThe permanent number of a kiosk, like KSK-000003. It never changes
Kiosk CodeThe short code staff give a kiosk, like SA-LOBBY-01. It can change. An old code stays reserved for the same kiosk
NameA readable name, like "Sunset Arcade – lobby"
DeviceThe physical machine. Each machine with the kiosk app has its own device ID
OperatorWho runs the kiosk and receives commission: a Shop, a person, or a company
Linked shopThe Shop an operator stands for. This is what ties a kiosk to a Shop
Reference rateA percentage shown as a suggestion in settlements. It never calculates a payout
Setup codeA one-time code that registers a machine as a kiosk. It works once, for 30 minutes
Emergency codeA 6-digit code that changes every 10 minutes. It opens the staff screens on a kiosk
Money in / Money outCompleted deposits and completed withdrawals made on the kiosk
Net profitMoney in minus money out

Register a new kiosk​

A machine with the kiosk app shows up in Admin by itself the first time it goes online. It is not a kiosk yet. Registering it takes one code from Admin and a few fields on the kiosk.

Step 1: Find the machine​

Open Kiosk Machines → Devices & setup codes. The Unregistered tab lists machines that run the kiosk app but are not registered.

The Kiosk setup screen on the machine shows its device ID. Match the last characters with the list.

Devices & setup codes. One machine is waiting on the Unregistered tab

Step 2: Create a setup code​

Select Create setup code. Leave For kiosk empty to register a new kiosk. A note helps the next person know what the code was for. Select Create code.

The code is shown one time. Copy it or write it down before you select Done. It works once, and it expires after 30 minutes.

Setup code created. The code is shown only once

The Setup codes tab keeps the last characters of each code, who it was for, and whether it was used. A code that is no longer needed can be revoked there.

The Setup codes tab lists each code and its status

Step 3: Enter the codes on the kiosk​

A staff member or technician does this at the machine. The kiosk must be online.

  1. Open the Kiosk setup screen on the kiosk. The Emergency code page in Admin describes how to open it.
  2. The screen says Staff only. Type the 6-digit emergency code and select Unlock. See Emergency code.
  3. Under Register this kiosk, type the Setup code from Step 2.
  4. Type a Code (2–32 letters, digits, - or _, like SA-LOBBY-01) and a Name (like "Sunset Arcade – lobby"). Note is optional.
  5. Select Register this kiosk. The screen confirms with the new Kiosk ID.

The kiosk now appears on Kiosk machines. Its operator is No operator until you link it.

If the kiosk saysWhat to do
The setup code is not valid or was already usedCreate a new setup code
The setup code has expiredCreate a new setup code. A code lasts 30 minutes
This Code belongs to another kioskChoose another Kiosk Code. Old codes stay reserved
Wrong code, on the Staff only screenAsk for the current emergency code. It changes every 10 minutes
Too many wrong codesWait for the time shown, then try again

A kiosk is linked to a Shop through its operator:

Kiosk → Operator → Linked shop

So linking takes two steps. Create an operator for the Shop, one time. Then give each of the Shop's kiosks to that operator.

Step 1: Create an operator for the Shop​

Open Kiosk Machines → Operators and select New operator.

  1. Set Type to Shop.
  2. In Linked shop, search the Shop by name or username and pick it. The Name fills in from the Shop. You can change it.
  3. Add the contact and the payout method if you have them.
  4. Select Create operator.

A Shop can be linked to only one operator. A Shop that already has one shows Linked to another operator and cannot be picked.

New operator. Type is Shop, and Linked shop is the Shop the kiosks belong to

The Operators list shows each operator, its linked Shop, and how many kiosks it runs.

The Operators list. Linked shop shows the Shop behind each operator

Step 2: Give the kiosk to the operator​

Open the kiosk from Kiosk machines, then open the Settings tab. Under Operator and reference rate, select Change operator.

  1. Pick the operator in New operator.
  2. Choose Effective from. Now starts today. An earlier date and time is for a kiosk that was already running for this operator before you recorded it.
  3. Type a Reason. It is saved in the kiosk history and the audit log.
  4. Select Change operator.

Change operator. Pick the operator, when it starts, and a reason

Reference rate is next to it. Set it if you want settlements to show a suggested amount. It is a reference only. It never calculates a payout.

After saving, Settings shows the operator, the rate, and the history of both.

The Settings tab after linking: the operator, the reference rate, and their history

To check a Shop's kiosks, open the operator from Operators. The Kiosks tab lists every kiosk it runs, from when, and why.

An operator's page. Its header shows the linked Shop. The Kiosks tab lists the kiosks

What changes on the kiosk​

Once a kiosk's operator has a linked Shop, the kiosk is for that Shop's players.

Who signs in on the kioskWhat happens
A player of that ShopSigns in as usual
A player of another ShopSign-in is refused. The message names the kiosk's Shop
A player with no Shop yetSigns in, and joins that Shop
A new player who registers on the kioskJoins that Shop

The rule covers every way to sign in: username, phone, and email. It applies on kiosks only. Signing in on the website from a phone or a computer is not affected.

A player of another Shop is refused. The message names the Shop the kiosk belongs to

A kiosk with No operator, or with an operator that has no linked Shop, accepts every player.

Move a kiosk to another Shop​

Use Change operator again and pick the other Shop's operator. From the effective time:

  • Players of the new Shop can sign in on the kiosk. Players of the old Shop cannot.
  • Money is counted for the new operator. Money before that time stays with the old one. See Periods.

To remove the link, pick No operator.


See the money​

All kiosks​

Kiosk machines starts with the period: Today, 7d, 30d, or Custom. Every amount on the page is for that period.

CardWhat it counts
KiosksRegistered kiosks: active, suspended, retired
OnlineKiosks seen in the last 3 minutes
OfflineKiosks that stopped reporting
Never seenRegistered, but no signal from the machine yet
Unregistered devicesMachines waiting in Devices & setup codes
Duplicate?The same device ID seen from two networks in the last 24 hours. Worth a look
Kiosk money in / out / net profitTotals of all kiosks
Unknown machine money inKiosk deposits that are not linked to a registered kiosk

The list can be searched by code, name, Kiosk ID, old code, or device ID. It can be filtered by Status, Connection, and Operator, and sorted by a column. Paid through is the last date covered by a paid settlement. Export saves the list as a spreadsheet.

One kiosk​

Select a kiosk to open its page. The top shows the operator, the reference rate, the device, the last activity, and past codes. Under it are the totals and a daily chart for the period.

A kiosk's page: who runs it, the totals for the period, and the daily chart

When the code, the name, or the operator changed during the period, a yellow note says so. The totals still cover the whole period. See periods opens the split.

The tabs under the chart:

TabWhat it shows
TransactionsEach deposit and withdrawal made on the kiosk, with the code the kiosk had at that time
HistoryRegistration, renames, code and status changes, device changes, and admin actions, with who and when
PeriodsThe money split at every change of code, name, or operator
DevicesThe machine bound to the kiosk now, and the machines it had before
SettlementsThe settlements that include this kiosk
SettingsCode, name, note, operator, reference rate, status, and a setup code for this kiosk

The Transactions tab. Code at the time shows the kiosk's code when the money moved

Periods: money before and after a change​

A kiosk can get a new code, a new name, or a new operator. Periods keeps the money of each stretch apart, so it is clear what the kiosk earned under each identity.

Each row is one stretch. What changed says what started it, and who did it. The row marked Current is how the kiosk runs now. All time covers the kiosk's whole life. Selected period follows the period at the top of the page.

The Periods tab. One row for each stretch between changes, with its own money in, money out, and net profit

In this example the kiosk was renamed, then given a new code, then moved from Lucky Spot LLC to John Middleman. The money of each stretch has its own row. The Kiosk ID is the same in all of them.

History​

History is the record of what happened to the kiosk. Show before / after opens the old and new values of a change.

The History tab lists each change with who made it and when


Change a kiosk​

To do thisGo here
Change the Kiosk Code, name, or noteKiosk → Settings → Identity → Save changes
Change the operator or the reference rateKiosk → Settings → Operator and reference rate
Move a kiosk to a different machineKiosk → Settings → Setup code for this kiosk → Create setup code. Enter that code on the new machine. The kiosk keeps its ID, its history, and its money
Take a machine off a kioskKiosk → Devices → Unbind device
Pause a kioskKiosk → Settings → Suspend. The device stays, but new transactions are not linked to the kiosk until it is active again
Close a kiosk for goodKiosk → Settings → Retire. This is final. It unbinds the device
Stop a machine from registeringDevices & setup codes → Block. Unblock allows it again

Staff at the kiosk can also change the name and the note on the Kiosk setup screen. The name can change up to 5 times a day. Changing the code at the kiosk needs a setup code for that kiosk.

Every change asks for a reason where it matters, and is kept in History and in the audit log.


Record commission: settlements​

A settlement is a statement for one operator and one period. The system shows the numbers. Staff type the amount, pay the operator by hand, and record that payment.

note

A settlement never moves money. It is a record of a payment made outside the system.

Step 1: Preview and create a draft​

Open Kiosk Machines → Settlements and select New settlement.

  1. Pick the Operator.
  2. Pick the Period: Last month, This month to date, Last 7 days, or Custom.
  3. Select Preview. Nothing is saved yet.
  4. Select Create draft.

The preview has one line for each kiosk the operator ran in the period. A kiosk counts only for the time this operator had it. A line marked Code or name changed can be opened to see the split.

A settlement preview: one line for each kiosk, for the time the operator had it

Time that is already in another settlement cannot be settled a second time. The page says so when you create the draft.

Step 2: Type the amounts​

On the draft, type an Amount for every kiosk. 0 is allowed. Reference is net profit × reference rate. It is a suggestion. Calculation note is a place to say how the amount was worked out.

Select Save. Refresh numbers takes the numbers again and keeps what you typed.

A draft settlement. Staff type the amount and a note for each kiosk

Step 3: Approve​

Select Approve, then Approve settlement. The numbers and the amounts are now locked. An approved settlement can still be cancelled until it is marked as paid.

Step 4: Pay, then mark as paid​

Pay the operator the usual way. Then select Mark as paid and fill in Paid on, Method, and Reference (a bank transfer ID, a transaction hash, or a receipt number).

Mark as paid records a payment that was made by hand

The settlement shows who created it, who approved it, and the payment. Export lines CSV and Export transactions CSV save the figures and the transactions behind them. Drift compares the numbers taken with the same period computed now. It is highlighted when transactions changed after the numbers were taken.

A paid settlement, with the payment and the amount for each kiosk

The Settlements list groups them by status: Draft, Approved, Paid, Cancelled.

The Settlements list, with a tab for each status

On an operator's page, Unpaid is the total of approved settlements that are not paid yet. Paid is the total paid.


Emergency code​

Kiosk Machines → Emergency code shows a 6-digit code that a technician types on a kiosk. It is used in two places:

  • On the staff PIN pad of the kiosk, in place of the staff PIN.
  • On the Staff only screen that protects Kiosk setup.

The code stays hidden until you select Show code. The page then shows the current code, the time left, and the next code. The steps for the technician are on the same page.

The Emergency code page after Show code: the current code and the time until it changes

RuleDetail
It changesEvery 10 minutes. Close to a change, the next code works too
It is the same for all kiosksThe code opens the staff screens of every Vault Play kiosk
It is recordedEach time a code is shown is written to the audit log, with who and when. The code itself is not stored there
Wrong triesFive wrong tries lock the screen on that kiosk for 5 minutes
warning

Read the code out only to a technician you know is at a kiosk. Do not send it in a group chat.


Quick answers​

A new machine does not appear under Unregistered. The kiosk app must be running and online. Select Refresh. Check All devices in case the machine is blocked or already bound to a kiosk.

A player says the kiosk does not let them sign in. Read the message. If it names a Shop, the kiosk belongs to that Shop and the player belongs to another one. Check the kiosk's operator and its linked Shop.

A kiosk shows Offline. The machine has not reported for more than 3 minutes. Check power and network at the location.

The totals look different after a rename. They are not lost. The Kiosk ID is the same. Open Periods to see the money before and after the change.

The operator changed in the middle of the month. Create one settlement for each operator. Each one counts only the time that operator had the kiosk.

A settlement was approved with a wrong amount. Select Cancel settlement before it is marked as paid, then create a new one for the same period.