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., WINA3B5C for standard wins, JPX7Y2Z for jackpots, BNSABC12 for bonus rounds, BUYXYZ34 for purchased spins — a 3-letter prefix followed by 5 alphanumeric characters).
  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.

Manual Rewards (the Reward Button)​

Separate from the automatic games above, manual rewards let you hand a customer a free product as a comp or prize -- for example, after they spin a physical wheel or plinko board at your counter, or as a "manager's choice" giveaway. You issue these yourself from the Reward button.

The Reward Button​

The Reward button appears in the tender bar (the action button row, alongside Discount, Hold, and Manual Item). It is available even when the cart is empty, so you can issue a reward as the first thing on a sale.

When the Reward button is shown

The Reward button only appears when Promo Games is enabled and at least one active manual reward has been configured by an admin. If no active manual reward exists, the button stays hidden. Manual rewards are set up under Admin > Promo Games > Manual Rewards.

Issuing a Reward​

  1. Tap the Reward button.
  2. The Issue a Reward modal opens. Pick the reward the customer won.
  3. Pick the specific product to give them. Use the search box to filter by name or SKU.
    • If the reward's pool has exactly one in-stock product, this step is skipped and that product is added automatically.
    • Out-of-stock products are hidden from the picker, so you can only issue something you actually have.
  4. The product is added to the cart as a fully comped ($0) line at the size the admin configured (e.g., 7g of flower, or 5 prerolls), and a confirmation toast appears.
  5. Continue ringing in any other items and complete the sale normally.

The comped reward line carries no charge -- the system applies a 100% discount so the line totals $0 regardless of the product's normal price (including tier-priced flower). Every issued reward is logged for managers under Admin > Promo Games > Reward Activity.

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.
No Reward button appearsThe Reward button only shows when Promo Games is enabled and at least one active manual reward exists. Ask an admin to create or activate one under Admin > Promo Games > Manual Rewards.
A product is missing from the reward pickerOut-of-stock products are hidden. Confirm the product has stock and is in the reward's pool.

What's Next?​