accounts - Benutzerkonten

Konfiguration des accounts-Knotens: Benutzerkonten im WEBSALE Shop mit Registrierung, Login, Passwortregeln, Auto-Login sowie Adress- und Zahlungsdaten.

Der Konfigurationsknoten accounts umfasst alle nötigen Einstellungen rund um die Verwaltung von Benutzerkonten im Onlineshop.

Er definiert, wie sich Kundinnen und Kunden registrieren, anmelden, eingeloggt bleiben und welche Daten sie im Kundenkonto einsehen oder bearbeiten können. Darüber hinaus enthält er sicherheitsrelevante Parameter wie Passwortprüfungen, Login-Sperren, Auto-Login-Regeln sowie die Verwaltung von Zahlungs- und Adressdaten.

Über diese Konfiguration lässt sich das Verhalten des Kundenkontos individuell an die Anforderungen des Shops anpassen – von der einfachen Anmeldung bis zur detaillierten Steuerung von Berechtigungen und Datenfeldern.

---

​

accounts* - Grundstruktur

Nachfolgend der Grundaufbau des Knotens accounts:

{
    "accounts": {
      "account": {...},
      "accountRestrictions": {...},
      "addressFieldsSettings":{...},
      "addressField":{...},
      "autoLogin": {...},
      "bankInfoField": {...},
      "creditCardField": {...},
      "customAddressField": {...},
      "watchListField": {...}
    }
}

​

Parameterbeschreibungen

Parameter	Beschreibung
account	Steuert die zentralen Kontoeinstellungen für Kundinnen und Kunden, beispielsweise Sicherheitsprüfungen, Passwortregeln und Login-Schutzmechanismen.
accountRestrictions	Begrenzt die Verfügbarkeit von Kundenkonten auf definierte Subshops.
addressFieldsSettings	Steuert übergreifende Konfigurationen für Adressfelder, beispielsweise individuelle Beschriftungen, Standardwerte und Schreibschutzregeln.
addressField	Definiert Struktur und Validierungsregeln für einzelne Adressfelder.
autoLogin	Steuert das “Angemeldet bleiben”-Verhalten für Kundenkonten, inkl. Ablaufzeiten und Aktionsberechtigungen.
bankInfoField	Ermöglicht die Erfassung und Verwaltung von Bankdaten im Kundenkonto.
creditCardField	Konfiguriert die Anzeige pseudonymisierter Kreditkartendaten im Kundenkonto.
customAddressField	Ermöglicht die Definition zusätzlicher individueller Adressfelder für Rechnungs- und Lieferadressen.
watchListField	Definiert Felder der Merk- bzw. Beobachtungsliste mit eindeutiger ID und Namen. Diese Felder sind ausschließlich über die API ansprechbar und besitzen keine Konfigurationsmöglichkeit im Admin Interface.

---

​

accounts.account - Benutzerkonto

Steuert die zentralen Kontoeinstellungen für Kundinnen und Kunden. Hier werden Sicherheitsprüfungen, Passwortregeln, Login-Schutzmechanismen und weitere Kontofunktionen festgelegt.

Die Konfiguration beeinflusst das Verhalten beim Anlegen, Anmelden und Verwalten von Kundenkonten im Shop.

Die Einstellungen zu diesem Abschnitt befinden sich im Admin Interface unter .

​

Beispielkonfiguration für alle Subshops (accounts.account)

{
  "accountActivation": {
    "enabled": true,
    "requireOptIn": true
  },
  "additionalPasswordCheckLevels": [
    {
      "checks": [
        {
          "options": { "len": 8 },
          "service": "dataChecker.minLength"
        }
      ]
    },
    {
      "checks": [
        {
          "options": { "minChars": 1 },
          "service": "dataChecker.digitClass"
        },
        {
          "options": { "minChars": 1 },
          "service": "dataChecker.specialClass"
        }
      ]
    }
  ],
  "confirmationOfRegistrationEmail": {
    "fromAddress": "",
    "fromName": "",
    "subject": "",
    "template": ""
  },
  "duplicate": {
    "checkExistence": false,
    "keepAccount": true,
    "foundEmail": {
      "template": "",
      "subject": "",
      "fromAddress": "",
      "fromName": ""
    },
    "informFullAddress": true,
    "keepSignsInInformAddress": 3
  },
  "errorCodes": {
    "passwordResetRequired": "<Textbaustein>"
  },
  "login": {
    "ipBlockCount": 3,
    "ipBlockCountDuration": 1,
    "ipBlockDuration": 10,
    "ipBlockEnabled": true,
    "loginBlockCount": 5,
    "loginBlockDuration": 180,
    "loginBlockEmail": {
      "fromAddress": "[e-mail]",
      "fromName": "Mein Onlineshop",
      "subject": "Mein Onlineshop | Ihr Login wurde gesperrt",
      "template": "loginBlocked.htm"
    },
    "loginCountDuration": 60
  },
  "newCustomerRules": [
    {
      "field": "customerNumber",
      "type": "filled"
    }
  ],
  "passwordChecks": [
    {
      "options": { "len": 64 },
      "service": "dataChecker.maxLength"
    }
  ],
  "saveCreditCardData": false,
  "sendConfirmationOfRegistrationEmail": true,
  "subAccountsEnabled": false
}

​

Parameterbeschreibungen

Parameter	Typ	Beschreibung
accountActivation	object	Konfiguration für die Bestandskundenregistrierung. Ermöglicht die Aktivierung eines bereits im Shop angelegten Kundendatensatzes (beispielsweise per Import) über die Aktion AccountActivate. Das Konto gilt als noch nicht aktiviert, wenn: noch kein Passwort gesetzt ist, dem Account keine Mitarbeiterkonten zugeordnet sind oder bisher kein Einladungslink versendet wurde. Aus Sicherheitsgründen kann die Aktivierung nur einmal durchgeführt werden. Welche Felder bei der Bestandskundenregistrierung abgefragt werden, wird hierüber gesteuert.
enabled	bool	Aktiviert (true) bzw. deaktiviert (false) die Bestandskundenregistrierung.
requireOptIn	bool	Steuert, ob nach der Aktivierung eine Opt-In E-Mail an die hinterlegte Adresse versendet wird, die die Registrierung bestätigen muss. Default: true
additionalPasswordCheckLevels	list	Zusätzliche Prüfungen für Passwörter. Ermöglicht gestaffelte Sicherheitsanforderungen, etwa Mindestlänge oder bestimmte Zeichengruppen (Zahlen, Sonderzeichen).
checks	multiService	Liste von Prüfregeln innerhalb eines Levels; alle enthaltenen Checks müssen erfüllt sein.
service	string	Prüftyp (beispielsweise dataChecker.minLength, dataChecker.maxLength, dataChecker.digitClass, dataChecker.specialClass).
options	array	Optionsobjekt für den jeweiligen Prüftyp. Hier gibt es mehr Informationen zu den Validierungs- und Prüfservices.
confirmationOfRegistrationEmail	object	Konfiguration der Registrierungsbestätigungs-E-Mail. Wird nur genutzt, wenn sendConfirmationOfRegistrationEmail = true ist. Die E-Mail kann beispielsweise eine Möglichkeit zur Stornierung der Anfrage über einen Link enthalten.
fromAddress	string	Absenderadresse, die im E-Mail-Versand verwendet wird.
fromName	string	Anzeigename des Absenders in der E-Mail.
subject	string	Betreffzeile der Registrierungsbestätigungs-E-Mail.
template	string	Name oder Pfad der zu verwendenden E-Mail-Vorlage.
duplicate	object	Sammelobjekt für alle Einstellungen der Duplettenprüfung bei der Registrierung.
checkExistence	bool	Aktiviert (true) bzw. deaktiviert (false) die Duplettenprüfung. Default: false
keepAccount	bool	Legt fest, ob das Konto auch dann angelegt wird, wenn die Prüfung eine Dublette findet (true = trotzdem anlegen).
foundEmail	object	Mailkonfiguration für den Versand an die gefundene(n) Dublette(n). Im Mailtemplate kann über $wsRequestVariables.email die bei der Registrierung angegebene E-Mail-Adresse ausgegeben werden – beispielsweise damit der Account-Admin ein Subaccount für den Nutzer anlegen kann.
template	string	Name oder Pfad der E-Mail-Vorlage.
subject	string	Betreffzeile der E-Mail.
fromAddress	string	Absenderadresse der E-Mail.
fromName	string	Anzeigename des Absenders.
informFullAddress	bool	Steuert, ob in den Fehlerdetails der Meldung duplicateAccountFound (Aktion accountRegister) die gefundene Dubletten-Mailadresse unzensiert (true) oder zensiert (false) ausgegeben wird.
keepSignsInInformAddress	int	Nur wirksam, wenn informFullAddress = false: Anzahl der Zeichen im Local-Part der Mailadresse (alles vor dem @), die beibehalten werden. Alle übrigen Zeichen werden durch * ersetzt.
passwordChecks	array	Basis-Passwortprüfungen (werden immer angewendet). Aufbau identisch zu additionalPasswordCheckLevels.
service	string	Prüftyp (beispielsweise addressCheck.minLength, dataChecker.minLength für Prüfung einer Mindestangabe, addressCheck.maxLength, dataChecker.maxLength für Prüfung maximaler Zeichenangabe etc.). Übersicht der verfügbaren Validierungs- und Prüfregeln für Adressdatenfelder finden Sie hier.
options	array	Optionsobjekt für den jeweiligen Prüftyp.
errorCodes	object	Sammelobjekt für besondere Fehlerzustände.
passwordResetRequired	string	Schlüssel/Code, der ausgegeben wird, wenn für das Benutzerkonto eine Passwortzurücksetzung erforderlich ist (beispielsweise nach einem administrativen Reset oder aus Sicherheitsgründen). Wird vom System vorgegeben und kann nicht verändert werden.
login	object	Einstellungen für Anmelde-Schutzmechanismen.
ipBlockEnabled	bool	Aktiviert (true) / deaktiviert (false) die IP-basierte Sperre.
ipBlockCount	int	Anzahl fehlgeschlagener Versuche pro IP, bevor die IP gesperrt wird. Default: 10
ipBlockCountDuration	int	Zeitfenster in Minuten, in dem IP-Versuche gezählt werden. Default: 1
ipBlockDuration	int	Sperrdauer der IP in Minuten.
loginBlockCount	int	Anzahl fehlgeschlagener Logins pro Konto, bevor das Konto gesperrt wird. Default: 5
loginCountDuration	int	Zeitfenster in Minuten, in dem Konto-Versuche gezählt werden. Default: 60
loginBlockDuration	int	Kontosperrdauer in Minuten. Default: 180
loginBlockEmail	object	E-Mail-Benachrichtigung bei Kontosperre.
fromAddress	string	Absenderadresse (E-Mail).
fromName	string	Anzeigename des Absenders.
subject	string	Betreff der E-Mail.
template	string	Vorlagenname/Datei (beispielsweise loginBlocked.htm).
newCustomerRules	array	Regeln, nach denen ein eingeloggter Kunde im Bestellablauf als Neukunde (newCustomer) eingestuft wird - beispielsweise um Zahlungsarten für Neukunden zu sperren. Details siehe Neukunden-Regeln. Bei null oder leerer Liste gilt kein eingeloggter Kunde als Neukunde.
saveCreditCardData	bool	Speicherung von Kreditkartendaten im Konto erlauben (true/false).
sendConfirmationOfRegistrationEmail	bool	Gibt an, ob nach der Registrierung automatisch eine Bestätigungs-E-Mail versendet wird.
subAccountsEnabled	bool	Aktiviert oder deaktiviert (true/false) die Mitarbeiterkontenfunktion. Ist die Funktion aktiv, können für jedes übergeordnete Konto individuelle Mitarbeiterkonten angelegt werden. Sobald diese Funktion aktiviert ist, ist eine direkte Anmeldung am übergeordneten Konto nicht mehr möglich. Daher sollte die Aktivierung ausschließlich in einem neu eingerichteten Shop erfolgen – eine nachträgliche Aktivierung führt dazu, dass sich bestehende Nutzer nicht mehr anmelden können.

​

Neukunden-Regeln (newCustomerRules)

Über newCustomerRules wird festgelegt, wann ein eingeloggter Kunde im Bestellablauf als Neukunde gilt. Der so ermittelte Kundentyp newCustomer wird von der Zahlungsarten-Validierung paymentValidation.accountType ausgewertet - beispielsweise um Kauf auf Rechnung für Neukunden zu sperren.

Jede Regel besteht aus einem Feld und einer Bedingung. Trifft die Bedingung einer Regel zu, gilt der Kunde nicht als Neukunde. Nur wenn keine der Regeln zutrifft, wird der Kunde als Neukunde eingestuft.

​

Beispielkonfiguration (accounts.account.newCustomerRules)

Ein Kunde gilt als Neukunde, solange ihm noch keine Kundennummer zugewiesen wurde:

{
  "newCustomerRules": [
    {
      "field": "customerNumber",
      "type": "filled"
    }
  ]
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
field	string	Das Feld, das für die Prüfung herangezogen wird. Sonderfall "customerNumber": die Kundennummer des Benutzerkontos. Alle anderen Werte werden als dataId eines Feldes der Rechnungsadresse interpretiert (Standard- oder zusätzliche Adressfelder). Der Wert wird nicht gegen vorhandene Felder validiert - ein nicht existierendes Feld liefert immer einen leeren Wert.
type	enum	Bedingung, bei deren Zutreffen der Kunde nicht als Neukunde gilt. Mögliche Werte: - "filled" - Ist das Feld gefüllt, gilt der Kunde nicht als Neukunde. - "empty" - Ist das Feld leer, gilt der Kunde nicht als Neukunde. Default: "filled"

Der Kundentyp wird beim Login im Bestellablauf anhand dieser Regeln ermittelt (newCustomer oder customer). Eine Neuregistrierung im Bestellablauf führt unabhängig von den Regeln immer zum Kundentyp newCustomer. Gastbesteller haben den Kundentyp guest.

---

​

accounts.accountRestrictions - Subshopbeschränkungen für Benutzerkonten

Begrenzt die Verfügbarkeit von Kundenkonten auf definierte Subshops, beispielsweise B2B-Konten nur für einen Länder-Shop freigeben, exklusive Bereiche je Mandant oder Region.

Die Einstellungen zu diesem Abschnitt befinden sich im Admin Interface unter .

​

Beispielkonfiguration für alle Subshops (accounts.accountRestrictions)

{
  "subshopRestrictionList": [],
  "subshopRestrictionsEnabled": false,
  "subshopRestrictionsFallback": "onlySelf"
}

​

Parameterbeschreibungen

Parameter	Typ	Beschreibung
subshopRestrictionsEnabled	bool	Aktiviert (true) oder deaktiviert (false) die Subshop-Beschränkungen für Kundenkonten.
subshopRestrictionsFallback	enum	Fallback-Verhalten, wenn keine explizite Zuordnung greift (beispielsweise leere Liste oder fehlende Kennung). Standard: onlySelf – Konto ist nur im „eigenen/aktuell adressierten” Subshop nutzbar.
subshopRestrictionList	list	Liste der zulässigen Subshops (Allowlist) für das Konto. Einträge müssen den in Ihrer Umgebung verwendeten Subshop-Kennungen entsprechen (beispielsweise den Schlüsseln in der Subshop-Konfiguration). Ist die Liste leer, greift das Verhalten gemäß subshopRestrictionsFallback.

---

​

accounts.addressFieldsSettings - Individuelle Adressfelder-Einstellungen

Steuert die zentralen Konfigurationen für Adressfelder im Shop. Hier werden individuelle Beschriftungen, Standardwerte, Sichtbarkeiten und Schreibschutzregeln für Rechnungs- und Lieferadressen festgelegt.

Die Einstellungen zu diesem Abschnitt befinden sich im Admin Interface unter .

​

Beispielkonfiguration für alle Subshops (accounts.addressFieldsSettings)

{
  "customLabelsDefinition": [],
  "defaultValuesDefinition": [],
  "inputVisibilityDefinition": null,
  "readOnlyFields": null
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
customLabelsDefinition	list	Definition bedingungsabhängiger Feldbeschriftungen für Adressfelder.
defaultValuesDefinition	list	Definiert bedingungsabhängige Standardwerte / Vorbelegungen für Adressfelder.
inputVisibilityDefinition	list	Definiert die Sichtbarkeit einzelner Adressfelder.
readOnlyFields	list	Definiert, welche Adressfelder nur sichtbar und nicht bearbeitbar sind.

Bedingungsabhängige Definitionen (customLabelsDefinition & defaultValuesDefinition)

Die Definitionen defaultValuesDefinition und customLabelsDefinition ermöglichen es, Standardwerte und benutzerdefinierte Feldbezeichnungen für Adressfelder abhängig von bestimmten Bedingungen zu definieren.

Beide Definitionen folgen derselben Struktur und unterstützen ein conditions-Array, mit dem die Anwendung der jeweiligen Regel an Feldbedingungen geknüpft werden kann.

Aufbau eines Eintrags

Eigenschaft	Typ	Beschreibung
fields	list	Liste der betroffenen Adressfelder (beispielsweise accounts.addressField.firstName).
addressType	string	Adresstyp, für den die Regel gilt. "bill" = Rechnungsadresse, "delivery" = Lieferadresse.
label / value	string	Hier wird zwischen beiden Definitionen unterschieden. customLabelsDefinition (label): die anzuzeigende Beschriftung. defaultValuesDefinition (value): der vorzubelegende Standardwert.
conditions	list	Liste von Bedingungen, die alle erfüllt sein müssen, damit die Regel greift.

Aufbau einer Condition

Eigenschaft	Typ	Beschreibung
field	string	Das Adressfeld, auf das sich die Bedingung bezieht (beispielsweise accounts.addressField.country).
type	string	Art der Prüfung. value: exakter Vergleichswert oder filled: Feld ist befüllt.
value	string	Abhängig davon, was bei type definiert wurde. Bei "value": der erwartete Wert (beispielsweise "DE"). Bei "filled": ein leerer String ("").

Beispiel für customLabelsDefinition

Benutzerdefinierte Feldbeschriftungen, die abhängig von Bedingungen angezeigt werden:

{
  "customLabelsDefinition": [
    {
      "fields": ["accounts.addressField.firstName"],
      "addressType": "bill",
      "label": "Vorname (Rechnung)",
      "conditions": [
        {
          "field": "accounts.addressField.country",
          "type": "value",
          "value": "DE"
        }
      ]
    },
    {
      "fields": ["accounts.addressField.firma"],
      "addressType": "delivery",
      "label": "Firma (Lieferung)",
      "conditions": [
        {
          "field": "accounts.addressField.country",
          "type": "filled",
          "value": ""
        }
      ]
    }
  ]
}

Erklärung

Im ersten Eintrag wird das Feld accounts.addressField.firstName in der Rechnungsadresse mit dem Label „Vorname (Rechnung)” beschriftet – jedoch nur, wenn das Land auf DE gesetzt ist. Im zweiten Eintrag erhält das Feld accounts.addressField.firma in der Lieferadresse das Label „Firma (Lieferung)”, sobald das Feld accounts.addressField.country einen beliebigen Wert enthält (type: "filled").

Beispiel für defaultValuesDefinition

Standardwerte für Adressfelder, die ebenfalls bedingungsabhängig vorbefüllt werden:

{
  "defaultValuesDefinition": [
    {
      "fields": ["accounts.addressField.country"],
      "addressType": "bill",
      "value": "DE",
      "conditions": []
    },
    {
      "fields": ["accounts.addressField.salutation"],
      "addressType": "delivery",
      "value": "Herr",
      "conditions": [
        {
          "field": "accounts.addressField.country",
          "type": "value",
          "value": "DE"
        }
      ]
    }
  ]
}

Erklärung

Im ersten Eintrag wird das Feld accounts.addressField.country in der Rechnungsadresse bedingungslos mit "DE" vorbelegt. Im zweiten Eintrag wird die Anrede der Lieferadresse (accounts.addressField.salutation) nur dann auf "Herr" gesetzt, wenn das Land DE ist.

---

​

accounts.addressField - Einzelne Adressfelder definieren

Steuert die Struktur und Eigenschaften einzelner Adressfelder im Shop. Über Validierungen können Eingaben überprüft und formale Anforderungen (beispielsweise Pflichtfelder, Formatprüfungen) festgelegt werden.

Die Einstellungen zu diesem Abschnitt befinden sich im Admin Interface unter .

​

Beispielkonfiguration für alle Subshops (accounts.addressField.firstName)

{
  "label": "<Textbaustein>",
  "name": "firstName",
  "validations": [
    {
      "options": {
        "len": 255
      },
      "service": "addressCheck.maxLength"
    }
  ]
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
label	string	Definition der Feldbeschriftung.
name	string	Anzeigename (in diesem Beispiel des Kunden, in anderen Fällen beispielsweise der Name der Stadt, in der der Kunde wohnt).
validations	array	Definiert die Liste der Validierungsregeln, die auf das jeweilige Adressfeld angewendet werden.
options	array	Definiert die Parameter oder Einstellungen, die eine Validierungsregel benötigt – beispielsweise Grenzwerte, erlaubte Zeichen oder Bedingungen.
len	int	Gibt im Beispiel die maximal zulässige Zeichenlänge für die Validierung an.
service	string	Bezeichnet den verwendeten Validierungsdienst, der die eigentliche Prüfung durchführt – hier beispielsweise addressCheck.maxLength zur Kontrolle der maximalen Feldlänge.

---

​

accounts.autoLogin - Angemeldet bleiben

Steuert das „Angemeldet bleiben”-Verhalten (Auto-Login) für Kundenkonten: Aktivierung, Ablaufzeiten und Reaktionen auf Sonderfälle.

Die Einstellungen zu diesem Abschnitt befinden sich im Admin Interface unter .

​

Beispielkonfiguration für alle Subshops (accounts.autoLogin)

{
  "actions": null,
  "active": true,
  "errorCodes": {
    "actionRequiresLogin": ""
  },
  "expireTimesInDays": {
    "cookie": 30,
    "noAutoLogin": 10,
    "noPasswordLogin": 20
  },
  "restriction": "notAllowed"
}

​

Parameterbeschreibung

Parameter	Typ	Beschreibung
active	bool	Aktiviert (true) oder deaktiviert (false) die Auto-Login-Funktion insgesamt.
restriction	enum	Richtlinie für Auto-Login. Wert notAllowed: Auto-Login ist untersagt (keine dauerhafte Sitzung). Weitere Werte sind systemspezifisch vorbelegt.
expireTimesInDays	object	Sammelobjekt mit Ablaufzeiten (in Tagen) für unterschiedliche Szenarien.
cookie	uint	Gültigkeitsdauer des Auto-Login-Cookies in Tagen. Nach Ablauf ist ein regulärer Login erforderlich. Default: 30
noAutoLogin	uint	Maximale Inaktivitätsdauer in Tagen ohne Auto-Login; nach Ablauf wird keine automatische Anmeldung mehr versucht. Default: 10
noPasswordLogin	uint	Zeitraum in Tagen, nach dem trotz bestehendem Auto-Login eine Passwort-Eingabe erzwungen wird (beispielsweise als Re-Auth). Default: 20
errorCodes	object	Objekt für spezielle Fehlerzustände.
actionRequiresLogin	string	Schlüssel/Code für den Fall, dass eine Aktion eine erneute Anmeldung erfordert.
actions	list	Liste der Aktionen, die während eines automatischen Logins ohne erneute Passwortabfrage erlaubt sind. Damit lässt sich gezielt festlegen, was Kunden im angemeldeten Zustand nutzen dürfen, ohne sich erneut anzumelden. Beispielsweise kann so der Zugriff auf unkritische Funktionen wie die Merkliste erlaubt werden, während sicherheitsrelevante Aktionen (beispielsweise Warenkorb- oder Bestellvorgänge) weiterhin eine erneute Anmeldung erfordern. Beispiele für erlaubte Aktionen: WatchListAdd → neue Merkliste anlegen, WatchListDelete → Merkliste löschen, WatchListItemAdd → Produkte auf eine Merkliste legen, WatchListItemDelete → Produkte von einer Merkliste löschen. Wenn keine Aktionen erlaubt werden sollen, muss der Wert auf null gesetzt werden. In diesem Fall sind alle Aktionen automatisch gesperrt, und für jede Interaktion ist eine erneute Anmeldung erforderlich.

---

​

accounts.bankInfoField - Bankdaten

Ermöglicht die Erfassung und Verwaltung von Bankdaten im Kundenkonto. Im Gegensatz zu Kreditkartendaten können diese Informationen direkt im Shop eingegeben, geändert und gespeichert werden.

Die gespeicherten Bankverbindungen stehen anschließend im Bestellprozess – insbesondere bei der Zahlart SEPA-Lastschrift – zur Auswahl.

​

Beispielkonfiguration für alle Subshops (accounts.bankInfoField.owner)

{
  "dataId": "owner",
  "label": "Kontoinhaber",
  "name": "owner"
}

​

Parameterbeschreibung

Parameter	Typ	Beschreibung
dataId	string	Interne Kennung des Datenfeldes (beispielsweise „owner”).
label	string	Anzeigename im Kundenkonto, beispielsweise „Kontoinhaber”.
name	string	Technischer Feldname. Wird vom System vorgegeben und sollte nicht verändert werden. Folgende name stehen zur Verfügung: - accountNumber - Kontonummer der Kundin bzw. des Kunden (in der Regel nur bei älteren Konten ohne IBAN relevant) - bankCode - Bankleitzahl (nur relevant, wenn keine IBAN verwendet wird) - bankName - Name der Bank - bic - BIC (Business Identifier Code) der Bank - iban - IBAN (International Bank Account Number) der Kontoinhaberin bzw. des Kontoinhabers - owner - Name der Kontoinhaberin bzw. des Kontoinhabers - sepaDebitType - Art der SEPA-Lastschrift (beispielsweise CORE oder B2B) - sepaDirectDebitMandate - Mandatsreferenznummer der SEPA-Lastschrift - sepaMandateDate - Datum der Mandatserteilung (ISO-Format empfohlen: YYYY-MM-DD) - sepaMandateType - Typ des SEPA-Mandats (beispielsweise Erstmandat oder Folgemandat)

---

​

accounts.creditCardField - Kreditkarten

Die Bezahlung mit Kreditkarte wird aus Sicherheitsgründen ausschließlich über externe Payment-Service-Provider (PSP) abgewickelt.

Die Eingabe der Kreditkartendaten, die Erkennung des Kartentyps sowie die Durchführung des 3D Secure 2.0-Verfahrens erfolgen vollständig beim Payment-Provider. Reale Kreditkartendaten werden niemals im Onlineshop gespeichert oder verarbeitet.

Im Kundenkonto können – sofern vom PSP unterstützt und vertraglich freigeschaltet – pseudonymisierte Kreditkarteninformationen angezeigt werden. Dadurch können Kunden beim nächsten Einkauf bequem eine gespeicherte Karte auswählen, ohne die Daten erneut eingeben zu müssen. Eine direkte Eingabe oder Änderung von Kreditkartendaten im Shop ist dabei nicht möglich.

​

Beispielkonfiguration für alle Subshops (accounts.creditCardField.holder)

{
  "dataId": "holder",
  "label": "Kreditkarten-Inhaber",
  "name": "holder"
}

​

Parameterbeschreibung

Parameter	Typ	Beschreibung
dataId	string	Interne Kennung des Datenfeldes (beispielsweise „holder”).
label	string	Anzeigename im Kundenkonto, beispielsweise „Kreditkarten-Inhaber”.
name	string	Technischer Feldname. Wird vom System vorgegeben und sollte nicht verändert werden. Folgende name stehen zur Verfügung: - cvCode - Sicherheitscode (3 oder 4 Stellen, je nach Kartentyp) - expireMonth - Ablaufmonat der Karte - expireYear - Ablaufjahr der Karte - holder - Karteninhaberin bzw. Karteninhaber - number - Kartennummer (pseudonymisiert) - type - Kartentyp (beispielsweise Visa, MasterCard, American Express)

---

​

accounts.customAddressField - Weitere Adressdatenfelder

Ermöglicht die Definition zusätzlicher Adressfelder für Rechnungs- und/oder Lieferadressen.

Diese Felder ergänzen die Standardangaben (beispielsweise Name, Straße, PLZ, Ort, Land, Telefon) um individuelle Eingabefelder, die im Kundenkonto oder im Checkout angezeigt und gespeichert werden. Beispiele für typische Zusatzfelder sind: Adresszusatz, Etage, Postfach, Packstationnummer oder Abteilung.

​

Beispielkonfiguration für alle Subshops (accounts.customAddressField.postOfficeBox)

{
  "dataId": "customField.postfach",
  "label": "<Textbaustein>",
  "name": "postfach",
  "validations": [
    {
      "options": {
        "len": 3
      },
      "service": "addressCheck.minLength"
    },
    {
      "options": {
        "len": 20
      },
      "service": "addressCheck.maxLength"
    },
    { 
      "options": {
        "signs": "^[0-9A-Za-z\\s-]+$"
      },
      "service": "addressCheck.legalSigns" 
    }   
  ]
}

​

Parameterbeschreibung

Parameter	Typ	Beschreibung
dataId	string	Interne Kennung oder Referenz-ID des Feldes (beispielsweise zur Verknüpfung mit externen Systemen oder Datenquellen).
label	string	Anzeigename des Feldes im Frontend (beispielsweise „Etage” oder „Packstationnummer”).
name	string	Technischer Feldname, der intern für Speicherung und Zuordnung verwendet wird.
validations	array	Optionales Validierungsobjekt zur Prüfung der Eingabe (beispielsweise Pflichtfeld, maximale Länge, bestimmte Zeichenformate). Kann null sein, wenn keine Validierung erforderlich ist. Übersicht der verfügbaren Validierungs- und Prüfregeln für Adressdatenfelder finden Sie hier.

---

​

accounts.watchListField - Merkliste

Definiert Felder der Merk- bzw. Beobachtungsliste mit eindeutiger ID und Namen.

Diese Felder sind ausschließlich über die API ansprechbar und besitzen keine Konfigurationsmöglichkeit im Admin Interface.

​

Beispielkonfiguration für alle Subshops (accounts.watchListField)

{
  "name": "watchListIds"
}

​

Parameterbeschreibung

Parameter	Typ	Beschreibung
name	string	Technischer Name des Watchlist-Feldes. Dient zur eindeutigen Identifizierung des Feldes innerhalb der API und interner Prozesse.