Operator guideEN

Payment Methods / Form

Full create and edit flow for payment methods, including normal form mode, JSON mode, logo upload, geo/currency restrictions, amount rules, and crypto-specific toggles.

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

The form creates or updates one payment-method record. It is used for both simple provider rows and more complex card or crypto flows.

Operators can work in two modes:

  • regular form mode
  • JSON mode for direct structured editing

The same shared modal is also used for four operator entry points:

  • Add Method
  • Edit Payment Method
  • Create Group
  • Edit Payment Group

Group mode is still the same payload editor, but it starts from a different default state and is aimed at parent/group rows instead of standalone methods.

When to use it

  • add a new provider or method variant
  • change display titles or descriptions
  • switch a method on or off
  • set country, currency, email, or traffic restrictions
  • configure card or crypto-specific behavior
  • upload or replace the method logo
  • create or maintain a payment group that other rows can attach to through Parent Group

How to read it

The form is easiest to think about in sections:

  • identity: name, provider, title resource key, raw title, description resource key
  • core status: active, hidden, withdrawal enabled, bonus flag
  • method type: bank, email, card, crypto, payment-group behavior, network behavior
  • limits and defaults: default amount, bottom-amount helper text, EUR limits, and per-currency ranges
  • targeting: country, currency, email, and traffic restrictions
  • copy blocks: deposit and withdrawal text blocks used by player-side payment UX

What usually confuses operators

JSON mode is powerful but bypasses the grouped form layout

JSON mode is useful for advanced edits or structure review. It should be used carefully because it exposes the raw payload that will be saved. The modal also exposes helper actions to format, copy, download, upload, and re-apply JSON back into grouped form mode.

The screen does not save invalid JSON. Apply & Switch to Form is blocked until the JSON parses successfully.

Title and Description are resource keys, not plain content fields

The visible labels are Title (key from Resources) and Description (key from Resources). Operators should enter resource keys that map to translation resources, not long free-text copy.

Payment groups are configured from the same modal

The same create/edit surface is also used for Create New Group and Edit Payment Group. The Is Payment Group switch changes the row into a parent/group record and affects how child rows use the Parent field.

Create Group starts from group-oriented defaults:

  • isCrypto: true
  • name: new-group
  • rawTitle: New Group
  • title: New Payment Group
  • isActive: true

Card and crypto toggles unlock extra fields

Options such as saved-card behavior or QR/static-network behavior matter only when the corresponding form type is enabled.

Traffic flags are not the same thing

  • Allowed Traffic Type controls broad traffic targeting
  • Trusted Only narrows to trusted traffic
  • Affiliate Only narrows to affiliate-attributed traffic

The screen also forces Trusted Only off for some traffic selections and disables it for traffic modes where the combination is not allowed.

GatewayCrypto static QR flags affect player payment flow

GatewayCrypto static QR flow and GatewayCrypto QR as next step are configuration flags for GatewayCrypto rows. When enabled on the intended GatewayCrypto method, they change how the player-facing crypto QR step is presented downstream. Do not use these flags as generic crypto switches for unrelated methods.

Known caveats

  • Do not treat name + paymentMethod as the unique identity. Stable identity is the saved payment row/id, and similar names can exist for different targeting, country, currency, or traffic contexts.
  • Screen validation only hard-requires Name. The modal does not require Payment Method, Title, or Description before save.
  • The list page, not the form page, owns delete.
  • Some numeric fields allow blank values, which the hook converts to null before submit.
  • Gateway Crypto Static QR Next Step can be auto-enabled when Gateway Crypto Static QR Flow is enabled for the gatewaycrypto method name.
  • Traffic Type can forcibly clear and disable Trusted Only for combinations the screen does not allow.
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.

Fields42 topicsOpen details

Name

Internal method identifier. This is the only field the screen hard-requires before save.

Group
identity
Data Type
string

Payment Method

Provider or method code paired with the internal name for routing and maintenance. It is not screen-required, and stable identity is the saved payment row/id.

Group
identity
Data Type
string

Title

Resource key used for the display title. The screen labels this field as `Title (key from Resources)`.

Group
identity
Data Type
string

Raw Title

Raw grouping title often used for provider-family naming.

Group
identity
Data Type
string

Description

Resource key used for the display description. The screen labels this field as `Description (key from Resources)`.

Group
identity
Data Type
string

Active

Enables the method in the catalog.

Group
status
Data Type
boolean

Hidden

Hides the method without making it identical to inactive.

Group
status
Data Type
boolean

Withdrawal Enabled

Allows the method to appear on withdrawal flows.

Group
status
Data Type
boolean

Bonus

Marks whether the method participates in bonus-enabled flows.

Group
status
Data Type
boolean

Bank

Marks the method as bank-based.

Group
method-type
Data Type
boolean

Bank Form (Withdrawal Only)

Shows the bank-form variant only on withdrawal flows while leaving deposit behavior unchanged.

Group
method-type
Data Type
boolean

Email

Marks the method as email-based.

Group
method-type
Data Type
boolean

Card Form

Enables card-form behavior and saved-card sub-options.

Group
method-type
Data Type
boolean

Saved Cards (Deposit)

Allows saved-card reuse on deposits.

Group
method-type
Data Type
boolean

Saved Cards (Withdrawal)

Allows saved-card reuse on withdrawals.

Group
method-type
Data Type
boolean

Require Deposit For Withdrawal

Requires an earlier deposit before using this method for withdrawal.

Group
method-type
Data Type
boolean

Crypto Form

Enables crypto-specific inputs and QR/network options.

Group
method-type
Data Type
boolean

Currency

Default crypto currency code when the method is crypto-related.

Group
crypto
Data Type
string

Is Crypto Network

Marks the row as a concrete crypto-network option.

Group
crypto
Data Type
boolean

Parent Group

Parent group title used when the row belongs to a payment group.

Group
crypto
Data Type
string

Is Payment Group

Marks the row as a parent/grouping record edited through the same modal as normal payment methods. `Create Group` opens the form with this already enabled.

Group
crypto
Data Type
boolean

Default Amount

Default amount suggested in the payment flow.

Group
limits
Data Type
string

Text Bottom Amount

Helper text shown under amount controls for integrations that display a bottom-amount note.

Group
limits
Data Type
string

Min Deposit EUR

EUR-denominated minimum deposit value.

Group
limits
Data Type
amount

Max Deposit EUR

EUR-denominated maximum deposit value.

Group
limits
Data Type
amount

Min Withdraw EUR

EUR-denominated minimum withdrawal value.

Group
limits
Data Type
amount

Max Withdraw EUR

EUR-denominated maximum withdrawal value.

Group
limits
Data Type
amount

Currency Ranges

Per-currency override for min/max deposit and withdrawal values.

Group
limits
Data Type
object-list

Allowed Countries

Explicit country allowlist.

Group
targeting
Data Type
string-list

Restricted Countries

Explicit country denylist.

Group
targeting
Data Type
string-list

Allowed Currencies

Explicit currency allowlist.

Group
targeting
Data Type
string-list

Restricted Currencies

Explicit currency denylist.

Group
targeting
Data Type
string-list

Allowed Emails

Email-level allowlist used for restricted rollout cases.

Group
targeting
Data Type
string-list

Allowed Traffic Type

Traffic segment rule such as FTD-only or repeated-only.

Group
targeting
Data Type
enum

Trusted Only

Restricts the method to trusted traffic only. The screen disables and clears it for traffic modes where the combination is not allowed.

Group
targeting
Data Type
boolean

Affiliate Only

Restricts the method to affiliate-attributed traffic only.

Group
targeting
Data Type
boolean

Thumbnail

Logo or icon uploaded for the method.

Group
assets
Data Type
asset-url

Deposit Text Block

Deposit-side text block rendered by integrations that support custom payment copy.

Group
copy
Data Type
string

Withdrawal Text Block

Withdrawal-side text block rendered by integrations that support custom payment copy.

Group
copy
Data Type
string

Auto Detect Network

Lets the crypto flow detect network automatically when supported.

Group
crypto
Data Type
boolean

GatewayCrypto static QR flow

Enables the downstream static QR flow for supported GatewayCrypto integrations.

Group
crypto
Data Type
boolean
Caveats
Intended for the `gatewaycrypto` method family, not as a generic crypto-method switch.

GatewayCrypto QR as next step

Shows the GatewayCrypto QR as the next inline payment step when paired with static QR flow.

Group
crypto
Data Type
boolean
Caveats
The screen auto-enables this when static QR flow is enabled for a method named `gatewaycrypto`.
More help

Related pages

Configuration / Payment Methods

Operator guide for the internal payment-method catalog, the create/edit flow, and the player-facing ordering tools used in backoffice.

Configuration / Payment Methods Order

Preview score-based deposit-method ranking and manage manual country, traffic, and FTD overrides.

Payment Methods / List

Filterable catalog view for payment methods, provider variants, top-level status cards, and quick actions such as create, edit, delete, JSON import/export, and global order save.

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.