Operator guideEN

Players / Bonuses

Cross-player issued-bonus inventory with server-side filters, preview popover, CSV export, and navigation into one issued-bonus detail page.

How to use this guide

Start with the main guide

Follow the explanation and examples first. Extra definitions and formulas are available below when you need them.

What this page shows

Players / Bonuses is the cross-player inventory for issued bonus rows (UserBonus). It lets operators search and review issued bonuses without first opening one player workspace.

The page combines:

  • server-backed filters for email, user ID, status, bonus type, and date window
  • a paginated result table
  • an in-page preview popover for one selected row
  • navigation to the full issued-bonus detail page
  • CSV export of the filtered issued-bonus dataset

When to use it

Use this page when you need to:

  • find bonuses issued to a specific player
  • review issued-bonus status across players
  • inspect the amount, wagering, conversion, correction, and expiry state for a row
  • preview a bonus quickly before opening the full detail page
  • export the current issued-bonus slice

How to read it

The page has two layers:

  1. Main filter row for Email, User ID, Status, Bonus Type, and the advanced Date From / Date Till window.
  2. Result table with the issued-bonus identity, player link, money columns, lifecycle chips, preview action, and Details navigation.

The row-level preview popover is useful for quick inspection, but the canonical deep-dive surface remains the full issued-bonus detail page.

By default, the page opens with a recent date window: Date From starts 14 days before page load and Date Till starts at the page-load current date. Change or reset the date filters when you need a broader or narrower issued-bonus slice.

Main actions

  • Filter changes reload the server-backed result set; they are not just local filtering on the visible page.
  • Preview opens the in-page popover preview without leaving the grid.
  • Details opens the read-only issued-bonus detail page.
  • Export CSV downloads the filtered issued-bonus rows as user-bonuses.csv.
  • Filters expands or collapses the date-range filter block.
  • Pagination changes the visible page or row limit and does not mutate issued-bonus records.

Known caveats

  • This cross-player page does not expose the manual cancel action. Cancellation belongs to player-context bonus flows, not to this surface.
  • There is no free-text local search here. Filtering is done through server-backed email, user ID, status, bonus type, and date-window parameters.
  • Created At is explicitly rendered in UTC on the table surface.
  • The preview popover uses the already loaded list row. It should not be treated as the full source of truth when exact lifecycle metadata is required.
  • Reset filters restores the default filter values but does not explicitly force the table back to page one.
  • Export uses the filtered dataset returned by the export flow, not only the currently visible page.
More details

Definitions and formulas

Open only the section you need. The relevant section opens automatically when you request help for a specific item on screen.

Calculations9 topicsOpen details

Default issued-bonus date window

By default, the list is not an all-time issued-bonus ledger; it starts from a recent rolling window unless operators change or reset the date filters.

Inputs
page-load current date, Date From, Date Till
Transform
The page initializes Date From to 14 days before page load and Date Till to the page-load current date.

Active filter badge count

The badge on Filters indicates how many filter groups are actively narrowing the issued-bonus list.

Inputs
user email filter, user id filter, status filter, bonus type filter, Date From, Date Till
Transform
Counts non-empty email, non-empty user id, non-All status, non-All bonus type, and date values that differ from the page default dates.

Issued-bonus list query

Changing any visible filter reloads the server result set; the table is not just filtering the currently loaded page in the browser.

Inputs
current page, rows per page, user email filter, user id filter, status filter, bonus type filter, Date From, Date Till
Transform
Sends page, limit, email, user id, status, bonus type, start date, and end date to the list flow; status and bonus type values set to All do not narrow the result.
Caveats
Email filtering is a contains-style match against the joined player email., Rows are returned newest first by created timestamp.

Reset filters behavior

Reset removes narrowing filters but does not explicitly force pagination back to page one.

Inputs
user email filter, user id filter, status filter, bonus type filter, Date From, Date Till, current page
Transform
Clears email and user id, sets status and bonus type to All, restores default dates, and leaves the current page number unchanged.

CSV export filter set

Export is for the matching filtered dataset, not only the currently visible page.

Inputs
user email filter, user id filter, status filter, bonus type filter, Date From, Date Till
Transform
Export sends current filters, omits All status and All bonus type, converts dates to ISO values, and does not send visible pagination.
Caveats
The export file has a fixed issued-bonus column set; it is not a copy of only the currently visible table page.

Preview uses loaded row data

Preview is quick inspection. It does not refresh the row from the server, so use Details when exact current lifecycle data matters.

Inputs
selected table row, preview button position, preview popover content
Transform
Preview stores the selected table row locally and renders the popover from that row payload.

Detail navigation by issued-bonus id

Opening detail is a read-only navigation action, not an edit or cancel action.

Inputs
User Bonus ID
Transform
Row click, Details, and View Full Details navigate to the issued-bonus detail surface using the selected user bonus id; the detail surface performs its own read after navigation.

Created At uses UTC display

Created At is meant for cross-operator comparison without relying on each operator's local timezone.

Inputs
Created At
Transform
Created At values are formatted with UTC display on both the table and preview.
Caveats
Use Created At as the issued-row creation timestamp, not as a bonus-expiry timestamp.

Expiry row highlighting

Expiry coloring is a visual urgency cue. It does not change the saved bonus status by itself.

Inputs
Expire At, current browser time
Transform
Expiry text is marked as expired when the expiry timestamp is before now, and close to expiry when less than three days remain.
Columns15 topicsOpen details

User Bonus ID

Internal identifier for one issued bonus instance.

Data Type
integer

Bonus ID

Reusable bonus definition referenced by the issued bonus row.

Data Type
integer

User Email

Player email attached to the issued bonus row. Clicking it opens the player workspace.

Data Type
string

Currency

Currency code used for the row amounts.

Data Type
string

Bonus Name

Human-readable name of the referenced reusable bonus definition.

Data Type
string

Bonus Amount

Granted amount of the issued bonus in the row currency.

Data Type
amount

Wager Left

Remaining amount the player still has to wager before clearing the bonus.

Data Type
amount

Winning Amount

Current winnings tracked against the issued bonus.

Data Type
amount

Amount Converted

Converted amount already moved out of the bonus flow.

Data Type
amount

Correction Amount

Manual correction amount attached to the issued bonus row.

Data Type
amount

Bonus Status

Current lifecycle state of the issued bonus.

Data Type
enum

Bonus Type

Category of the issued bonus.

Data Type
enum

Expire At

Expiration timestamp for the issued bonus instance.

Data Type
datetime

Created At

Creation timestamp rendered in UTC.

Data Type
datetime

Actions

Exposes preview and detail navigation for one issued-bonus row.

Data Type
action-group
Filters6 topicsOpen details

Search by user email

Restricts the grid to one player's email.

Type
text

Search by user ID

Restricts the grid to one player ID.

Type
text

Status

Filters rows by issued-bonus lifecycle state such as active, cancelled, expired, or win.

Type
select
Visible Values
All, Active, Cancelled, Expired, Win

Bonus Type

Filters rows by issued-bonus category.

Type
select
Visible Values
All, Free Spins, Deposit, No Deposit, Promotion, Instant Cashback
Submitted Values
all, freespins, deposit, no_deposit, promotion, instant_cashback
Caveats
The dropdown label is operator-facing; the submitted value is the stored bonus type filter used by the list and export flows.

Date From

Lower date bound for issued bonus records.

Type
date
Default Behavior
Defaults to 14 days before page load.

Date Till

Upper date bound for issued bonus records.

Type
date
Default Behavior
Defaults to the page-load current date.
Metrics6 topicsOpen details

Total bonuses found

Total number of issued-bonus rows matching the current filter set.

Aliases
issued bonuses count, user bonuses count
Value Basis
Server-reported count from the paginated issued-bonus list response.
Aggregation Behavior
Count belongs to the filtered result set, not only the currently visible page.
Filter Dependencies
user email, user id, status, bonus type, Date From, Date Till

Bonus Amount

Granted amount stored on one issued-bonus row.

Aliases
issued bonus amount, granted bonus amount
Value Basis
Row-level issued-bonus value; this page does not sum Bonus Amount across currencies.
Currency Basis
Displayed with the row/player currency code.
Aggregation Behavior
No aggregate or KPI formula is applied on this surface.

Wager Left

Remaining wagering amount on one issued-bonus row.

Aliases
remaining wager, wagering left
Value Basis
Row-level issued-bonus value returned with the list row.
Currency Basis
Displayed with the row/player currency code.
Aggregation Behavior
No aggregate or KPI formula is applied on this surface.
Caveats
Use the detail page when exact current lifecycle investigation is required.

Winning Amount

Current winnings tracked against one issued bonus.

Aliases
issued bonus winnings, bonus winning amount
Value Basis
Row-level issued-bonus value returned with the list row.
Currency Basis
Displayed with the row/player currency code.
Aggregation Behavior
No aggregate or KPI formula is applied on this surface.

Amount Converted

Stored converted amount already moved out of the issued-bonus flow for one row.

Aliases
converted bonus amount, bonus amount converted
Value Basis
Row-level issued-bonus value returned with the list row.
Currency Basis
Displayed with the row/player currency code; this surface does not expose the conversion-rate basis.
Aggregation Behavior
No aggregate or KPI formula is applied on this surface.
Caveats
Do not treat this table as a cross-currency conversion report.

Correction Amount

Stored manual correction amount attached to one issued-bonus row.

Aliases
issued bonus correction, bonus correction amount
Value Basis
Row-level issued-bonus value returned with the list row.
Currency Basis
Displayed with the row/player currency code.
Aggregation Behavior
No aggregate or KPI formula is applied on this surface.
Caveats
The cross-player list shows the stored correction value; it does not explain why the correction was made.
More help

Related pages

Bonuses / Player Bonuses

Related operator ledger for issued bonus instances, including filters, CSV export, and per-user bonus detail.

Players / Bonus Detail

Read-only detail page for one issued bonus, showing user, bonus, transaction, issuer, game, and lifecycle metadata.

Affiliate Payment Settings / Sending Window

Sending-window configuration tab for affiliate payment settings.

Bonus Map

Operator guide for building retention Bonus Map campaigns, a draft-first calendar of generated daily rewards that players claim across a fixed period.

Bonus Map / Form

Shared create-and-edit wizard for Bonus Map drafts: general content, visuals, render layout, tracking, bonus generation config, generated-day review, confirmation, and publish.

Bonus Map / List

Grid of all Bonus Map campaigns with derived lifecycle status, period, generated-day progress, and create, edit, and delete controls.