Guide · Bonuses
Wagering weights belong to your bonus engine
A bonus that wagers at 100% on every game will be cleared on the games with the widest margin or the shortest rounds. Weighting is how you stop that. The studio does not know your bonus rules.
7 min readUpdated By the Turnkeyxgaming team
The game client will not enforce your promotion
Contribution is a property of the campaign: this slot counts 100%, this live table counts 10%, this crash round counts nothing. Your platform applies it when the round settles. The aggregator can tell you the game type and the studio. It should not be the system that decides the weight, or every new campaign will need a supplier release.
Publish the weights where the player accepts the bonus. A weight that exists only in a back office will be the subject of the complaint, and you will lose the argument. Free-round winnings are a related but separate flow: they arrive as flagged credits, and the wagering on those credits starts after they land, if your rules say they wager at all.
Apply the weight when the round settles, using the game id on the wallet line. A weight chosen at launch and cached on the session goes stale the moment you edit the campaign, and a session opened before the edit will clear the bonus on yesterday's table. Read the campaign at settlement. Record the weight you used on the wagering ledger so a later edit does not rewrite history the player already played.
Where a contribution rule has to live
The studio can name the game type. It cannot know this week's campaign. The weight is yours, and it has to be visible in the place the player accepted.
| Decision | Who owns it | When it is read |
|---|---|---|
| Game type and studio | The catalogue, passed through on the round. | At settlement, off the wallet line, not from a lobby guess. |
| Weight for that type, and any title you set to zero | Your bonus campaign. | At settlement, from the campaign version that was live, then stored on the ledger. |
| Whether a free-round credit wagers at all | The same campaign, as a separate rule from cash-stake weights. | After the flagged credit lands, not at the moment you awarded the rounds. |
| A game the campaign excludes | Your platform, by refusing the launch. | Before the launch call. The client will not enforce a promotion it has never seen. |
Set weights before the campaign goes live
- 01
By type
Start from game type, then exclude specific titles you do not want to count.
- 02
Show the player
Put the contribution table on the bonus terms the player sees.
- 03
Flagged credits
Use the free-round flag so those wins enter the right wagering bucket.
A 100% weight on every game clears on the shortest rounds
If every title contributes in full, players will clear the requirement on whatever finishes fastest or carries the widest margin. That is a property of the campaign you published. The game client has no idea a promotion is open.
Worked example
Two players, one €20 bonus, different game mixes
Both players accept a €20 bonus at 35 times, so both face a €700 contribution requirement. Player A plays only slots at 100%. Player B splits the same €700 of stake between slots, live tables at 20% and crash at 10%. After €700 of stake, Player A has cleared the requirement and Player B has contributed far less, even though both have staked the same amount.
That is not a bug. It is the campaign working as published. The problem only starts when the contribution table is hidden or when a game's weight changes mid-clear. Show the table before opt-in, store the weight applied to each settled round, and let support read the same version the player accepted. The player who chose live tables is not being penalised by the wallet; they are being measured by the rule they were shown.
Same stake, different contribution
| Player | Stake mix | Contributed | Requirement left |
|---|---|---|---|
| A | €700 on slots at 100% | €700 | €0 |
| B | €400 slots, €200 live at 20%, €100 crash at 10% | €450 | €250 |
| B, if live counted 100% | The same rounds | €700 | €0, under a table nobody published |
FAQ
Questions operators ask
Can the aggregator block a bonus player from a game?
You can decline to launch a game for a player whose bonus rules exclude it. Do that in your platform before the launch call, not by hoping the game will refuse.
Can we change a title's weight halfway through a player's active bonus?
Only for rounds that have not settled. Rounds already settled keep the weight you stored. Recalculating them after a campaign edit changes a requirement the player has already met or missed.
Will the aggregator apply our wagering table if we send it?
No. Send nothing of the sort and do not expect a supplier release per campaign. Your platform applies the weight. The callbacks tell you which game settled.
Is it fair that the same stake clears different amounts?
It is fair only if the weights were visible before the player opted in. The weights reflect the margin and pace of each game type. Hiding them turns a published rule into a surprise, and the surprise is what support cannot defend.
Keep reading
Related pages
- Feature · Free spinsFree spinsAward free-spin campaigns across studios in one call. Wins arrive as flagged credits on your wallet, with no cash stake behind them.Read
- Solution · PlatformCasino platformPlayer accounts, a back office, a bonus engine and multi-brand support, wired to the game aggregator and the shared wallet.Read
- GlossaryBonus wageringWagering is the multiple of a bonus the player must stake. Contribution weights decide which games count toward clearing it.Read
- Guide · BonusesFree-round winningsFree-round wins have no cash stake. They arrive as flagged credits, and wagering begins only if your own rules require it.Read
Get a written quote and sandbox access
Tell us your licence, target markets and products. You get the GGR rate in writing, the studio list for your markets and sandbox credentials.