Operator guideEN

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.

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

This surface creates or edits one affiliate payment-setting record. The current FE lets the operator define:

a human-readable Name
a minimum deposit threshold in EUR
whether the setting is Active
a free-form list of PIDs from the affiliate-link payload

Route modes

/settings/affiliate-payment-settings/create opens create mode
/settings/affiliate-payment-settings/[id] opens edit mode

What operators actually manage here

Name identifies the setting in the affiliate payment-settings inventory.
Min Deposit EUR stores the intended minimum EUR deposit threshold for the record.
Active marks the saved record as enabled for a runtime consumer.
PIDs is a free-solo chip input for affiliate-link payload values.

Important caveats

The current form does not expose an Affiliate Keys input even though the saved record supports affiliateKeys.
Create and edit both submit through the same visible field set; edit changes only the submit label and success message.
The edit screen does not bootstrap from the dedicated single-record read endpoint. It loads the full settings list with limit: 1000 and then finds the target record locally by id.
Cancel and the top-left back icon both return to /settings/affiliate-payment-settings.
Persistence is verified, but live deposit-flow enforcement is not verified. Do not promise that changing this value changes a player's first-deposit minimum until that flow is tested and its runtime consumer is confirmed.

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

Edit bootstrap from list

Logic: The edit screen does not fetch `/api/admin/affiliate-payment-settings/:id` directly., If the target record is not yet present while the list is still loading, the FE shows a centered spinner.

Create versus edit submit

Logic: Create submits `POST /api/admin/affiliate-payment-settings`., Edit submits `PUT /api/admin/affiliate-payment-settings/:id`., On success, both routes navigate back to `/settings/affiliate-payment-settings` and show a success snackbar.

Min deposit number cast

Logic: The FE keeps `minDepositEur` in local form state as either `''` or a number while typing., Submit always casts the payload value through `Number(values.minDepositEur)`.

Hidden affiliate-keys gap

Logic: Backend create and update services both accept `affiliateKeys`., The current FE form initializes `affiliateKeys` state and computes `takenAffiliateKeys`, but renders no visible `Affiliate Keys` field., This is a real FE-to-backend surface gap, not a missing docs field.

PID free-solo chips

Logic: `PIDs` uses a free-solo multi-select with no predefined options., Every entered value is normalized to `String(...)` before it is stored in form state.

Fields5 topicsOpen details

Name

Human-readable setting name shown in the inventory and used to identify the rule.

Data Type: string
Editable: true
Caveats: Required in both create and edit mode., FE enforces a maximum length of 255 characters.

Min Deposit EUR

Intended minimum deposit threshold in EUR stored for this affiliate payment setting.

Data Type: decimal
Editable: true
Caveats: Rendered as a numeric input with a euro prefix., FE allows empty temporary input state while typing, but submit converts the value to `Number(...)`., FE helper text says `Minimum deposit amount in EUR`., Live deposit-flow enforcement of this stored value is not verified.

Active

Marks the record active for any runtime consumer that reads this configuration.

Data Type: boolean
Editable: true
Caveats: The helper text states `If disabled, this setting will not be applied to deposits`., Active persistence is verified; deposit-flow enforcement remains unverified.

PIDs

Free-form PID values from the affiliate-link payload that this setting applies to.

Data Type: string[]
Editable: true
Caveats: Rendered as a free-solo multi-chip input with no predefined options., The FE stores every entered chip as a string.

Affiliate Keys

Backend-supported array field that is not currently exposed on the visible FE form.

Data Type: string[]
Editable: false
Caveats: The FE initializes and preserves `affiliateKeys` state internally but provides no visible selector or editor., New records therefore submit `affiliateKeys: []`, and edits keep the locally bootstrapped value only if it was present in the loaded list payload.

More help

Affiliate Payment Settings / Detail

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

Affiliate Payment Settings / List

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

Affiliates / Affiliates Config

Configure PID-targeted payment-setting records and affiliate event sending windows.

Affiliate Deals / Dashboard

Affiliate deal cohort report that period-bounds registrations, then combines the selected players with cumulative deposit and linked-event values.

Affiliate Deals / Form

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

Affiliate Deals / List

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