Extend or Move a Session in IZI
Extend or Move a Session in IZI
Section titled “Extend or Move a Session in IZI”In IZI CRM an admin manages a session — a block of play time on a specific device — in one or two taps directly from the Hall screen. There are two key scenarios: extend adds time to the current session without stopping it, and move transfers the player to a different PC while preserving the remaining time. Both actions require the SESSION_EDIT permission and only work on active sessions (status ACTIVE or STARTED). Extending appends a new tariff block immediately after the existing coverage (extendSession mutation); moving switches the device within the same session (switchSessionDevice mutation) — the player’s data and remaining time are fully preserved.
Why it matters for owners: fewer lost minutes from “forgotten” sessions, fewer disputes when a PC breaks down, and a higher average ticket from timely top-up offers.
Extend an Active Session
Section titled “Extend an Active Session”When to use this
Section titled “When to use this”- A player wants to keep playing but their purchased time is almost up.
- The PC card in the Hall shows a yellow or red coverage indicator (coverageStatus: NEEDS_ATTENTION).
- A player has topped up their balance in the mobile app and you want to add time immediately.
1. Open the PC card in the Hall. Go to the Hall section and find the card for the PC running an active session. Click the card to open the session side panel.
2. Click “Extend”.
In the side panel click the Extend button (i18n key sessions.entity.actions.extend.title). If less than one full minute remains before the next booking on this PC, the button is disabled — the system shows a tooltip explaining the restriction.
3. Select a tariff for the extension.
A catalog of the player’s purchased tariffs opens. Choose the playerTariff you want — it can be the same as the original or a different one. If the tariff has a schedule, the system shows available time windows. If the free window before the next booking is shorter than one tariff unit, IZI automatically caps the duration and notifies you.
4. Set the duration if needed.
For tariffs that allow a custom length, enter durationSeconds or leave it at maxAllowed — the system then picks the maximum available time, taking the schedule and other players’ bookings into account.
5. Choose a payment method and confirm. Click Place Order and Proceed to Payment. The charge is applied from the player’s balance or accepted as cash/card. The timer on the PC card updates immediately — the player keeps playing without any pause.
What happens under the hood
Section titled “What happens under the hood”IZI adds a SessionPlayerTariff record — a new coverage segment — directly after the previous one (or after the current moment if the previous segment has already ended). For FINITE sessions the system automatically pushes plannedEndAt forward. After confirmation an MQTT command is sent to the PC, the DeviceHold of type PROTECTED_OPS is released, and the real-time subscription refreshes the Hall card on all open browser tabs simultaneously.
Extension limits
Section titled “Extension limits”| Situation | What happens |
|---|---|
| Less than 1 minute until next booking | Extend button is disabled |
| Tariff is not valid for the current PC zone | Tariff does not appear in the catalog |
| Tariff schedule is closed at this time | Tariff is marked unavailable |
| Player has no purchased tariffs | Catalog is empty — place an order first |
Move a Player to Another PC
Section titled “Move a Player to Another PC”When to use this
Section titled “When to use this”- A PC has frozen or broken down and you need to relocate the player quickly.
- A player wants to take a newly freed seat in the VIP zone.
- You are reorganising the hall to optimise occupancy.
1. Open the PC card with the active session. In the Hall, find the PC you want to move the player away from and click the card.
2. Click “Move to Another PC”.
In the side panel click Move to Another PC (i18n key sessions.entity.actions.switch.title). A device-selection dialog opens.
3. Choose the target PC. In the New PC field select a free device from the list. IZI shows only available PCs: devices occupied by another session or currently offline are inactive. If the tariff is locked to a specific zone, PCs in other zones are also unavailable — IZI checks zone compatibility automatically.
4. Click “Move”.
Confirm with the Move button (i18n key sessions.entity.actions.switch.submit). The source PC is freed (its card turns green), and the same session starts on the target PC with the same remaining time. Tell the player to change seats — their new spot is already unlocked.
What happens under the hood
Section titled “What happens under the hood”IZI closes the SessionDevice record on the source PC (actualEndAt = now) and creates a new one on the target PC. For an already-started session (STARTED) the reference point is the current moment; for a reserved session not yet started, it is plannedStartAt if that is in the future. After the transaction IZI sends MQTT commands to both devices and publishes a session update via the sessionUpdates real-time subscription — all admins in the club see the change instantly.
Move limits
Section titled “Move limits”| Situation | What happens |
|---|---|
| Target PC is occupied | Does not appear in the selection list |
| Target PC is offline | Does not appear in the selection list |
| Tariff does not support the target zone | Error DEVICE_ZONE_MISMATCH |
| Device is a POD (enclosed booth) | Move is blocked: player is physically inside (DEVICE_NOT_SWITCHABLE) |
Auto-extend: when no admin action is needed
Section titled “Auto-extend: when no admin action is needed”IZI supports auto-extend — a mechanism where the next tariff is added to the session before it ends, without any admin involvement. The toggle is in the active session side panel: Automatic Extension. When enabled, the system adds the tariff a few minutes before coverage runs out. For open-ended (postpaid) sessions auto-extend is always on.
Auto-extend works best for regular players who have a linked payment method or sufficient balance. If the balance is insufficient at the moment of renewal, the session ends automatically.
Permissions
Section titled “Permissions”Both actions — extending and moving — require the SESSION_EDIT permission at the club level. A one-time guest account without a phone number is managed exactly like a regular player: their session can be extended and moved using the same steps. For a full overview of permissions, see Real-time Hall Management.
What to do next
Section titled “What to do next”- Start a paid session — if you need to begin a new session
- End a session — if the player is leaving
- Session issues — if a session is stuck or the PC is not responding
- Real-time Hall Management — overview of the Hall screen and all available actions
Frequently asked questions
Does the session pause when you extend it?
No. The PC keeps running without interruption — only the timer updates and the charge is applied.
Can I extend a session with a different tariff?
Yes. When extending, you select any purchased tariff (playerTariff) — it does not have to match the original. The extension is appended directly after the current coverage with no gap.
What happens if there is less than 1 minute before the next booking on that PC?
IZI disables the Extend button and shows a tooltip. Time is counted in whole minutes, so a partial minute does not qualify for extension.
Does the timer stop when moving a player to another PC?
Only for a fraction of a second during the operation itself. After confirmation the session continues on the new PC with the same remaining time.
Can I move a player to a different zone — for example from Standard to VIP?
Only if the tariff supports the target zone. IZI checks zone compatibility automatically: PCs from incompatible zones are greyed out in the selection list.
What if the target PC is busy or offline?
Choose another one. IZI highlights only available devices; occupied or offline PCs are inactive in the selection list.