Operator guideEN

Currencies / List

Currency inventory page for reviewing configured currencies, toggling availability, and recalculating bonus currency values.

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

This page lists the configured currency records available in CRM. Operators use it to review each currency code, exchange-rate value, marketing ratio, loyalty-point value, primary flag, active status, and icon.

How operators use it

review which currencies are already configured
open the create flow for a new currency
open one saved record for detail or edit work
enable or disable a currency directly from the Status pill
run Auto Calculation Bonuses Currencies after currency marketing ratios or bonus EUR values need to be propagated into bonus currency JSON

Important caveats

The Status pill is clickable and updates immediately; there is no confirmation dialog on this list.
Exchange Rate and MRKTG Ratio to EUR are different stored values. The verified bonus auto-calculation action uses marketingRatio, not the displayed exchange-rate field.
Auto Calculation Bonuses Currencies updates bonus currency configuration for active currencies by recalculating values from the EUR bonus configuration. It is not a currency-rate fetch and it does not create or edit currency rows.
The FE hook shows a generic loyalty-games error message on auto-calculation failure, but the verified button calls the bonus-currency auto-calculation endpoint.
This CRM currency list is separate from Core/NX currency-game and currency-provider mapping screens under /nx/currencies.

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.

Calculations8 topicsOpen details

List pagination

Logic: FE initializes the list request with pageNo=1 and limit=200., Visible row-limit choices are 5, 15, 30, 50, 100, 200, and 500., Backend receives one-based pageNo and applies limit plus offset., Backend orders currency rows by currency ID ascending.

Currency type display

Logic: FE displays `Crypto` when Currency.type is 0., FE displays `Fiat` for other Currency.type values., Backend constants define crypto as ID 0 and fiat as ID 1.

Currency icon display

Logic: Empty iconUrl renders an empty avatar slot., HTTP iconUrl values are used directly., `/api/...` iconUrl values are resolved through the admin API base URL.

Primary and status pills

Logic: Primary displays Yes when isPrimary is true and No when false., Status displays Active when isActive is true and Disabled when false., Only the Status pill is clickable from the list.

Status toggle flow

Logic: Clicking the Status pill sends currencyId and the inverted isActive value., Backend validates the currency exists before updating., Backend updates Currency.isActive inside a transaction., FE revalidates the currencies list after a successful backend response., There is no confirmation dialog.

Bonus currency auto-calculation

Logic: The list button calls the backend bonus-currency auto-calculation route., Backend loads active currencies and all bonuses., Only bonuses with existing EUR currency data are recalculated., For each active currency, backend creates or replaces bonus.currency[code] from bonus.currency.EUR., Most EUR numeric fields are multiplied by the target currency marketing ratio and rounded for the target currency code., Excluded fields are copied from EUR without multiplication., Updated bonus currency JSON is persisted back to the bonus row.

Auto-calculation excluded fields

Logic: bonus_bet_only is copied without multiplication., bonus_percent is copied without multiplication., deposit_multiplier_max_win_amount is copied without multiplication., deposit_plus_bonus_wagering_multiplier is copied without multiplication., minimum_ngr_to_qualify is copied without multiplication., maximum_ngr_to_qualify is copied without multiplication.

Marketing ratio impact

Logic: The MRKTG Ratio to EUR column displays Currency.marketingRatio., Auto Calculation Bonuses Currencies uses marketingRatio as the multiplier for derived per-currency bonus values., Exchange Rate is displayed in the list but is not used by this verified bonus-currency auto-calculation action.

Fields11 topicsOpen details

ID

Internal identifier for the currency row.

Data Type: integer
Sorting: Backend list always orders rows by currency ID ascending.

Name

Main display name for the currency.

Data Type: string

Img

Small visual icon used to confirm the currency visually.

Data Type: image
Display: Empty: Empty avatar slot. | Http Url: Uses the URL directly.

Code

Currency code used throughout the platform.

Data Type: string

Exchange Rate

Stored exchange-rate value shown directly in the grid. It is not the value used by the verified bonus-currency auto-calculation action.

Data Type: number

MRKTG Ratio to EUR

Marketing ratio value shown for the currency. The bonus-currency auto-calculation action uses this value to derive per-currency bonus amounts from the EUR bonus configuration.

Data Type: number

Loyalty Points

Loyalty-point value associated with the currency.

Data Type: number

Type

Displays whether FE treats the currency as Crypto or Fiat.

Data Type: enum
Display: 0: Crypto | Other: Fiat

Primary

Shows whether the row is marked as the primary currency.

Data Type: boolean
Display: True: Yes success pill | False: No warning pill

Status

Shows whether the currency is currently active and doubles as the clickable quick toggle.

Data Type: boolean
Display: True: Active success pill | False: Disabled warning pill
Side Effects: Clicking the pill immediately sends the inverted active state to the backend., There is no confirmation dialog before the status update.

Actions

Opens the edit workspace for the selected currency.

Data Type: action-group

More help

Currencies

Operator guide for currency inventory, create flow, and edit workspace.

Currencies / Detail

Saved currency edit workspace for one currency, including staged icon upload, asset selection, and rate maintenance.

Currencies / Form

Create workspace for one currency record, including code-driven type suggestion, rate inputs, and create-time marketing-ratio caveats.

Activity Tag Rules / List

Main inventory for activity-driven tag rules, with search, activity and status filters, grouped rows, clone, edit, and run actions.

Affiliate Deals / List

Searchable table of affiliate deal rows with PID filter, create action, dashboard shortcut, and edit/delete row actions.

Affiliate Payment Settings / List

Affiliate payment settings inventory page for reviewing configured rows and opening saved records.