Production Update 1.2.0
Summary
Welcome Bonus is here. New players can claim free credits, play toward a win goal, then unlock the bonus after their first cash-out is approved. Shops can send paid Email/SMS campaigns to their players. Admins also get realized Player finance (Wallet P&L and Games P&L) on player detail.
Added
- Welcome Bonus for new players. Claim free credits, play toward a win goal, then unlock the bonus after the first cash-out is approved by your shop or by Admin.Module: Welcome Bonus · Portal: Admin, Shop, Player
- Admins can turn Welcome Bonus on or off and choose the free credit amount, the win goal, how long an unused bonus can stay active, and how many players may claim each day.Module: Platform Configuration · Portal: Admin
- Shops can turn Welcome Bonus on for their players in Settings. Claims use the shop’s credits. When a shop player reaches In Review, the shop reviews their cash-out requests.Module: Shop Settings · Portal: Shop
- Players see a Welcome Bonus badge in the app and can claim with Get Welcome Bonus. Progress shows as Active, In Review, or Unlocked. If today’s claim limit is full, the app asks them to wait until tomorrow.Module: Welcome Bonus · Portal: Player
- Shops can send paid Email or SMS campaigns to their own players from Messages — for promos, reactivation, and similar outreach. Fees come from the shop USD wallet. Only successful deliveries are billed.Module: Shop-to-Player Messaging · Portal: Shop, Player
- Admins set Email/SMS unit prices, channel on/off, campaign limits, and banned words under Messaging pricing. Messaging can also be turned off per shop.Module: Shop-to-Player Messaging · Portal: Admin
- Admin player detail shows a Player finance (realized) block: total deposit, credit (bonus from any source), cash out, master↔game transfers, Wallet P&L, and Games P&L. Wallet balance = Wallet P&L + Games P&L + credit.Module: Admin Player Detail · Portal: Admin
Changed
- While a player’s bonus is In Review, every cash-out needs approval — even small amounts. After the bonus is unlocked, normal cash-out rules apply again.Module: Withdrawals · Portal: Admin, Shop, Player
- While the bonus is Active, players keep at least the free grant amount in their wallet when cashing out. That hold is lifted after In Review, Unlocked, or Expired.Module: Player Wallet · Portal: Player
Required Actions
- Admins — open Platform configuration → Welcome Bonus, turn it on, set the amounts and limits, then Save.Module: Welcome Bonus · Portal: Admin
- Shops — open Settings, enable welcome bonus for your players, Save, and keep enough credits for claims.Module: Welcome Bonus · Portal: Shop
- Admins — open Platform configuration → Messaging pricing, set prices and limits. Leave SMS off until the SMS provider is ready. Disable messaging per shop if needed.Module: Shop-to-Player Messaging · Portal: Admin
- Shops — keep enough USD wallet balance for messaging fees. Verify player email/phone before sending. Use Messages → compose → review quote → Send & pay.Module: Shop-to-Player Messaging · Portal: Shop
Affected Modules
- Welcome Bonus
- Platform Configuration
- Shop Settings
- Player Wallet
- Withdrawals
- Shop-to-Player Messaging
- Admin Player Detail
Affected Portals
- Admin Portal
- Shop Portal
- Player Portal
What is Welcome Bonus?
Welcome Bonus is a free credit gift for new players.
The idea is simple:
- Player claims free credits.
- Player plays until they hit a win goal.
- Hitting the goal puts the bonus In Review — not fully unlocked yet.
- Player requests a real cash-out.
- Shop or Admin approves that cash-out.
- After the first approval, the bonus is Unlocked.
In short: claim → play → In Review → first cash-out approved → unlocked.
How the journey works
New player signs up
↓
Sees “GET BONUS” (credits not added yet)
↓
Taps “Get Welcome Bonus”
↓
Wallet increases → “BONUS ACTIVE”
↓
Plays until the win goal is reached
↓
“IN REVIEW”
↓
Shop or Admin approves the first cash-out
↓
“BONUS UNLOCKED”
| Badge | Meaning |
|---|---|
| GET BONUS | Ready to claim |
| BONUS ACTIVE | Claimed — playing toward the win goal |
| IN REVIEW | Win goal reached — waiting for first cash-out approval |
| BONUS UNLOCKED | First cash-out approved — bonus finished |
| BONUS EXPIRED | Timed out while still Active |
Business rules (how it behaves)
Claiming
- A player can claim Welcome Bonus once.
- Credits are added only when they tap Get Welcome Bonus — not automatically at signup.
- Shop players need their shop to have Welcome Bonus turned on, and the shop needs enough credits.
- Platform players are funded by the platform.
- Admin can set a daily claim limit (how many players may claim per day). When the limit is full, new claims wait until tomorrow.
While the bonus is Active
- The player must leave at least the free grant amount in their wallet when cashing out.
Example: grant is $5 and wallet is $20 → they can take out up to $15, not the full $20. - Exception: if they have already lost at least the grant amount in play since claiming, that hold is temporarily lifted. If they recover above that loss level, the hold comes back.
- Win progress is measured from play after the claim (highest win reached), not from the player’s all-time history.
- Only that highest win (peak) counts toward the goal. Later losses do not cancel progress once the peak is high enough.
Reaching the win goal → In Review
- When peak win reaches the Admin threshold, status becomes In Review.
- Reaching the goal does not unlock the bonus by itself.
- In Review:
- The wallet hold from the free grant is removed — they can cash out more freely.
- Every cash-out still needs a person to approve it (even small amounts that normally auto-approve).
- Rejecting a cash-out keeps the bonus In Review.
- In Review does not expire from being idle.
Unlocking (Completed)
- The bonus unlocks only when someone approves the first real cash-out (bank, crypto, or similar).
- Moving money only between the main wallet and game does not unlock the bonus.
- Who approves:
- Shop players → Shop
- Platform players → Admin
- After unlock, later cash-outs follow the normal platform rules again (including auto-approve where it usually applies).
- If there are several pending cash-outs, the first approval unlocks the bonus; the others stay pending until handled.
Expiring
- Only an Active bonus can expire.
- If the player stays idle long enough (Admin’s inactivity window) and the free credits are still in the wallet, the bonus Expires and those credits are taken back.
- In Review never expires this way — it waits for the first cash-out approval.
For Admins (Welcome Bonus)
- Go to Platform configuration → Welcome Bonus.
- Turn Enable Welcome Bonus on.
- Set:
- Grant Amount — free credits when a player claims
- Net Win Threshold — win goal to reach In Review
- Inactivity window (days) — how long an Active bonus can sit unused before it expires
- Daily claim limit (players) — how many players can claim each day
- Save.
- Use the Grants tab to browse bonus records.
- Approve cash-outs for platform players in Withdrawal requests. Shop players are handled in the Shop portal.
For Shops (Welcome Bonus)
- Go to Settings.
- Enable welcome bonus for my players → Save.
- Keep enough credits so players can claim.
- Check player bonus status on Players.
- When a player is In Review and requests a cash-out, open Withdrawals and Approve or Reject.
The first approval unlocks their bonus.
For Players (Welcome Bonus)
- Sign up (Welcome Bonus must be on; shop players also need their shop to have it enabled).
- Tap the Welcome Bonus badge → Get Welcome Bonus.
- Play until the badge shows IN REVIEW.
- Request a cash-out as usual — it will wait for approval.
- After approval, the badge shows BONUS UNLOCKED.
If today’s claim limit is full, claim is unavailable and the app shows:
“Today's welcome bonus limit has been reached. Please wait until tomorrow to claim.”
Shop-to-player messaging
Shops can send paid Email or SMS campaigns to their own players from Messages in the Shop portal.
This is separate from free in-app popups and broadcasts (those only show when the player is logged in). Email/SMS reach players outside the app.
How billing works
- Fees come from the shop USD (online) wallet.
- Platform receives the fee as messaging income.
- Only successful deliveries are billed. Failed sends are not charged.
- Before send, the shop sees a cost quote (recipients × unit price; SMS also counts segments).
- The full quote is held at send time, then settled to the final cost.
- Shop USD history shows the fee as Messaging fee.
Who can be messaged
Only eligible players:
- Belong to that shop and are active
- Have a verified email (for Email) or verified phone (for SMS)
- Have not opted out of that marketing channel
For Admins (Messaging)
- Go to Platform configuration → Messaging pricing.
- Set:
- Email unit price (USD) — default $0.05
- SMS unit price per segment (USD) — default $0.08
- Email channel on/off (default on)
- SMS channel on/off (default off — keep off until the SMS provider is ready)
- Max recipients / campaign
- Max campaigns / shop / day
- Min interval between campaigns
- Banned words (comma-separated)
- Save.
- Per shop: open the shop → Player messaging → enable or disable.
For Shops (Messaging)
- Open Messages → compose.
- Choose Email or SMS (SMS only if the platform left it on).
- Write the content (email needs a subject; body max 2000 characters).
- Select eligible players (or Select all).
- Review the cost quote and USD balance → Send & pay.
- Check campaign detail for the delivery report, and Message history for past campaigns.
If messaging is disabled for the shop, send is blocked — contact platform support.
For Players (Messaging)
- Players may receive email and/or SMS from their shop.
- Emails include an unsubscribe link; SMS includes Reply STOP.
- After opt-out, they no longer appear in that shop’s recipient list for that channel.
Player finance (realized) — Admin
On Admin → Player detail → Wallet, there is a new Player finance (realized) block.
Identity used for P&L:
Current wallet balance = Wallet P&L + Games P&L + credit
So:
Wallet P&L = current wallet balance − Games P&L − credit
| Metric | Meaning |
|---|---|
| Total deposit to wallet | Real money deposited into the master wallet (gateway / shop). Does not include rewards or wallet→game moves. |
| Total bonus credit (all sources) | All free credits: rewards, signup/welcome bonus, admin/manual adjustments, and similar. Not real-money deposits or shop counter add. |
| Total cash out (payout) | Completed wallet payouts (Payout button). Excludes shop counter redeem, game→wallet transfers, and direct game cashout. |
| Wallet P&L | Current wallet balance − Games P&L − credit |
| Master → game | Money moved from master wallet into games (completed). |
| Game → master | Money moved from games back to master (completed; excludes direct game cashout). |
| Games P&L | Game → master − Master → game |
How to read it:
- Games P&L is net of completed wallet↔game transfers only — not provider bet/win detail.
- Wallet P&L is the residual that makes the balance identity hold after Games P&L and credit.
- Deposit and cash-out totals are shown for context; they are not the Wallet P&L formula.
- Totals are lifetime realized for that player (no date filter in this block).
Admin only — Shop and Player portals are unchanged for this feature.