Cash out
Cash Out
Overview
Cash Out is a feature that allows an early withdrawal of funds from an active bet before the odds (selections/markets) are settled. This option is available when the player decides to settle the bet prematurely, minimizing potential losses or securing a portion of the winnings.
How Cash Out Works
- Bet Placement: A player places a bet of any amount on a sport event.
- No Bet Cancellation: Once a bet is placed, it cannot be canceled. The bet remains in effect until the market settlement. However, the Cash Out feature provides an alternative for early redemption.
- Cash Out Option: If the player anticipates an unfavorable outcome (e.g., the bet is likely to lose), they can request a Cash Out. This action allows the player to reclaim a portion of the bet amount, thereby reducing the potential loss.
Supported Bet Types and Options
- Available Bet Types: Cash Out is available for both Single and Combo (Express) bets.
- Cash Out Options: Both full and partial Cash Outs are supported. Players can choose to withdraw the entire amount offered or only a part of it, leaving the remainder of the bet active.
Foreign Cash Out
Foreign cash out is a specialized cashout mechanism used when the standard cash out calculation cannot be performed due to missing data or when partners want to implement their own cash out logic.
Use Cases
- Mixed Combo Bets with Foreign Selections
- Partner Custom Implementation
Cash Out Calculation
To calculate foreign cash out amounts, each odd we send contains a probability field indicating the pure chance, which is required for cash out calculation.
Calculation Process: - Use the probability field from each odd to determine the current winning probability - Apply your custom cash out logic based on these probabilities - Calculate the appropriate cash out amount according to your business rules
Reporting Requirements
When foreign cash out is used, the cas hout must be reported in the foreign_cash_out_orders field in the PATCH /bets/{bet_id} request.
Note
In case foreign cash out is used, our MTS does not validate restrictions. All restriction validation must be implemented on the partner side. This is the same approach as when advisory MTS is used. For detailed restriction requirements, see Betting & Display Conditions
Cash Out Amount Calculation
The amount available for Cash Out depends on the real-time change in odds during the sporting event:
- Increase in Winning Probability: If the likelihood of winning increases, the odds decrease, and the Cash Out amount increases. For example, if the team on which the bet was placed is performing well, the Cash Out value will be higher.
- Decrease in Winning Probability: If the likelihood of winning decreases, the odds increase, and the Cash Out amount decreases. For example, if the team from the bet selection is underperforming (plays poorly/doesn't give all their best), the Cash Out value will be lower.
In any case, the player, performing a cash out, guarantees the return of funds less than the winning amount, but more in case of losing the bet (to reduce the risk of losing funds in case of loss).
Use Cases
- Securing Profits: The player can lock in a profit if the bet is in a favorable position, even before the event ends.
- Minimizing Losses: If the bet is unlikely to succeed, the player can withdraw a portion of the funds to mitigate potential losses.
- Flexible Bet Management: With partial Cash Out, the player can secure part of the winnings or reduce risk, while keeping the rest of the bet active for potential further gains.
Cash-out flow diagram
