Operator guideEN

NX / Offers / Detail

Record-level workspace for one NX offer, including status, activation, budget, and bonus settings.

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 does

This page opens one NX offer definition for configuration. Operators use it to update the saved name/status, choose activation behavior, and maintain type-specific settings.

Saving a value confirms that it is stored. It does not currently prove that every setting is enforced when an issued offer is claimed or activated. Read the runtime limits below before using an offer in a live campaign.

Header and basic fields

  • The header shows the current offer name and a Save button.
  • Type is shown as a read-only label. It controls which Settings tab fields are available.
  • Offer Name and Offer Status are intended to be disabled after issued offers exist. The current count wiring does not reliably enforce that guard, so check the list count first.

Activation tab

Activation Type controls which activation path is saved.

  • Automatic is visible but currently returns a not-implemented result. Do not use it for a live offer.
  • Deposit returns a deposit result linked to the claimed offer.
  • Deposit Minimal Amount and Deposit Maximal Amount can be saved, but the current deposit activator does not read or enforce those values. Treat them as stored configuration, not as a proven deposit eligibility check.

Matrix-style rows can be entered by country and currency. Current runtime resolution does not fully resolve those dimensions and uses a fixed EUR lookup in the available settings classes, so do not assume that non-EUR or country-specific rows are applied.

Settings tab

The Settings tab starts with Offer Default Budget, then shows fields based on the offer type:

  • Percentage bonus offers can configure bonus percentage, wagering percentage, minimum/maximum bet, maximum win threshold, minimum balance threshold, and balance distribution settings.
  • Amount bonus offers can configure bonus amount, wagering amount, minimum/maximum bet, maximum win threshold, minimum balance threshold, and balance distribution settings.
  • Group offers expose Group Type with Issue All or Issue in Order options in the current interface.

Current runtime limits:

  • The saved settings use page module names that do not match the module names expected by the available runtime settings resolver.
  • Percentage runtime getters currently look for amount-style keys instead of the percentage keys saved by this page.
  • Amount wagering is entered as one value on the page, while the available runtime getter expects a currency map.
  • Stored balance-distribution rows are not read; the available runtime classes return fixed cashLock = true and cashUseCoefficient = 1 values.
  • The current issued-offer resolver supports Percentage Bonus and Amount Bonus, but rejects Group offers.

Save behavior

Clicking Save sends the current basic fields and all non-empty activation/type settings. The save runs as one transaction: it updates the offer row, deletes all previous settings for that offer, and creates the submitted settings again. If any step fails, the transaction rolls back.

Clearing a setting removes it from the submitted settings collection, so the next successful Save removes the previously stored row. The page heading changes to the typed offer name immediately when Save is clicked, before persistence is confirmed; reload the page when confirmation is ambiguous.

Known caveats

  • The page intends to disable editable controls after issued offers exist, but the detail response and page currently use different names for that count. Do not treat enabled controls as proof that no issued offers exist.
  • The save service does not independently block updates when issued offers exist. Check Issued Offers from the list before editing an offer that may already be in use.
  • Empty setting values are filtered out before submit; clearing a setting removes it from the saved settings payload.
  • Currency/country matrix fields are stored configuration rows; their current runtime dimension resolution is incomplete.
  • Save failure feedback is not reliable enough to use as the only proof of persistence. Reload and recheck the values after an ambiguous notification.
  • Automatic and Group are visible configuration choices but are not usable live paths in the currently verified product flow.
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.

Calculations5 topicsOpen details

Issued-offer edit lock

Logic
The detail source counts issued instances for the offer., The page intends to disable editable controls when that count is greater than zero., The response and page currently use different names for the count, so the lock may not activate., The save service does not independently enforce the issued-offer lock.

Activation-specific settings

Logic
The page filters settings whose module belongs to the selected activation type., Deposit activation exposes deposit minimum and maximum amount settings., Automatic activation returns a not-implemented result., Deposit activation returns a deposit result but does not read the configured amount limits.

Offer-type-specific settings

Logic
The page filters settings whose module belongs to the current offer type., Percentage and amount bonus fields can be stored, but the current claim/activation path does not prove that each value is applied., Group settings are visible, but the current issued-offer resolver rejects Group offers.

Settings save replacement

Logic
On Save, the offer row is updated., Existing settings for the offer are deleted., Submitted non-empty settings are created again in the same transaction., Any failure rolls back the offer-row and settings changes together.

Runtime settings resolution gaps

Logic
The page saves type modules with an `offerType` prefix, while the available runtime settings resolver expects an `offer_type` prefix., Percentage getters read amount-style keys instead of the percentage keys saved by the page., Amount wagering is edited as one value while its available runtime getter expects a currency map., Matrix and dimension resolution is marked as temporary placeholder logic and currently uses a fixed EUR lookup., Stored balance-distribution settings are ignored in favor of fixed runtime values.
Fields21 topicsOpen details

Offer title

Header text for the current offer.

Data Type
string

Type

Read-only type label for the offer; it controls which Settings tab fields are available.

Data Type
enum
Allowed Values
0: Label: Percentage Bonus | Value: percentage_bonus_v1 | 1: Label: Amount Bonus | Value: amount_bonus_v1 | 2: Label: Group | Value: group_v1
Caveats
Group is visible in settings, but the current issued-offer resolver rejects Group offers.

Offer Name

Editable offer name.

Data Type
string
Disabled When
The offer already has issued offer instances.
Caveats
The current issued-count field mismatch can prevent this page guard from activating.

Offer Status

Active/disabled state of the offer definition.

Data Type
status
Allowed Values
0: Label: Active | Value: active | 1: Label: Disabled | Value: disabled
Disabled When
The offer already has issued offer instances.
Caveats
The current issued-count field mismatch can prevent this page guard from activating.

Issued Offers Count

Number of issued offer instances linked to this offer.

Data Type
integer
Calculation
Counts issued offer instances linked to the current offer ID.
Caveats
The current detail response returns this count under a different field name than the page expects, so the edit lock may not activate.

Activation

Tab containing activation type and activation-specific settings.

Data Type
tab

Settings

Tab containing default budget and offer-type-specific settings.

Data Type
tab

Activation Type

Determines how an issued offer moves into activation.

Data Type
enum
Allowed Values
0: Label: Automatic | Value: auto | 1: Label: Deposit | Value: deposit_v1
Caveats
Automatic activation currently returns a not-implemented result and must not be used for a live offer., Deposit activation returns a deposit result, but its current activator does not read the configured deposit amount limits.

Deposit Minimal Amount

Deposit amount floor for deposit-activated offers, optionally split by country and currency.

Data Type
matrix_currency_country
Visible When
Activation Type is `Deposit`.
Caveats
The value is stored, but no current runtime reader or enforcement was found for this field.

Deposit Maximal Amount

Deposit amount ceiling for deposit-activated offers, optionally split by country and currency.

Data Type
matrix_currency_country
Visible When
Activation Type is `Deposit`.
Caveats
The value is stored, but no current runtime reader or enforcement was found for this field.

Offer Default Budget

Saved per-currency budget map for the offer, edited through a currency modal.

Data Type
currency_map
Caveats
The value is persisted on the offer row, but no current runtime consumer was found. Do not treat it as an enforced spend cap without separate verification.

Bonus Percentage

Percentage bonus value for percentage-bonus offers.

Data Type
matrix_number
Visible When
Type is `Percentage Bonus`.
Caveats
The page saves `bonusPercentage`, while the available runtime getter currently reads an amount-style key. Runtime application is not proven.

Bonus Wagering Percentage

Wagering requirement percentage for percentage-bonus offers.

Data Type
matrix_number
Visible When
Type is `Percentage Bonus`.
Caveats
The page saves `bonusWageringPercentage`, while the available runtime getter currently reads an amount-style key. Runtime application is not proven.

Bonus Amount

Fixed bonus amount for amount-bonus offers.

Data Type
matrix_currency_country
Visible When
Type is `Amount Bonus`.
Caveats
The value is stored as a currency/country matrix, but current runtime dimension resolution is incomplete and uses a fixed EUR lookup.

Bonus Wagering Amount

Wagering requirement amount for amount-bonus offers.

Data Type
number
Visible When
Type is `Amount Bonus`.
Caveats
The page edits one numeric value, while the available runtime getter expects a currency map. Runtime application is not proven.

Bonus Minimal Bet

Minimum bet allowed for bonus usage.

Data Type
matrix_currency_country
Visible When
Type is `Percentage Bonus` or `Amount Bonus`.
Caveats
The setting is stored, but current runtime dimension resolution is incomplete and uses a fixed EUR lookup.

Bonus Maximal Bet

Maximum bet allowed for bonus usage.

Data Type
matrix_currency_country
Visible When
Type is `Percentage Bonus` or `Amount Bonus`.
Caveats
The setting is stored, but current runtime dimension resolution is incomplete and uses a fixed EUR lookup.

Bonus Maximal Win Threshold

Maximum win threshold configured for bonus handling.

Data Type
matrix_currency_country
Visible When
Type is `Percentage Bonus` or `Amount Bonus`.
Caveats
The setting is stored, but current runtime dimension resolution is incomplete and uses a fixed EUR lookup.

Bonus Minimal Balance Threshold

Minimum balance threshold configured for bonus handling.

Data Type
matrix_currency_country
Visible When
Type is `Percentage Bonus` or `Amount Bonus`.
Caveats
The setting is stored, but current runtime dimension resolution is incomplete and uses a fixed EUR lookup.

Bonus Balance Distribution Settings

Balance distribution setting map shown for bonus offers.

Data Type
matrix_currency_country
Visible When
Type is `Percentage Bonus` or `Amount Bonus`.
Caveats
The available runtime classes ignore the stored row and return fixed `cashLock = true` and `cashUseCoefficient = 1` behavior.

Group Type

Saved Group-offer issuing choice shown by the page.

Data Type
enum
Allowed Values
0: Label: Issue All | Value: issue_all | 1: Label: Issue in Order | Value: issue_in_order
Visible When
Type is `Group`.
Caveats
The current issued-offer resolver rejects Group offers. Do not use this setting for a live campaign.
More help

Related pages

NX / Offers

Operator guide for NX offer list and offer detail surfaces.

NX / Offers / List

Offer grid with filters, create flow, row navigation, and issued-offer count.

Activity Tag Rules / Detail

Rule inspection page with stored identity, conditions, timestamps, impact estimate, run action, delete action, and recent application history.

Affiliate Payment Settings / Detail

Detail/edit shell for one saved affiliate payment-setting record.

Affiliate Settings / Detail

Saved affiliate detail workspace for reviewing one affiliate and opening report actions.

Auto Tags Manager / Detail

Edit surface for one existing auto-tag rule, using the same dynamic rule builder as create but with a persisted rule payload and ID-backed updates.