Last updated: March 2026 Category: Gamification
Overview
This guide walks you through creating a new gamification game in BeyondCart from start to finish. Whether you're setting up a Wheel of Fortune, Scratch Card, or Mystery Box, the process follows the same core steps.
Step-by-Step
Step 1: Open the Games Section
In your BeyondCart admin panel, navigate to Gamification > Games.
Click the Create Game button in the top-right corner.
[Screenshot: Games list page with Create Game button highlighted]
Step 2: Choose a Game Type
Select one of the three available game types:
Wheel of Fortune — Spinning wheel displayed as a WebView overlay.
Scratch Card — Scratch-to-reveal card displayed as a WebView.
Mystery Box — Tap-to-open boxes rendered as a native component.
Step 3: Configure Basic Details
Fill in the following fields:
Game Name — A descriptive name for internal reference (e.g., "Spring Sale Wheel").
Description — An optional description shown to customers when they open the game.
Status — Set to Draft while you're still configuring. Change to Active to publish.
Step 4: Set Up Prizes
Add one or more prize tiers. For each prize, configure:
Prize Type — Choose from Shopify coupon, free product, deep link, or no prize.
Prize Value — The specific coupon code, product, or link URL.
Display Label — What the customer sees (e.g., "25% Off Your Next Order").
Probability (%) — The chance of this prize being awarded. All probabilities must total 100%.
[Screenshot: Prize configuration form with multiple prize tiers]
Step 5: Configure Play Limits
Choose how often each customer can play:
Once per day — Customers can play once every 24 hours.
Once per game — Customers get a single play for the entire game duration.
Step 6: Set Access Options
Guest Access — Toggle on to let non-logged-in users play. Toggle off to require login.
Test Mode — Toggle on to allow unlimited plays for testing. Remember to turn this off before going live.
Step 7: Add Credits
Before customers can play, they need credits:
Go to Gamification > Credits.
Select individual customers or a customer segment.
Assign the number of credits to grant.
Step 8: Activate and Share
Set the game status to Active.
Share the game using deep links:
Wheel of Fortune:
beyondcart://wheelScratch Card:
beyondcart://scratch-cardMystery Box:
beyondcart://mystery-box
Promote via push notifications, in-app banners, or email campaigns.
[Screenshot: Game detail page showing Active status and deep link]
Tips
Always start in Draft status and use Test Mode to preview the full experience.
Double-check that your probabilities add up to exactly 100%.
Prepare your Shopify coupon codes before creating the game so they're ready to assign.
Use descriptive game names — you may run many games over time and need to tell them apart.
Grant credits in bulk to a customer segment for launch-day promotions.
FAQ
Can I edit a game after it's active? Yes. You can update prizes, limits, and access settings on an active game. Changes take effect immediately.
What if I forget to add credits? Customers will see the game but won't be able to play. They'll receive a message that they have no credits remaining.
Can I duplicate an existing game? Not currently. You'll need to create a new game and re-enter the configuration.
Related Articles