Operator guideENsettingsaffiliatespaymentsform

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.

Reader view

Clean portal guidance

This page keeps the operator explanation, field and action descriptions, and screenshots visible without exposing repo paths, raw sidecars, or editorial-only implementation details.

Narrative content

Page body

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 defines the minimum EUR deposit threshold for the record.
  • Active controls whether the setting is currently used.
  • PIDs is a free-solo chip input for affiliate-link payload values.

Important caveats

  • The current FE does not expose an Affiliate Keys input even though the backend model and services support 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 backend detail route. 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.
Calculation notes

Calculations

calculation

Edit bootstrap from list

Verification
verified_backend
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.
calculation

Create versus edit submit

Verification
verified_backend
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.
calculation

Min deposit number cast

Verification
verified_fe_only
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)`.
calculation

Hidden affiliate-keys gap

Verification
verified_backend
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.
calculation

PID free-solo chips

Verification
verified_fe_only
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.
Field dictionary

Fields

field

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.
field

Min Deposit EUR

Minimum deposit threshold in EUR 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`.
field

Active

Whether this setting is currently applied to deposits.

Data Type
boolean
Editable
true
Caveats
The helper text states `If disabled, this setting will not be applied to deposits`.
field

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.
field

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.
Operational notes

Notes

item

The edit form does not call the dedicated backend detail route directly. It loads the list endpoint with `limit: 1000` and resolves the target record in memory.

item

Create calls `POST /api/admin/affiliate-payment-settings`; edit calls `PUT /api/admin/affiliate-payment-settings/:id`.

item

Backend services support `affiliateKeys`, but the current FE form does not render any visible `Affiliate Keys` control.

item

The model stores `affiliateKeys` and `pid` as JSONB arrays and `minDepositEur` as `DECIMAL(18,2)`.

Related references

Related pages

pageAffiliate Payment Settings

Operator documentation for the affiliate payment configuration workspace, including payment settings and sending-window tabs.

pageAffiliate Payment Settings / Detail

Saved affiliate payment-setting detail page for reviewing one configured record.

pageAffiliate Payment Settings / List

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

pageAffiliate Deals / Dashboard

Deal-period performance report that combines traffic, deposit, GGR, NGR, payout, and ROI metrics for affiliate deals.

pageAffiliate Deals / Form

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

pageAffiliate Deals / List

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