Phoenix Prediction Docs

Settlement

How operators review market settlement and payout status

When a market resolves, Phoenix calculates each player result and updates settlement state. Operators should watch settlement until the player-facing result, financial records, and support trail are complete.

For wallet movement, Phoenix credits operator wallets through signed wallet operations. Settlement can continue briefly after the operator resolves the market because wallet operations may be delivered through retryable background work.

Settlement is a workflow

Resolution chooses the result. Settlement confirms that player outcomes, financial records, and support references are complete.

What Happens

  1. The market resolves.
  2. Phoenix records the winning side or void result.
  3. Phoenix calculates each player outcome.
  4. Phoenix updates settlement records and creates credit_cash operations for payouts, refunds, voids, or corrections.
  5. Settlement status becomes complete when the required records and deliveries succeed.

What a Successful Resolve Means

If an admin resolve action succeeds, Phoenix has accepted the final outcome and started settlement. It does not always mean every player payout is already visible in the operator wallet ledger, especially when wallet operations are still retrying or awaiting reconciliation.

Settlement can continue briefly after resolution, especially for markets with many positions.

What Operators Should Watch

  • Markets that are resolved but not fully settled
  • Players with missing or delayed financial movement
  • Voided markets where refunds are still pending
  • High-volume markets that may take longer to complete
  • Any settlement warning shown in the admin panel

When Settlement Is Delayed

A short delay can be normal for large markets. Escalate when:

  • The same market remains partially settled longer than expected.
  • Multiple players report missing payouts.
  • The admin panel shows repeated settlement warnings.
  • Finance reports do not match expected payout or refund totals.

Support Checklist

When support asks about a settled prediction:

  1. Find the player account.
  2. Find the market and selected outcome.
  3. Confirm the market status is settled or voided.
  4. Check the player's position result.
  5. Check the settlement transaction reference.
  6. Compare the financial result with the operator ledger.
  7. Escalate to the technical team when the admin panel, Phoenix settlement state, and operator ledger disagree.

The operator wallet ledger should be able to answer: "Did this Phoenix Prediction settlement affect the player's balance exactly once?"