Skip to main content

Promo Games

Cashier Manager Admin

Promo games are promotional mini-games that play after a qualifying sale, giving customers a chance to win prizes like discounts, store credit, loyalty points, or free products. Games appear on the customer-facing display or the POS screen.

How Games Trigger​

After a sale is completed, the system automatically evaluates whether any active promo games should trigger:

  1. The sale total must meet the game's minimum spend threshold.
  2. If the game requires a customer, one must be attached to the sale.
  3. The game must be within its schedule (active days and hours).
  4. Daily win caps must not be exceeded.
  5. The system rolls against the game's win probability to determine the outcome.

If multiple games are active, the system evaluates them in order and stops at the first win.

No cashier action needed

Games trigger automatically after payment. Cashiers do not need to do anything to start a game. The animation plays on the customer display or POS screen without intervention.

Game Selection​

When multiple games are active, the customer display may show a game selection overlay where the customer can choose which game to play. Each game is presented as a card showing:

  • Game name and type icon
  • Available prize tiers
  • Jackpot pool amount (for jackpot games)

If only one game is active, it plays automatically without a selection screen.

Game Types​

Spin the Wheel​

A colorful prize wheel with sections for each reward. The wheel spins and gradually slows to land on a section. The animation duration is configured by the admin.

Scratch Card​

A scratch-off card that reveals the prize underneath. When interactive mode is enabled, the customer scratches the card on the touchscreen. Otherwise, the card auto-reveals after a short delay.

Slot Machine​

Three spinning reels that slow to reveal matching symbols. The reels align to show the winning reward.

Plinko​

A ball drops through a board of pegs and bounces into a prize slot at the bottom. When interactive mode is enabled, the customer taps to drop the ball. Otherwise, it drops automatically.

Winning​

When a customer wins:

  1. The game animation highlights the winning reward with a celebration effect.
  2. The prize details are displayed (reward name, value, and code).
  3. A reward code is generated (e.g., WIN-A3B5C or JP-X7Y2Z for jackpots).
  4. The POS receives a notification showing the win details.

Immediate Rewards​

Some reward types are applied automatically at the time of the win:

Reward TypeApplication
Store CreditCredited to the customer's balance immediately
Loyalty PointsAdded to the customer's loyalty balance immediately
DiscountA reward code is generated for use on a future purchase
Free ProductA reward code is generated for use on a future purchase

Redeeming a Win​

Discount and free product wins generate a reward code that the customer presents on a future visit. The cashier applies the code at checkout to redeem the prize.

Consolation​

When a customer does not win, the display can show a consolation message (e.g., "Better luck next time! Come back tomorrow for another chance."). This is configurable per game by the admin.

Near-Miss​

Sometimes the animation shows a "near miss" -- the wheel stops just one section away from a rare prize, or the scratch card almost reveals a big win. This is an intentional feature designed to build excitement. The near-miss rate is configured by the admin.

Bonus Rounds​

Some rewards trigger a bonus round -- winning one game unlocks a play on a second game. When this happens:

  1. The first game's win is displayed.
  2. A "Bonus Round" animation transitions to the second game.
  3. The bonus game plays with guaranteed participation (no probability gate).
  4. The bonus win (if any) generates an additional reward code.

Jackpot Display​

For games with a progressive jackpot, the customer display shows the live jackpot pool amount. The pool grows with each qualifying sale and resets when someone wins the jackpot. Jackpot wins display a special celebration animation with the pool amount won.

Purchased Spins​

If the admin has enabled buy-a-spin, a game product appears in the POS product catalog (in the "Games" category). When a customer purchases spins:

  1. Add the spin product to the cart (quantity = number of spins).
  2. Complete the sale normally.
  3. Each purchased spin plays as a guaranteed game (bypasses win probability).
  4. Results display sequentially on the customer display.

What the Cashier Sees​

When a game triggers after a sale, the POS shows a notification with:

  • "Promo Win" banner if the customer won
  • The reward name and value
  • The reward code for reference

This allows the cashier to inform the customer about their prize if they are not watching the customer display.

Troubleshooting​

ProblemSolution
Game does not trigger after a saleCheck that the game is active, the sale meets the minimum spend, and the game is within its schedule. Verify that promo games are enabled in feature flags.
Customer did not see the gameThe game plays on the customer display. If no display is connected, the game result only appears as a POS notification.
Reward code was not generatedCheck the win history in the admin panel. The code may have been generated but not displayed due to a display issue.
Customer wants to redeem a codeDiscount and free product codes are redeemed on future purchases. Store credit and loyalty points are applied immediately at the time of the win.

What's Next?​