Betting free bet
General information
A free bet is a type of bonus with the help of which a player can place a one-time bet on the website according to specified parameters (for example, a bet on a certain sport).
A bet of this type is placed without using a player's personal funds, only the funds from the bonus account are used. This bonus provides an opportunity to receive winnings in case of a successful bet.
Free bets are accrued by the integrating party, and calculations (whether free bets are successful or not) are performed by the Betting platform.
The life cycle of a free bet
- A player places a bet on a website: fills out a bet slip, and uses an available free bet.
- A match or sport event on which a bet was made takes place. Parameters of the bet can change.
- The bet's status is checked on the Betting platform's side, and such actions take place:
- The bet wins: the player's balance is updated. When the bet is settled, a notification for the integrating party is created on the Betting platform's side via the bet settle callback.
- The bet loses: the player's balance doesn't change, the free bet is considered used and is not available anymore.
- The bet is declined or placed with error: the free bet is available for use again, the player's balance doesn't change.
Free bet lifecycle diagram
Implementation details
Details of calculating a bet with a free bet
The winnings are calculated using the formula: (bet amount * coef) - free bet amount
For example, a bet with free bet =10$, coef=2, free bet amount=10$
Payout of winnings for the player = 10$*2-10$=10$
In the case of a regular bet, the payout to the player would be 20$.
Functionality on the Betting platform:
- Accept the request the integrating party sends.
- Save a record of the accrual of free bets with certain parameters.
- Display available free bets to players when they fill out bet slips (place bets) on the website.
- Determine whether the free bet has won or lost.
Conditions
Players can be granted free bets if they meet the conditions set by the integrating party. To create a free bet request, the integrating party must send the following conditions in the post/freebet/create and post/freebet/update methods:
| Type | Condition | Description |
|---|---|---|
| BetDetails | type [single, express, system] | Type of bet: single, express (combo), or system. Types of bets are described in detail on the page: /betting/bet/. |
| odds_count | Range of odds count in a bet (values max, min). | |
| total_odds_coefficient | Range of the total odds coefficient of a bet (values max, min). | |
| system_size | Number of elements in a bet of the system type (values max, min). | |
| odds_coefficient | Range of the odd coefficient on the outcome of the event (values max, min). | |
| combinations_count | Number of combinations in a bet of the system type (values max, min). | |
| sport | IDs of the kind of sports. | |
| tournament | Tournament IDs. | |
| sport_event | IDs of the sport events. | |
| market_types | ID of the market type. | |
| competitor | IDs of a competitor in a sport event. | |
| Money | amount | Amount of a free bet. |
| currency_code | Currency code in the ISO 4217 (alfa-3) format, for example, "USD". | |
| expires_at | Expiration date (date and time) in the DATE_RFC3339 format. | |
| foreign_params | A field in which you can send and receive any customizable parameters. |