Last updated: March 2026 Category: Gamification
Overview
The Mystery Box is a native game component built directly into the BeyondCart mobile app. Customers are presented with a set of mystery boxes and tap one to open it, revealing their prize. Because it runs natively, it feels fast and seamless — no loading or WebView required.
How It Works
A customer navigates to the Mystery Box screen or taps a deep link.
A set of closed mystery boxes appears on screen.
The customer taps a box to select and open it.
An opening animation plays and the prize is revealed.
The prize is automatically applied or shared.
One credit is deducted from the customer's balance.
[Screenshot: Mystery Box selection screen in the mobile app]
Setting Up a Mystery Box
Go to Gamification > Games in your admin panel.
Click Create Game and select Mystery Box.
Enter the game name, description, and choose a status.
Configure the prizes that can appear inside the boxes:
Prize type — Shopify coupon, product, deep link, or no prize.
Label — The reveal message (e.g., "You found a free gift!").
Probability — The likelihood this prize is selected.
Set the number of boxes displayed to the customer (typically 3 to 6).
Configure the play limit — once per day or once per game.
Optionally allow guest access.
Use test mode to verify, then set the game to Active.
[Screenshot: Mystery Box setup form in admin panel]
Deep Linking
Send customers straight to the Mystery Box game:
Deep link:
beyondcart://mystery-box
Great for push notifications, in-app messages, or promotional emails.
Key Concepts
Native Component — Unlike the Wheel of Fortune and Scratch Card, the Mystery Box runs as a native UI component. This means faster load times and smoother animations.
Box Count — You choose how many boxes appear on screen. The prize is pre-determined server-side, so the choice is cosmetic — but it adds to the fun.
Random Assignment — The prize is randomly selected based on your probability configuration when the game session starts, not when the customer taps a box.
Tips
Use 3 boxes for simplicity or 6 for a more dramatic selection experience.
Mystery Boxes work well as daily rewards — set the limit to once per day and give customers a reason to open the app daily.
Pair with a loyalty program: grant credits as a reward for reaching spending milestones.
Name your prizes creatively to build anticipation (e.g., "Golden Surprise" instead of "10% coupon").
FAQ
Does the customer's box choice affect the prize? No. The prize is determined server-side when the game loads. The box selection is purely visual.
Can I change the box design? The box design uses the app's default style. Custom visual themes may be available in future updates.
Is the Mystery Box faster than other game types? Yes. Because it's a native component, it loads instantly without the overhead of a WebView.
Related Articles