Operator guideEN

Currencies / Form

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

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 form does

This page creates one new currency record.

Visible fields

  • Currency Name
  • Currency Code
  • Currency Symbol
  • Exchange Rate
  • MRKTG Ratio to EUR
  • Loyalty Point
  • Currency Type

Important behavior

Currency Code is uppercased in the form

The form forces uppercase while the operator types, and the saved record is normalized the same way. Operators should enter the standard three-letter currency code.

Currency Type is suggested from the loaded currency lookup

The page checks the existing currency lookup. When the entered code matches a known lookup key, the form switches the type to Crypto or Fiat automatically.

The selector is visible but disabled. Operators can review the suggested type, but they cannot manually override it from this create form. Editing the code can re-apply the lookup result.

MRKTG Ratio to EUR has an operator-facing meaning

The helper caption in the form says this value affects bonus and bet-limit amounts. It is not just a duplicate of exchange rate.

Create-time caveat: new records should not be treated as having the MRKTG Ratio to EUR value entered on this create form. Set or correct the marketing ratio on the saved-record detail screen before relying on it for bonus or bet-limit configuration.

Validation is stricter than the labels alone suggest

The form validates Currency Name, Currency Code, Currency Symbol, Exchange Rate, Loyalty Point, and Currency Type before submit. The save flow also rejects duplicate currency codes. Currency Code must end up as a three-letter code and is uppercased before it is saved.

There is no icon workflow on create

Icon upload and asset selection exist only on the saved-record detail screen. The create page is limited to the core identity, rate, and type fields.

Save flow

Create saves the currency, resets the form, shows a success toast, and returns to the previous page. Cancel returns to the previous page without saving.

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.

Calculations7 topicsOpen details

Currency code normalization

Logic
FE uppercases Currency Code while the operator types., The type lookup also uppercases the code before checking the crypto lookup., Backend uppercases code again before saving the created currency.

Currency type suggestion

Logic
The create form requests the currencies list with a large limit to read the isCurrenciesCrypto lookup., When the uppercase code exists in the lookup and its value is true, FE sets type to Crypto., When the uppercase code exists in the lookup and its value is false, FE sets type to Fiat., When the code is missing from the lookup, FE sets type to Fiat., The visible Currency Type selector is disabled, so the operator can review but not manually override it from this form.

Submit payload casting

Logic
Before submit, FE casts exchangeRate to a string., Before submit, FE casts marketingRatio to a string., Before submit, FE casts loyaltyPoint to a string., The backend create flow validates its accepted fields after request parsing.

Create validation

Logic
FE validates Currency Name, Currency Code, Currency Symbol, Exchange Rate, Loyalty Point, and Currency Type., Backend validates name, code, exchangeRate, symbol, type, and loyaltyPoint., Backend rejects duplicate currency codes before create., Backend creates the row inside a transaction.

Marketing ratio create caveat

Logic
FE renders MRKTG Ratio to EUR and sends marketingRatio on submit., The verified FE create schema does not define an explicit marketingRatio validation rule., Backend argument filtering uses the create constraints and removes marketingRatio before create logic reads the sanitized payload., The currency model default for marketingRatio is 0 when create does not accept a value., The saved-record update flow includes marketingRatio in its constraints and persists it from the detail screen.

Cancel flow

Logic
Cancel calls router back navigation., Cancel does not submit the form., No backend create request is sent when the operator cancels.

Create success flow

Logic
On successful backend response, FE resets the form., FE shows a Currency created success toast., FE clears submitting state., FE returns the operator to the previous page.
Fields7 topicsOpen details

Currency Name

Display name saved for the new currency record.

Group
identity
Data Type
string
Validation
Frontend: Required., Letters and spaces only., Minimum 3 characters., Maximum 50 characters. | Backend: Required., Letters and spaces only., Minimum 3 characters., Maximum 50 characters.

Currency Code

Three-letter currency code used to identify the currency.

Group
identity
Data Type
string
Validation
Frontend: Required., Letters and spaces according to the visible FE schema., Maximum 3 characters., Uppercased while typing. | Backend: Required., Exactly 3 characters., Letters only., Must not duplicate an existing currency code.
Caveats
The FE uppercases the value while the operator types., The backend uppercases the saved code again during create., Backend duplicate-code validation rejects an already configured code.

Currency Symbol

Visible currency symbol used in formatting.

Group
identity
Data Type
string
Validation
Frontend: Required., Maximum 5 characters. | Backend: Required.

Exchange Rate

Stored exchange-rate value for the currency.

Group
rates
Data Type
number
Validation
Frontend: Required., Must be a number., Must be positive. | Backend: Required., Numeric-looking string., Length 1 to 10.
Submit Transform
FE stringifies this value before calling the create endpoint.

MRKTG Ratio to EUR

Marketing ratio used by other CRM flows when amount conversion relies on marketing-rate logic instead of pure exchange rate.

Group
rates
Data Type
number
Caveats
The FE helper text says this value affects bonus and bet-limit amounts., The FE sends this field on create, but backend create input filtering removes it because `marketingRatio` is not in the create constraints., New rows use the currency model default when create does not accept a marketing-ratio value., Set or correct this value on the saved-record detail screen, where the update flow accepts `marketingRatio`.
Validation
Frontend: No explicit FE schema rule found in the verified create schema. | Backend: No explicit create constraint exists for this field, so create input filtering removes it., The saved-record update flow accepts this field.
Submit Transform
FE stringifies this value before calling the create endpoint.

Loyalty Point

Loyalty-point value saved with the currency.

Group
rates
Data Type
number
Validation
Frontend: Required., Must be a number., Must be positive. | Backend: Required., Numeric-looking string.
Submit Transform
FE stringifies this value before calling the create endpoint.

Currency Type

Fiat/Crypto classification saved for the new currency.

Group
classification
Data Type
enum
Enum Values
Crypto, Fiat
Display
0: Crypto | 1: Fiat
Default
Fiat
Caveats
The FE auto-suggests the value from `isCurrenciesCrypto` when the entered code matches a known lookup entry., The visible selector is disabled in the verified create form, so operators can review the value but not manually override it here., Unknown codes default the visible type to Fiat.
More help

Related pages

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 / List

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

Affiliate Deals / Form

Create and edit form for affiliate deals, including PID, date window, commercial terms, and responsible person.

Affiliate Payment Settings / Form

Create and edit form for one affiliate payment-setting record, with visible PID targeting, minimum deposit threshold, and active-state control.

Auto Tags Manager / Create

Full rule-builder for a new automatic tagging rule, including priority, tag actions, coupon actions, KPI field selection, and draft impact estimation.