Platform Documents · 02 / 04
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.
01 · Money flow
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.
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
| Quantity | Formula | Notes |
|---|---|---|
| Pot | players × stake | Stake is fixed per game instance. |
| Platform fee | pot × 10% | Deducted once, at settlement only. |
| Prize pool | pot − fee | 90% of the pot. |
| Payout per winner | prize pool ÷ winners | Equal split; winners always share one pool. |
Quiz instance · stake 1.00 · 4 players join · 2 pick the winning option
03 · Wallet operations
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.
| Outcome | Wallet operation | Amount | Reported rake |
|---|---|---|---|
| Bet on join | Credit · bet | − stake | 0 |
| Win settlement | Debit · win | + payout | 10% of stake |
| Loss settlement | Debit · win (amount 0) | 0 | 10% of stake |
| Refund void / rollback | Debit · refund | + stake | 0 |
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.
04 · Refunds
Refunds return the full stake and never carry a fee. These are the only paths:
| Case | When | Who is refunded |
|---|---|---|
| Not enough players | Fewer than 2 players (quiz) or 3 (tournament) when the game would start | Everyone who staked |
| Unanimous vote | All players picked the same option — no losers to fund a pot | Everyone |
| Full tie | Every option received the same number of votes | Everyone |
| Landslide | Winning share ≤ stake (winning side ≥ 90%) | Winners only; losers still lose |
| Pre-start exit | A joined tournament player leaves up to 2 minutes before the start time | The leaving player |
| Wallet rollback | A bet with an unknown outcome is voided by reconciliation (see 05) | The affected player |
05 · Reliability
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 state | Meaning |
|---|---|
| Rolled back | The operator-side transaction was voided with an idempotent rollback — no money moved. This is the standard outcome for an in-doubt bet. |
| Confirmed | The operator confirmed the transaction landed (used for wins). |
| Failed | The operator definitively rejected it; no money moved. |
| Manual review | Could 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
| Invariant | Consequence |
|---|---|
| Fee only at settlement | Voided, tied and refunded rounds cost players nothing — ever. |
| Payouts are net | The amount in the win operation is final; rake is reporting, not a deduction to apply. |
| Equal stakes, equal shares | No player in an instance can stake more than another; winners always split the pool evenly. |
| One terminal state per stake | Every bet ends as exactly one of Win / Loss / Refund — in the wallet and in the player's game history. |
| Unknown ≠ success | A timed-out bet is reconciled or rolled back; it is never silently kept. |