​

F015 — Payout Calculation

​

Business Rule

payout = Σ(stakeAmount × oddsAtBet)   for all bets on WINNING hands, all stages

• Winning hand only: bets on losing hands and dead hands contribute £0
• Locked-in odds: oddsAtBet is the oddsRounded value at the moment the bet was placed, not the river odds
• All stages included: hole, flop, and turn bets on the winner all pay out
• Credits: credits = (initialCredits − totalBet) + payout at end of round

​

Worked Example (from Game Concept Document)

“If a hand has a 25% chance of winning this is first converted to European odds (4:1) then a house margin is subtracted of (say) 3% so odds become 3.88:1. If the player bets £1 on the hand and it wins they will receive £3.88 payout. If the player has four successive bets of same value statistically only one will win; thus in this case RTP = payout/bet = 3.88/4 = 0.97.”

​

JavaScript Reference

// hands.js:957 — ResolveHands()
var winAmount = 0;
for (var hand = 0; hand < NUMBER_OF_HANDS; hand++) {
    for (var bet = 0; bet < 3; bet++) {
        winAmount += GetHandOdds(hand, bet) * GetHandBet(hand, bet);
    }
}
SetWinAmount(winAmount);

// CC_DEDUCT_BETS — deducts total bets after final betting window
case CC_DEDUCT_BETS:
    SetCreditAmount(credits - GetBetAmount());

// CC_ADD_WIN — adds payout after resolution
case CC_ADD_WIN:
    SetCreditAmount(credits + GetWinAmount());

​

TypeScript Implementation

resolveBets(): number {
    let totalPayout = 0;
    for (const bet of this.bets) {
        if (this.isHandWinner(bet.handIndex)) {
            totalPayout += Math.round(bet.stakeAmount * bet.oddsAtBet);
        }
    }
    this.credits += totalPayout;
    this.winAmount = totalPayout;
    return totalPayout;
}

​

Bug fixed (HEDGE-136)

​

Acceptance Criteria

​

Version Parity

​

Test Coverage