PREDICTOR

Platform Documents · 02 / 04

Financial Logic & Settlement

How money moves through a Predictor round: stakes, the prize pot, the platform fee, payouts, every refund case, and the exact wallet operations your platform sees — including timeout reconciliation.

Fee 10% of pot, at settlement Bet rake 0 · Refund rake 0 Every stake reaches a terminal state

01 · Money flow

One round, three movements

Every game — a single quiz or a whole tournament — follows the same financial shape. Players stake a fixed amount on entry, stakes form the pot, and the pot settles exactly once.

On join
Stake
Each player pays the instance's fixed stake. One wallet Bet call per player, carrying 0 rake.
→
While playing
The Pot
Pot = players × stake. Forfeited stakes (mid-game leavers) stay in. No money moves during rounds.
→
On finish
Settlement
The fee is deducted, winners split the remainder, and every player's wallet receives its closing operation.
House / platform fee
10% of the pot
Taken only at settlement. A round that refunds (void, tie, landslide) carries no fee at all.
Winners
90% of the pot
Split equally between the winning players (all stakes within one instance are equal).
Inside the fee · suggested split 10% of pot
Platform9% of pot Operator0.5% of pot Game provider (Predictor)0.5% of pot

These are our suggested commercial terms. The shares going to the operator and/or the game provider are negotiable and can be adjusted on partner request; the split is fixed in the partner agreement and applied at settlement.

02 · Payout formula

Settlement math

QuantityFormulaNotes
Potplayers × stakeStake is fixed per game instance.
Platform feepot × 10%Deducted once, at settlement only.
Prize poolpot − fee90% of the pot.
Payout per winnerprize pool ÷ winnersEqual split; winners always share one pool.

Worked example

Quiz instance · stake 1.00 · 4 players join · 2 pick the winning option

Pot
4.00
4 × 1.00
Fee
0.40
4.00 × 10%
Prize pool
3.60
4.00 − 0.40
Each winner
1.80
3.60 ÷ 2
Each loser
0.00
stake stays in pot
Landslide guard. If a winner's share would not beat their own stake (the winning side is ≥ 90% of players), the round pays no sub-stake "win": winning players are refunded their stake in full (no fee on those refunds), and losing players still lose. A win is always a real win.

03 · Wallet operations

What your wallet API sees

Predictor's RGS drives the operator wallet with three operations. The rake is a reporting field attached to settlement operations — it never changes the payout amount, which is already net.

OutcomeWallet operationAmountReported rake
Bet on joinCredit · bet− stake0
Win settlementDebit · win+ payout10% of stake
Loss settlementDebit · win (amount 0)010% of stake
Refund void / rollbackDebit · refund+ stake0

Platforms whose wallet API has no rake field simply ignore it — the fee is already netted out of the payout, so amounts are identical either way. Free-spin rounds replace the bet with the platform's free-bet flow (free-spin withdraw/deposit, or a zero-stake bet) funded by an operator-issued grant; any winnings pay out as real money through the normal win operation.

Currency. Game stakes are defined in the game currency and converted to the player's wallet currency with the live rate at bet time; the matching settlement uses the same conversion, so bets and payouts always reconcile in the player's currency.

04 · Refunds

Every case where money comes back

Refunds return the full stake and never carry a fee. These are the only paths:

CaseWhenWho is refunded
Not enough playersFewer than 2 players (quiz) or 3 (tournament) when the game would startEveryone who staked
Unanimous voteAll players picked the same option — no losers to fund a potEveryone
Full tieEvery option received the same number of votesEveryone
LandslideWinning share ≤ stake (winning side ≥ 90%)Winners only; losers still lose
Pre-start exitA joined tournament player leaves up to 2 minutes before the start timeThe leaving player
Wallet rollbackA bet with an unknown outcome is voided by reconciliation (see 05)The affected player
The one case nobody is paid: if a round ends with zero votes cast, all stakes are lost to the house. And a player who leaves mid-game forfeits their stake — it stays in the pot for the remaining players; their record settles as a loss.

05 · Reliability

Timeouts, retries and reconciliation

Wallet calls are idempotent and retried with the same transaction id. When a bet still has no definite outcome after retries (operator timeout), Predictor never reports it as successful. Instead it is recorded in a durable in-doubt ledger and a background reconciler drives it to a terminal state:

Terminal stateMeaning
Rolled backThe operator-side transaction was voided with an idempotent rollback — no money moved. This is the standard outcome for an in-doubt bet.
ConfirmedThe operator confirmed the transaction landed (used for wins).
FailedThe operator definitively rejected it; no money moved.
Manual reviewCould not be auto-resolved (e.g. the player session expired); flagged for a human.

Every wallet call — successful or reconciled — is also written to Predictor's own transaction ledger with the platform's transaction id, so both sides can be audited line by line.

06 · Guarantees

Invariants your finance team can hold us to

InvariantConsequence
Fee only at settlementVoided, tied and refunded rounds cost players nothing — ever.
Payouts are netThe amount in the win operation is final; rake is reporting, not a deduction to apply.
Equal stakes, equal sharesNo player in an instance can stake more than another; winners always split the pool evenly.
One terminal state per stakeEvery bet ends as exactly one of Win / Loss / Refund — in the wallet and in the player's game history.
Unknown ≠ successA timed-out bet is reconciled or rolled back; it is never silently kept.