Prize Money & Awards

Prize pools are managed at /prize-pools/ as competition-scoped documents that may be funded by a sponsor (linked through Sponsorship and Grants) or by the federation directly. Distribution rules are percentage-based: /prize-pools/{id}/recalculate-distribution rebuilds the per-place payout amounts whenever the pool size or rules change, and /prize-pools/{id}/generate-payouts reads the published competition results and creates a PrizePayout per finishing position. Each PrizePayout is approved individually or in batch through /prize-payouts/batch-approve with optional withholding-tax calculation.

Withholding rates are standardised per jurisdiction — Sweden 30 percent, France 30 percent, Germany 25 percent, Spain 19 percent, Italy 26 percent, United Kingdom 20 percent — and can be overridden per payout via custom_tax_rate. /prize-payouts/calculate-tax provides a preview before approval and /prize-payouts/tax-report aggregates gross, withholding and net per jurisdiction for tax filings. After approval, /prize-payouts/{id}/process-payment links the payout to a Payment document so settlement runs through the same Stripe / Swish / bank-transfer pipeline as any other outbound transaction, with Stripe Connect handling marketplace payouts where the player has a connected account. Trophies and medals are tracked in parallel via /trophy-inventories/ for stock and /trophy-awards/ for individual awards. /prize-pools/{id}/generate-awards reads the same results and assigns gold, silver, bronze, plaques or certificates per place, moving each award through pending -> awarded -> returned states.