Operator guideENdashboardbonuspayouts

Dashboard / Bonus Payouts

Shared comparison widget rendered for tournament, challenge, and no-deposit bonus payout groups.

Reader view

Clean portal guidance

This page keeps the operator explanation, field and action descriptions, and screenshots visible without exposing repo paths, raw sidecars, or editorial-only implementation details.

Narrative content

Page body

What this widget shows

This is one shared widget displayed three times for different bonus types:

Tournament Bonus Payouts
Challenge Bonus Payouts
No Deposit Bonus Payouts

Each version shows the same fixed six backend rows across:

Today
Yesterday
This month
Selected date range

The widget also gives operators:

a start-date picker
an end-date picker
a manual refresh action
a CSV download action

How to read it

The frontend mainly controls layout and formatting. The traced backend services currently return six fixed rows:

Total Payouts (EUR)
Transaction Count
Unique Players
Average Payout (EUR)
Maximum Payout (EUR)
Non-Cash Payouts (EUR)

Use this widget when you want a fast payout comparison for one bonus family without opening a separate bonus report.

Known caveats

The three Dashboard tiles use separate backend endpoints.
The Selected date column is actually a custom date-range bucket built from the widget Start date and End date values.
Amount rows are displayed in EUR and count rows stay raw counts.
The no-deposit backend currently reuses tournament-style description strings for some rows. The docs normalize the operator wording to no-deposit even where the raw backend description still says tournament.
Refresh and Download CSV are widget-level actions and do not change the underlying bonus family.
Older notes may mention Revenue Payout or Net Cash Hands, but those exact row labels were not found in the current verified FE or backend path for this six-row widget as of 2026-04-21.

Field dictionary

Fields, columns, and metrics

fieldchallenge

Open the full page to review the detailed operator notes and references.

fieldtournament

Open the full page to review the detailed operator notes and references.

fieldno-deposits

Open the full page to review the detailed operator notes and references.

fieldStart date

Lower bound for the custom comparison bucket rendered in the `Selected date` column.

fieldEnd date

Upper bound for the custom comparison bucket rendered in the `Selected date` column.

fieldMetric

Open the full page to review the detailed operator notes and references.

fieldToday

Open the full page to review the detailed operator notes and references.

fieldYesterday

Open the full page to review the detailed operator notes and references.

fieldThis month

Open the full page to review the detailed operator notes and references.

fieldSelected date

Open the full page to review the detailed operator notes and references.

fieldTotal Payouts (EUR)

Sum of payout value for the selected bonus family and comparison bucket.

fieldTransaction Count

Number of payout transactions included in the bucket.

fieldUnique Players

Number of distinct players receiving payouts in the bucket.

fieldAverage Payout (EUR)

Average payout amount per transaction for the bucket.

fieldMaximum Payout (EUR)

Largest single payout value inside the bucket.

fieldNon-Cash Payouts (EUR)

Sum of non-cash payout value inside the bucket.

fieldTournament Bonus Payouts

Shared payout widget variant backed by the tournament bonus payout endpoint.

fieldChallenge Bonus Payouts

Shared payout widget variant backed by the challenge bonus payout endpoint.

fieldNo Deposit Bonus Payouts

Shared payout widget variant backed by the no-deposit bonus payout endpoint.

fieldTotal Payouts (EUR)

Total payout amount for the selected bucket and bonus family.

fieldTransaction Count

Number of payout transactions for the selected bucket and bonus family.

fieldUnique Players

Distinct players receiving payouts for the selected bucket and bonus family.

fieldAverage Payout (EUR)

Average payout value per transaction for the selected bucket and bonus family.

fieldMaximum Payout (EUR)

Largest single payout value for the selected bucket and bonus family.

fieldNon-Cash Payouts (EUR)

Total non-cash payout value for the selected bucket and bonus family.

Action dictionary

Actions and operator workflows

actionRefresh

Re-fetches the current bonus-payout widget family using the selected date filters.

actionDownload CSV

Downloads the currently visible bonus-payout widget family as CSV.

actionStart and End Date

Changes the custom date range used for the `Selected date` comparison column in the widget matrix.

Structured guide

Structured descriptions

Dashboard metrics, grid columns, fields, filters, and operator actions are rendered below as human-readable descriptions.

Screenshots

Interface captures

No committed screenshots for this page yet.

Calculation notes

Calculations

calculation

Today / Yesterday / This month / Selected date

Formula Text: `Today`, `Yesterday`, and `This month` are backend-owned aggregates. The `Selected date` column is the backend `customDate` bucket built from the widget `Start date` and `End date` range.
Operator Note: The frontend formats the matrix but does not recompute payout totals.
Verification Status: verified_backend

calculation

Amount rows vs count rows

Formula Text: Backend rows carry a `type` marker. `amount` rows are rendered with EUR currency formatting, while `count` rows are rendered as plain counts.
Operator Note: This is why `Transaction Count` and `Unique Players` do not show a currency symbol even though they live in the same widget matrix.
Verification Status: verified_backend

calculation

Fixed row inventory

Formula Text: Each traced backend service currently returns the same six rows in a fixed order: total payouts, transaction count, unique players, average payout, maximum payout, and non-cash payouts.
Operator Note: The docs treat this row set as fixed for the current implementation instead of assuming an arbitrary backend-defined inventory.
Verification Status: verified_backend

calculation

Average Payout

Formula Text: For the `This month` and `Selected date` buckets, the traced backend services recompute `avg_payout = payout_sum / transaction_sum` after EUR-normalized accumulation and return `0` when `transaction_sum` is `0`. Day buckets render the backend `avg_payout` row value directly.
Operator Note: `Average Payout (EUR)` is a real row in the current widget. Older notes mentioning `Revenue Payout` or `Net Cash Hands` do not match the verified six-row inventory.
Verification Status: verified_backend

Grid columns

Columns

field

Metric

field

Today

field

Yesterday

field

This month

field

Selected date

Filter dictionary

Filters

field

Start date

Lower bound for the custom comparison bucket rendered in the `Selected date` column.

Type: date

field

End date

Upper bound for the custom comparison bucket rendered in the `Selected date` column.

Type: date

Metric dictionary

Metrics

metric

Tournament Bonus Payouts

Shared payout widget variant backed by the tournament bonus payout endpoint.

Aliases: tournament bonus payouts, tournament bonus widget
Backend Service: GET /api/admin/get-tournament-bonus-payouts
Availability Note: Uses the tournament payout backend row set and exposes the same six fixed rows as the other bonus-payout widgets.
Verification Status: verified_backend
Last Verified At: 2026-04-18

metric

Challenge Bonus Payouts

Shared payout widget variant backed by the challenge bonus payout endpoint.

Aliases: challenge bonus payouts, challenge bonus widget
Backend Service: GET /api/admin/get-challenge-bonus-payouts
Availability Note: Uses the challenge payout backend row set and exposes the same six fixed rows as the other bonus-payout widgets.
Verification Status: verified_backend
Last Verified At: 2026-04-18

metric

No Deposit Bonus Payouts

Shared payout widget variant backed by the no-deposit bonus payout endpoint.

Aliases: no deposit bonus payouts, no deposit bonus widget
Backend Service: GET /api/admin/get-no-deposits-bonus-payouts
Availability Note: Uses the no-deposit payout backend row set; some raw backend descriptions still reuse tournament wording, which the docs normalize.
Verification Status: verified_backend
Last Verified At: 2026-04-18

metric

Total Payouts (EUR)

Total payout amount for the selected bucket and bonus family.

Backend Formula: total_payout
Verification Status: verified_backend
Last Verified At: 2026-04-18

metric

Transaction Count

Number of payout transactions for the selected bucket and bonus family.

Backend Formula: transaction_count
Verification Status: verified_backend
Last Verified At: 2026-04-18

metric

Unique Players

Distinct players receiving payouts for the selected bucket and bonus family.

Backend Formula: unique_players
Verification Status: verified_backend
Last Verified At: 2026-04-18

metric

Average Payout (EUR)

Average payout value per transaction for the selected bucket and bonus family.

Backend Formula: avg_payout; monthToDate and customDate recompute avg_payout = payout_sum / transaction_sum when transaction_sum > 0, else 0
Comparison Notes: The current verified widget row set includes `Average Payout (EUR)`. Older external notes that mention `Revenue Payout` or `Net Cash Hands` do not match the current six-row FE/backend inventory.
Verification Status: verified_backend
Last Verified At: 2026-04-21

metric

Maximum Payout (EUR)

Largest single payout value for the selected bucket and bonus family.

Backend Formula: max_payout
Verification Status: verified_backend
Last Verified At: 2026-04-18

metric

Non-Cash Payouts (EUR)

Total non-cash payout value for the selected bucket and bonus family.

Backend Formula: total_non_cash_payout
Verification Status: verified_backend
Last Verified At: 2026-04-18

Operational notes

Notes

item

The widget always sends both `startDate` and `endDate`; the FE label `Selected date` maps to the backend `customDate` range bucket, not to a single picked day.

item

The traced backend services currently return the same six fixed rows and also mark each row as `amount` or `count` for FE rendering.

item

In all three traced backend services, the `This month` and custom-date `Average Payout (EUR)` values are recomputed from `payout_sum / transaction_sum` after EUR-normalized accumulation, with `0` returned when there are no transactions.

item

The no-deposit service currently reuses tournament-style descriptions for several rows; docs normalize the operator wording to the no-deposit family even where the backend text still says `tournament`.

Related references

Related pages

pageDashboard / Game Reports

Deep comparison widget for Games and Providers with separate backend paths, multiple grouping options, search, and a mix of backend and frontend summary logic.

pageDashboard / GGR Chart

Revenue trend chart with frontend summary cards derived from the loaded time series.

pageDashboard / KPI Reports

Sortable KPI table for games or providers, used to compare betting and GGR-style metrics by entity rather than by time bucket.

pageDashboard / KPI Summary

Comparison table for high-level KPI rows across today, yesterday, month-to-date, and the selected period, with frontend trend chips and data-source badges.

pageDashboard / Live Player Report

Card-based snapshot of today's GGR, total players, conversion rates, active players, and merchant balance.

pageDashboard / Performance Overview

Container widget for Casino, Banking, and Registrations charts with shared date-range and streamer-data controls.