accounts configuration node contains all the settings required for managing user accounts in the online shop.
It defines how customers register, log in and stay logged in, and which data they can view or edit in their customer account. In addition, it contains security-relevant parameters such as password checks, login blocks, auto-login rules, and the management of payment and address data.
This configuration lets you tailor the behaviour of the customer account to the requirements of your shop — from a simple sign-in to fine-grained control of permissions and data fields.
accounts* - Basic structure
The basic structure of the accounts node is shown below:
Parameter descriptions
accounts.account - User account
Controls the central account settings for customers. Here you define security checks, password rules, login protection mechanisms and other account functions.
This configuration influences how customer accounts are created, used to sign in and managed in the shop.
The settings for this section can be found in the Admin Interface under Einstellungen → Shop-Konfiguration → Gruppe „Login & Anmeldung".
You can open this setting directly in the Admin Interface via the following link: https://<shop-domain>/admin/config/accounts.account (Deeplink overview)
Example configuration for all subshops (accounts.account)
Parameter descriptions
New customer rules (newCustomerRules)
newCustomerRules defines when a logged-in customer is considered a new customer during the order process. The customer type newCustomer determined this way is evaluated by the payment method validation paymentValidation.accountType — for example, to block purchase on invoice for new customers.
Each rule consists of a field and a condition. If the condition of a rule applies, the customer is not considered a new customer. Only when none of the rules applies is the customer classified as a new customer.
Example configuration (accounts.account.newCustomerRules)
A customer counts as a new customer as long as no customer number has been assigned yet:
Parameter overview
The customer type is determined during the login within the order process based on these rules (
newCustomer or customer). A new registration during the order process always leads to the customer type newCustomer, regardless of the rules. Guest orderers have the customer type guest.accounts.accountRestrictions - Subshop restrictions for user accounts
Restricts the availability of customer accounts to defined subshops, for example to make B2B accounts available only in a country-specific shop, or to provide exclusive areas per tenant or region.
The settings for this section can be found in the Admin Interface under Einstellungen → Shop-Konfiguration → Gruppe „Login & Anmeldung".
You can open this setting directly in the Admin Interface via the following link: https://<shop-domain>/admin/config/accounts.accountRestrictions (Deeplink overview)
Example configuration for all subshops (accounts.accountRestrictions)
Parameter descriptions
accounts.addressFieldsSettings - Custom address field settings
Controls the central configuration of address fields in the shop. Here you can define custom labels, default values, visibility and read-only rules for billing and delivery addresses.
The settings for this section can be found in the Admin Interface under Einstellungen → Shop-Konfiguration → Gruppe „Adressdaten".
You can open this setting directly in the Admin Interface via the following link: https://<shop-domain>/admin/config/accounts.addressFieldsSettings (Deeplink overview)
Example configuration for all subshops (accounts.addressFieldsSettings)
Parameter overview
Condition-dependent definitions (
customLabelsDefinition & defaultValuesDefinition)
The definitions defaultValuesDefinition and customLabelsDefinition allow you to define default values and custom field labels for address fields based on certain conditions.
Both definitions follow the same structure and support a conditions array that can be used to tie the application of the rule to field conditions.
Structure of an entry
Structure of a condition
Example for
customLabelsDefinition
Custom field labels that are displayed depending on conditions.
accounts.addressField.firstName field in the billing address is labelled “Vorname (Rechnung)” — but only if the country is set to DE. In the second entry, the accounts.addressField.firma field in the delivery address gets the label “Firma (Lieferung)” as soon as the accounts.addressField.country field contains any value (type: "filled").
Example for defaultValuesDefinition
Default values for address fields, also pre-filled based on conditions.
accounts.addressField.country field in the billing address is unconditionally pre-filled with "DE". In the second entry, the salutation of the delivery address (accounts.addressField.salutation) is set to "Herr" only when the country is DE.
accounts.addressField - Define individual address fields
Controls the structure and properties of individual address fields in the shop. Validations allow inputs to be checked and formal requirements (e.g. required fields, format checks) to be defined.
The settings for this section can be found in the Admin Interface under Einstellungen → Shop-Konfiguration → Gruppe „Adressdaten".
You can open this setting directly in the Admin Interface via the following link: https://<shop-domain>/admin/config/accounts.addressField (Deeplink overview)
Example configuration for all subshops (accounts.addressField.firstName)
Parameter overview
accounts.autoLogin - Stay signed in
Controls the “stay signed in” behaviour (auto-login) for customer accounts: activation, expiration times and reactions to special cases.
The settings for this section can be found in the Admin Interface under Einstellungen → Shop-Konfiguration → Gruppe „Login & Anmeldung".
You can open this setting directly in the Admin Interface via the following link: https://<shop-domain>/admin/config/accounts.autoLogin (Deeplink overview)
Example configuration for all subshops (accounts.autoLogin)
Parameter description
accounts.bankInfoField - Bank details
Allows recording and managing bank details in the customer account. Unlike credit card data, this information can be entered, changed and stored directly in the shop.
The stored bank details are then available for selection during the order process — in particular for the SEPA direct debit payment method.
You can open this setting directly in the Admin Interface via the following link: https://<shop-domain>/admin/config/accounts.bankInfoField (Deeplink overview)
Example configuration for all subshops (accounts.bankInfoField.owner)
Parameter description
accounts.creditCardField - Credit cards
For security reasons, payment by credit card is handled exclusively through external Payment Service Providers (PSP).
Entering credit card data, detecting the card type and carrying out the 3D Secure 2.0 procedure all take place entirely at the payment provider. Real credit card data is never stored or processed in the online shop.
In the customer account, pseudonymised credit card information can be displayed — provided this is supported by the PSP and contractually enabled. This allows customers to conveniently choose a stored card the next time they make a purchase without having to enter the data again. Entering or changing credit card data directly in the shop is not possible.
You can open this setting directly in the Admin Interface via the following link: https://<shop-domain>/admin/config/accounts.creditCardField (Deeplink overview)
Example configuration for all subshops (accounts.creditCardField.holder)
Parameter description
accounts.customAddressField - Additional address data fields
Allows you to define additional address fields for billing and/or delivery addresses.
These fields supplement the standard entries (e.g. name, street, postal code, city, country, telephone) with custom input fields that are displayed and stored in the customer account or during checkout. Examples of typical additional fields are: address supplement, floor, PO box, packing station number or department.
You can open this setting directly in the Admin Interface via the following link: https://<shop-domain>/admin/config/accounts.customAddressField (Deeplink overview)
