How Freebet Works¶

Understanding freebet mechanics helps you implement the wallet integration correctly.

What is a Freebet?¶

A freebet allows players to place bets without using their own funds. It's a "risk-free" bet where:

• If the bet wins: Player receives the winnings (excluding the original freebet amount)
• If the bet loses: No funds are deducted from the player's balance

Key difference from Sport Bonus Amount: Freebets have no wagering requirements. Winnings are paid directly as cash.

Balance Types Used¶

Freebet transactions work with three balance types:

Bonus Balance¶

Used to store the freebet amount:

• Freebet is awarded to bonus balance
• Deducted from bonus balance when bet is placed
• Returned to bonus balance if bet is rolled back

Cash Balance¶

Used for winnings:

• Receives winnings when freebet bet wins (excluding original freebet amount)
• Not affected when freebet bet loses

Retract Balance¶

Technical balance for tracking used freebets:

• Original freebet amount is moved here when bet is settled (win or lose)
• Optional to maintain - used for analytics and reporting purposes only
• Not available for gameplay or withdrawal
• Does not affect system functionality if not implemented

Note: Freebet does NOT use locked balance (unlike Sport Bonus Amount).

Freebet Lifecycle¶

1. Award Phase¶

Freebet is granted to the player:

bonus: 0 → 1000 (freebet awarded)

2. Bet Placement Phase¶

Player places a bet using the freebet:

bonus: 1000 → 0 (freebet used for bet)

3. Settlement Phase¶

If bet wins:

cash: +3000 (winnings, excluding freebet amount)
retract: +1000 (original freebet amount)

If bet loses:

cash: 0 (no change)
retract: +1000 (original freebet amount)

Winnings Calculation¶

The key concept: Player receives winnings minus the original freebet amount.

Example:

• Freebet amount: 1000
• Bet odds: 4.0
• Total payout if bet wins: 1000 × 4.0 = 4000
• Player receives: 4000 - 1000 = 3000 (cash)
• Original freebet: 1000 (moved to retract)

Why? The freebet itself is not "real money" - it's a promotional amount. The player only receives the profit from the bet.

Your Responsibility¶

Important: You don't need to calculate winnings yourself. GR8 Tech system:

• Tracks freebet balances for each campaign
• Calculates all amountBreakdown values
• Sends you ready-to-apply amounts in each transaction request

Your wallet implementation should:

• Apply the received amountBreakdown to player balances
• Return updated balances in the response
• Implement idempotency to handle duplicate requests

Multiple Active Freebets¶

Players can have multiple active freebets simultaneously. Each freebet is identified by:

• sportBonusOfferId - The freebet campaign identifier (Activity ID from Journey Builder)
• sportBonusPlayerOfferId - The player's specific freebet activation identifier

GR8 Tech system tracks each freebet separately and calculates transactions independently.

Comparison with Sport Bonus Amount¶

For more details on Sport Bonus Amount, see Sport Bonus Amount documentation.