03 / Operations
Understand reward settlement
Configure reward terms and follow free bets through to wallet settlement.
Campaign rewards are issued as free bets. The same reward mechanism is used across tournaments, streaks, missions, rain and jackpots.
What a free bet is
A free bet is a stake funded on the player's behalf. The player places it like a normal bet without staking their own money. If it wins, the winnings are credited to their wallet; if it loses or expires unused, nothing is charged.
The reward settings
Wherever a campaign grants a reward, you configure it with the same four fields:
| Field | Meaning |
|---|---|
| Amount each | The stake of each free bet, in the campaign currency. |
| Count | How many free bets the reward grants. |
| Expires (h) | Hours from the grant until an unused free bet expires. |
| Min odd | The minimum cashout multiplier the free-bet stake must reach to be valid. |
The reward type is fixed to Free bet; there is no cash option.
The lifecycle
The campaign grants it
When a player earns a reward - a prize tier, a streak milestone, a completed mission, a claimed rain drop, or a jackpot - the free bet is granted to them. The grant itself moves no money; it creates a claimable free bet.
The player plays it
The free bet appears in the player's free-bet list in the game, to play when they choose. Its stake is the amount you configured.
A win settles to your wallet
If the free bet wins, the winnings are deposited to the player's wallet through your FREE_BET_CLAIM deposit endpoint - the same endpoint used for any free bet. Only the winnings are deposited; the stake was the free bet, not the player's money.
An unused free bet expires
If the player does not play it before expiry, it lapses. Nothing is charged and nothing settles.
Integration
Engagement adds no new webhook. An engagement win arrives at your wallet as a FREE_BET_CLAIM deposit, made idempotent by the free-bet id - see the Deposit webhook. If your free-bet integration is complete, engagement is already supported.
Expiry and minimum odds
Two fields control how forgiving a free bet is:
- Expiry sets how long the player has to use it. A short expiry (hours) suits a live-room reward; a longer one (days) suits a milestone or prize a player should not lose by missing a session.
- Minimum odds set the lowest cashout multiplier that counts as a valid play.
1.0lets the player cash out at any point; a higher value requires them to reach a larger multiplier before the free bet pays.
Cash payouts
Engagement does not pay cash. Every reward is a free bet.
The deposit contract models bets and free-bet claims, but not a standalone cash prize. A cash payout would require a new operator-side deposit action and a change to that contract, so the current products all use the free-bet path.