Validierungs- und Prüfservices - WEBSALE Dokumentation

Diese Seite beschreibt die verfügbaren Services zur Validierung von Benutzereingaben sowie die regelbasierten Prüfungen für Zahlungs- und Versandarten. Die Services sind keine klassischen Konfigurationsknoten mit eigener Struktur, sondern werden in den jeweiligen Formular- oder Regeldefinitionen referenziert (z. B. in Account-, Checkout- oder Payment-/Shipping-Konfigurationen).

`addressCheck.*` - Adressvalidierungen

addressCheck.* enthält Prüfungen für Adressfelder (z.B. Name, Straße, PLZ). Die Prüfungen werden in den jeweiligen Felddefinitionen unter validations hinterlegt. Das Frontend zeigt die Felder wie konfiguriert an und prüft beim Ausfüllen, ob die Eingaben gültig sind. So werden falsche oder unzulässige Werte früh erkannt.

`addressCheck.minLength` - Mindestlänge

Prüft die Mindestlänge der Eingabe bei Adressfeldern.

Beispielkonfiguration für (`accounts.addressField.firstName`)

{
  "label": "",
  "name": "firstName",
  "validations": [
    {
      "options": {
        "len": 1
      },
      "service": "addressCheck.minLength"
    }
  ]
}

Parameterübersicht

Parameter	Beschreibung
`len`	Gewünschte Mindestlänge in Zahlen.

`addressCheck.maxLength` - Maximallänge

Prüft die Maximallänge der Eingabe bei Adressfeldern.

Beispielkonfiguration für (`accounts.addressField.firstName`)

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

Parameterübersicht

Parameter	Beschreibung
`len`	Gewünschte Maximallänge in Zahlen.

`addressCheck.numeric` - Nur Ziffern

Prüft, ob die Eingabe bei Adressfeldern nur aus Ziffern besteht.

Beispielkonfiguration für (`accounts.addressField.phone`)

{
  "label": "",
  "name": "phone",
  "validations": [
    {
      "service": "addressCheck.numeric"
    }
  ]
}

Parameterübersicht

Parameter	Beschreibung
—	Keine zusätzlichen Parameter.

`addressCheck.country` - Ländercode (ISO)

Prüft, ob die Eingabe resp. Auswahl bei Länderlisten der Adressdatenfelder ein im Shop konfigurierter Ländercode ist (ISO-Code: 2-stellig, 3-stellig oder ISO-Nummer). Die offiziellen ISO-3166-1-Codes (alpha-2, alpha-3 und numerisch) finden sich auf der Website der International Organization for Standardization (ISO): https://www.iso.org/iso-3166-country-codes.html

Beispielkonfiguration für (`accounts.addressField.country`)

{
  "label": "",
  "name": "country",
  "validations": [
    {
      "service": "addressCheck.country"
    }
  ]
}

Parameterübersicht

Parameter	Beschreibung
—	Keine zusätzlichen Parameter.

`addressCheck.zip` - Postleitzahl (PLZ)

Prüft, ob die Eingabe eine gültige Postleitzahl (PLZ) für das angegebene Land ist. Die PLZ-Regeln stammen aus der Konfiguration. Das dazugehörige Land muss zwingend im Feld country übergeben werden.

Beispielkonfiguration für (`accounts.addressField.zip`)

{
  "label": "",
  "name": "zip",
  "validations": [
    {
      "service": "addressCheck.zip"
    }
  ]
}

Parameterübersicht

Parameter	Beschreibung
—	Keine zusätzlichen Parameter.

`addressCheck.salutation` - Anrede (Code)

Prüft, ob die Eingabe eine gültige Anrede ist (Code gemäß Konfiguration).

Beispielkonfiguration für (`accounts.addressField.salutationCode`)

{
  "label": "",
  "name": "salutationCode",
  "validations": [
    {
      "service": "addressCheck.salutation"
    }
  ]
}

Parameterübersicht

Parameter	Beschreibung
—	Keine zusätzlichen Parameter.

`addressCheck.regex` - Regulärer Ausdruck

Prüft, ob die Eingabe zu einem regulären Ausdruck passt.

Beispielkonfiguration für (`accounts.addressField.additionalInfo`)

{
  "label": "",
  "name": "additionalInfo",
  "validations": [
    {
      "options": {
        "expression": "^((?i)(?!Postfach).)*$"
      },
      "service": "addressCheck.regex"
    }
  ]
}

Parameterübersicht

Parameter	Beschreibung
`expression`	Regulärer Ausdruck (Zeichenkette).

`addressCheck.phone` - Telefonnummer

Prüft, ob die Eingabe eine gültige Telefonnummer ist. Eine gültige Nummer besteht aus Ziffern (ohne Längenbeschränkung) und optional einer internationalen Vorwahl. Das + in der Vorwahl wird nach erfolgreicher Validierung durch 00 ersetzt.

Beispielkonfiguration für (`accounts.addressField.phone`)

{
  "label": "",
  "name": "phone",
  "validations": [
    {
      "service": "addressCheck.phone"
    }
  ]
}

Parameterübersicht

Parameter	Beschreibung
—	Keine zusätzlichen Parameter.

`addressCheck.alpha` - Nur Buchstaben (A–Z)

Prüft, ob die Eingabe nur aus lateinischen Buchstaben besteht (Groß-/Kleinschreibung egal).

Beispielkonfiguration für (`accounts.addressField.additionalInfo`)

{
  "label": "",
  "name": "additionalInfo",
  "validations": [
    { "service": "addressCheck.alpha" }
  ]
}

Parameterübersicht

Parameter	Beschreibung
—	Keine zusätzlichen Parameter.

`addressCheck.alphanum` - Buchstaben/Ziffern (A–Z/0–9)

Prüft, ob die Eingabe nur aus lateinischen Buchstaben oder Ziffern besteht (Groß-/Kleinschreibung egal).

Beispielkonfiguration für (`accounts.addressField.additionalInfo`)

{
  "label": "",
  "name": "additionalInfo",
  "validations": [
    { "service": "addressCheck.alphanum" }
  ]
}

Parameterübersicht

Parameter	Beschreibung
—	Keine zusätzlichen Parameter.

`addressCheck.legalSigns` - Erlaubte Zeichen

Prüft, ob alle Zeichen der Eingabe in der erlaubten Zeichenauswahl enthalten sind (Groß-/Kleinschreibung relevant).

Beispielkonfiguration für (`accounts.addressField.additionalInfo`)

{
  "label": "",
  "name": "additionalInfo",
  "validations": [
    {
      "options": {
        "signs": "123456ABCSDEF"
      },
      "service": "addressCheck.legalSigns"
    }
  ]
}

Parameterübersicht

Parameter	Beschreibung
`signs`	Erlaubte Zeichen (Zeichenkette).

`addressCheck.illegalSigns` - Verbotene Zeichen

Gegenteil von legalSigns: Die Eingabe darf keines der angegebenen Zeichen enthalten.

Beispielkonfiguration für (`accounts.addressField.phone`)

{
  "label": "",
  "name": "phone",
  "validations": [
    {
      "options": {
        "signs": "*|~%${};\"<>§@()/-_#"
      },
      "service": "addressCheck.illegalSigns"
    }
  ]
}

Parameterübersicht

Parameter	Beschreibung
`signs`	Unerlaubte Zeichen (Zeichenkette).

`addressCheck.date` - Datum

Prüft, ob die Eingabe ein gültiges Datum ist, und formatiert die Eingabe bei Bedarf.

Beispielkonfiguration für (`accounts.addressField.additionalInfo`)

{
  "label": "",
  "name": "additionalInfo",
  "validations": [
    {
      "options": {
        "delimiter": "-",
        "dateformat": "DMY",
        "formatleadingzero": false
      },
      "service": "addressCheck.date"
    }
  ]
}

Parameterübersicht

Parameter	Beschreibung
`delimiter`	Trennzeichen zwischen Tag/Monat/Jahr (z. B. `-` für `15-10-2025`).
`dateformat`	Beliebige Kombination aus `D`, `M`, `Y` (z. B. `DMY` für `15-10-2025`).
`formatleadingzero`	Wenn aktiv (`true`), werden Tage/Monate zweistellig formatiert (`5 → 05`). Wenn deaktiviert (`false`), werden führende Nullen entfernt (`05 → 5`). (Wahrheitswert)

`addressCheck.allowedSelection` - Auswahl (Listenelement)

Validiert, ob die Eingabe einem vordefinierten Auswahlwert entspricht. Hierzu wird die dataId einer Konfiguration aus general.addressListElements übergeben. Typische Anwendung: Prüfung, ob eine Adresse z. B. „Packstation” oder „Privatadresse” ist.

Beispielkonfiguration für (`accounts.addressField.addressType`)

{
  "label": "",
  "name": "addressType",
  "validations": [
    {
      "options": {
        "listElements": "general.addressListElements.addressType"
      },
      "service": "addressCheck.allowedSelection"
    }
  ]
}

Parameterübersicht

Parameter	Beschreibung
`listElements`	`dataId` einer Definition aus `general.addressListElements`

`dataChecker.*` - Allgemeine Feldvalidierungen

dataChecker.* enthält Prüfungen für allgemeine Formularfelder, die nicht speziell zu einer Adresse gehören. Die Prüfungen werden in der jeweiligen Felddefinition unter validations eingebunden. Das Frontend übernimmt die Vorgaben aus der Felddefinition und prüft beim Ausfüllen, ob die Eingabe korrekt ist (z.B. Länge, Format oder unerlaubte Zeichen).

`dataChecker.minLength` - Mindestlänge

Prüft die Mindestlänge der Eingaben bei Formular-Eingabefeldern.

Beispielkonfiguration für (`inquiry.form.catalogue.fields.firstName`)

{
  "label": "Vorname",
  "name": "firstName",
  "required": true,
  "validations": [
    { "options": { "len": 3 }, "service": "dataChecker.minLength" }
  ]
}

Parameterübersicht

Parameter	Beschreibung
`len`	Gewünschte Mindestlänge in Zahlen.

`dataChecker.maxLength` - Maximallänge

Prüft die Maximallänge der Eingaben bei Formular-Eingabefeldern.

Beispielkonfiguration für (`inquiry.form.catalogue.fields.firstName`)

{
  "label": "Vorname",
  "name": "firstName",
  "required": true,
  "validations": [
    { "options": { "len": 255 }, "service": "dataChecker.maxLength" }
  ]
}

Parameterübersicht

Parameter	Beschreibung
`len`	Gewünschte Maximallänge in Zahlen.

`dataChecker.numeric` - Nur Ziffern

Prüft, ob die Eingabe bei Formular-Eingabefeldern nur aus Ziffern besteht.

Beispielkonfiguration für (`inquiry.form.catalogue.fields.phone`)

{
  "label": "Telefon",
  "name": "phone",
  "validations": [
    { "service": "dataChecker.numeric" }
  ]
}

Parameterübersicht

Parameter	Beschreibung
—	Keine zusätzlichen Parameter.

`dataChecker.country` - Ländercode (ISO)

Prüft, ob die Eingabe resp. Auswahl bei Länderlisten der Formularfelder ein im Shop konfigurierter Ländercode ist (ISO-Code: 2-stellig, 3-stellig oder ISO-Nummer). Die offiziellen ISO-3166-1-Codes (alpha-2, alpha-3 und numerisch) finden sich auf der Website der International Organization for Standardization (ISO): https://www.iso.org/iso-3166-country-codes.html

Beispielkonfiguration für (`inquiry.form.catalogue.fields.country`)

{
  "label": "Land",
  "name": "country",
  "validations": [
    { "service": "dataChecker.country" }
  ]
}

Parameterübersicht

Parameter	Beschreibung
—	Keine zusätzlichen Parameter.

`dataChecker.zip` - Postleitzahl (PLZ)

Beispielkonfiguration für (`inquiry.form.catalogue.fields.zip`)

{
  "label": "Postleitzahl",
  "name": "zip",
  "validations": [
    { "service": "dataChecker.zip" }
  ]
}

Parameterübersicht

Parameter	Beschreibung
—	Keine zusätzlichen Parameter. (Für länderspezifische Prüfung muss das Feld `country` im Kontext verfügbar sein.)

`dataChecker.salutation` - Anrede (Code)

Prüft, ob die Eingabe eine gültige Anrede ist (Code gemäß Konfiguration).

Beispielkonfiguration für (`inquiry.form.catalogue.fields.salutation`)

{
  "label": "Anrede",
  "name": "salutation",
  "validations": [
    { "service": "dataChecker.salutation" }
  ]
}

Parameterübersicht

Parameter	Beschreibung
—	Keine zusätzlichen Parameter.

`dataChecker.regex` - Regulärer Ausdruck

Prüft, ob die Eingabe zu einem regulären Ausdruck passt.

Beispielkonfiguration für (`inquiry.form.catalogue.fields.additionalInfo`)

{
  "label": "Zusatzinformation",
  "name": "additionalInfo",
  "validations": [
    {
      "options": {
        "expression": "^((?i)(?!Postfach).)*$"
      },
      "service": "dataChecker.regex"
    }
  ]
}

Parameterübersicht

Parameter	Beschreibung
`expression`	Regulärer Ausdruck (Zeichenkette).

`dataChecker.email` - E‑Mail-Adresse

Prüft, ob die Eingabe eine gültige E‑Mail-Adresse ist.

Beispielkonfiguration für (`inquiry.form.catalogue.fields.mail`)

{
  "label": "E-Mail-Adresse",
  "name": "mail",
  "validations": [
    { "service": "dataChecker.email" }
  ]
}

Parameterübersicht

Parameter	Beschreibung
—	Keine zusätzlichen Parameter.

`dataChecker.alphaClass` - Buchstaben (min/verschiedene)

Stellt sicher, dass die Eingabe mindestens minChars lateinische Buchstaben enthält (Groß-/Kleinschreibung egal); optional Mindestanzahl unterschiedlicher Buchstaben.

Beispielkonfiguration für (`inquiry.form.catalogue.fields.additionalInfo`)

{
  "label": "Zusatzinformation",
  "name": "additionalInfo",
  "required": true,
  "validations": [
    {
      "options": {
        "minChars": 8,
        "minDifferentChars": 2
      },
      "service": "dataChecker.alphaClass"
    }
  ]
}

Parameterübersicht

Parameter	Beschreibung
`minChars`	Mindestanzahl an Buchstaben (Zahl ≥ 0).
`minDifferentChars`	Mindestanzahl unterschiedlicher Buchstaben (Zahl ≥ 0).

`dataChecker.lowerAlphaClass` - Kleinbuchstaben

Wie alphaClass, jedoch nur Kleinbuchstaben.

Beispielkonfiguration für (`inquiry.form.catalogue.fields.additionalInfo`)

{
  "label": "Zusatzinformation",
  "name": "additionalInfo",
  "required": true,
  "validations": [
    {
      "options": {
        "minChars": 8,
        "minDifferentChars": 2
      },
      "service": "dataChecker.lowerAlphaClass"
    }
  ]
}

Parameterübersicht

Parameter	Beschreibung
`minChars`	Mindestanzahl an Kleinbuchstaben (Zahl ≥ 0).
`minDifferentChars`	Mindestanzahl unterschiedlicher Kleinbuchstaben (Zahl ≥ 0).

`dataChecker.upperAlphaClass` - Großbuchstaben

Wie alphaClass, jedoch nur Großbuchstaben.

Beispielkonfiguration für (`inquiry.form.catalogue.fields.additionalInfo`)

{
  "label": "Zusatzinformation",
  "name": "additionalInfo",
  "required": true,
  "validations": [
    {
      "options": {
        "minChars": 8,
        "minDifferentChars": 2
      },
      "service": "dataChecker.upperAlphaClass"
    }
  ]
}

Parameterübersicht

Parameter	Beschreibung
`minChars`	Mindestanzahl an Großbuchstaben (Zahl ≥ 0).
`minDifferentChars`	Mindestanzahl unterschiedlicher Großbuchstaben (Zahl ≥ 0).

`dataChecker.digitClass` - Ziffern

Wie alphaClass, jedoch für Ziffern.

Beispielkonfiguration für (`inquiry.form.catalogue.fields.additionalInfo`)

{
  "label": "Zusatzinformation",
  "name": "additionalInfo",
  "required": true,
  "validations": [
    {
      "options": {
        "minChars": 4,
        "minDifferentChars": 2
      },
      "service": "dataChecker.digitClass"
    }
  ]
}

Parameterübersicht

Parameter	Beschreibung
`minChars`	Mindestanzahl an Ziffern (Zahl ≥ 0).
`minDifferentChars`	Mindestanzahl unterschiedlicher Ziffern (Zahl ≥ 0).

`dataChecker.specialClass` - Sonderzeichen

Wie alphaClass, jedoch für Sonderzeichen.

Beispielkonfiguration für (`inquiry.form.catalogue.fields.additionalInfo`)

{
  "label": "Zusatzinformation",
  "name": "additionalInfo",
  "required": true,
  "validations": [
    {
      "options": {
        "minChars": 2,
        "minDifferentChars": 1
      },
      "service": "dataChecker.specialClass"
    }
  ]
}

Parameterübersicht

Parameter	Beschreibung
`minChars`	Mindestanzahl an Sonderzeichen (Zahl ≥ 0).
`minDifferentChars`	Mindestanzahl unterschiedlicher Sonderzeichen (Zahl ≥ 0).

`dataChecker.sequenceOfIdenticalCharacters` - Wiederholte Zeichen (Sequenz)

Prüft, ob dasselbe Zeichen zu oft hintereinander vorkommt.

Beispielkonfiguration für (`inquiry.form.catalogue.fields.additionalInfo`)

{
  "label": "Zusatzinformation",
  "name": "additionalInfo",
  "required": true,
  "validations": [
    {
      "options": {
        "caseInsensitive": false,
        "maxSequence": 2
      },
      "service": "dataChecker.sequenceOfIdenticalCharacters"
    }
  ]
}

Parameterübersicht

Parameter	Beschreibung
`caseInsensitive`	Groß-/Kleinschreibung ignorieren (Wahrheitswert).
`maxSequence`	Maximale erlaubte Wiederholung eines Zeichens (Zahl ≥ 0).

`dataChecker.consecutiveNumbers` - Fortlaufende Zahlen

Prüft auf auf- oder absteigende Zahlenketten (z. B. 12345 oder 54321).

Beispielkonfiguration für (`inquiry.form.catalogue.fields.additionalInfo`)

{
  "label": "Zusatzinformation",
  "name": "additionalInfo",
  "required": true,
  "validations": [
    {
      "options": {
        "maxConsecutive": 2
      },
      "service": "dataChecker.consecutiveNumbers"
    }
  ]
}

Parameterübersicht

Parameter	Beschreibung
`maxConsecutive`	Maximale Länge der Zahlenkette (Zahl ≥ 0).

`dataChecker.consecutiveLetters` - Fortlaufende Buchstaben

Prüft auf auf- oder absteigende Buchstabenkombinationen (z. B. abcd oder dcba).

Beispielkonfiguration für (`inquiry.form.catalogue.fields.additionalInfo`)

{
  "label": "Zusatzinformation",
  "name": "additionalInfo",
  "required": true,
  "validations": [
    {
      "options": {
        "maxConsecutive": 2,
        "caseInsensitive": false
      },
      "service": "dataChecker.consecutiveLetters"
    }
  ]
}

Parameterübersicht

Parameter	Beschreibung
`maxConsecutive`	Maximale Länge der Buchstabenkette (Zahl ≥ 0).
`caseInsensitive`	Groß-/Kleinschreibung ignorieren (Wahrheitswert).

`dataChecker.palindrome` - Palindrom

Prüft, ob die Eingabe ein Palindrom ist (vorwärts/rückwärts identisch, z. B. „Otto”).

Beispielkonfiguration für (`inquiry.form.catalogue.fields.additionalInfo`)

{
  "label": "Zusatzinformation",
  "name": "additionalInfo",
  "required": true,
  "validations": [
    {
      "options": {
        "caseInsensitive": false
      },
      "service": "dataChecker.palindrome"
    }
  ]
}

Parameterübersicht

Parameter	Beschreibung
`caseInsensitive`	Groß-/Kleinschreibung ignorieren (Wahrheitswert).

`paymentValidation.*` - Zahlungsarten-Validierung

paymentValidation.* enthält Regeln, mit denen festgelegt wird, ob eine Zahlungsart im Checkout erlaubt ist. Die Prüfung kann z.B. vom Land der Rechnungs- oder Lieferadresse, vom Kundentyp, vom Warenkorb oder vom Bestellwert abhängen. Diese Regeln können in der Konfiguration der jeweiligen Zahlungsart unter validations eingetragen werden. Das Frontend zeigt dann nur passende Zahlungsarten an oder verhindert die Auswahl, wenn die Bedingungen nicht erfüllt sind. Hier geht es zum zugehörigen Konfigurationsknoten payment: payment - Zahlungsmethoden Auswertung im Frontend Im Template werden die konfigurierten Regeln über die Methode $wsCheckout.isValidPayment(paymentId) ausgewertet: Sie führt alle unter validations hinterlegten Services aus und gibt false zurück, sobald mindestens eine Regel fehlschlägt. So werden nicht verfügbare Zahlungsarten in der Auswahl deaktiviert oder ausgeblendet.

{{ foreach $cPayment in $wsConfig.payments }}
  <input type="radio" name="paymentId" value="{{= $cPayment.id }}"
    {{ if not $wsCheckout.isValidPayment($cPayment.id) }} disabled{{ /if }}>
  <label>{{= $cPayment.name }}</label>
{{ /foreach }}

Für die aktuell ausgewählte Zahlungsart stehen die Gründe einer fehlgeschlagenen Prüfung unter $wsCheckout.problems.payment bereit; das Feld check nennt den fehlgeschlagenen Service.

`paymentValidation.billCountry` - Validierung des Landes (Rechnungsadresse) für Zahlungsarten

Prüft, ob das Land der Rechnungsadresse entsprechend einer „Allow/Deny”-Liste für eine Zahlungsart zulässig ist. Über die Optionen kann festgelegt werden, für welche Länder die Regel greift und ob diese Liste Länder erlaubt oder verbietet.

Beispielkonfiguration

"validations": [
  {
    "options": {
      "countryList": [
        "general.country.de",
        "general.country.at",
        "general.country.ch"
      ],
      "rule": "allow"
    },
    "service": "paymentValidation.billCountry"
  }
]

Parameterübersicht

Parameter	Beschreibung
`countryList`	Liste der Länder, auf die diese Regel angewendet werden soll. (ISO-Länderkennungen, z.B. „`DE`”, „`AT`”, „`CH`”)
`rule`	Steuerung der Regel. Mögliche Werte: - `allow` - Länder, die in `countryList` stehen, sind erlaubt. - `deny` - Länder, die in `countryList` stehen, sind nicht erlaubt.

`paymentValidation.billPhone` - Validierung der Telefonnummer

Prüft, ob für die Rechnungsadresse eine Telefonnummer angegeben ist (das Feld darf nicht leer sein).

Beispielkonfiguration

"validations": [
  {
    "service": "paymentValidation.billPhone"
  }
]

Für diesen Service sind keine Parameter vorhanden.

`paymentValidation.billDateOfBirth` - Validierung des Geburtsdatums

Prüft, ob für die Rechnungsadresse ein Geburtsdatum angegeben ist (das Feld darf nicht leer sein).

Beispielkonfiguration

"validations": [
  {
    "service": "paymentValidation.billDateOfBirth"
  }
]

Für diesen Service sind keine Parameter vorhanden.

`paymentValidation.shippingCountry` - Validierung des Landes (Lieferadresse)

Prüft, ob das Land der Lieferadresse entsprechend einer „Allow/Deny”-Liste zulässig ist. Über die Optionen kann festgelegt werden, für welche Länder die Regel greift und ob diese Liste Länder erlaubt oder verbietet.

Beispielkonfiguration

"validations": [
  {
    "options": {
      "countryList": [
        "general.country.gb"
      ],
      "rule": "deny"
    },
    "service": "paymentValidation.shippingCountry"
  }
]

Parameterübersicht

Parameter	Beschreibung
`countryList`	Liste der Länder, auf die diese Regel angewendet werden soll. (ISO-Länderkennungen, z.B. „`DE`”, „`AT`”, „`CH`”)
`rule`	Steuerung der Regel. Mögliche Werte: - `allow` - Länder, die in `countryList` stehen, sind erlaubt. - `deny` - Länder, die in `countryList` stehen, sind nicht erlaubt.

`paymentValidation.shippingMethod` - Validierung der Versandart für Zahlungsarten

Prüft, ob die gewählte Zahlart nur mit bestimmten Versandarten verwendet werden darf.

Beispielkonfiguration

"validations": [
  {
    "options": {
      "shippingMethods": [
        "shipping.method.dhl",
        "shipping.method.pickup"
      ],
      "rule": "allow"
    },
    "service": "paymentValidation.shippingMethod"
  }
]

Parameterübersicht

Parameter	Beschreibung
`shippingMethods`	Liste der Versandarten-IDs, auf die diese Regel angewendet werden soll. Die IDs entsprechen den internen Namen der Versandarten (z.B. `shipping.method.dhl`).
`rule`	Steuerung der Regel. Mögliche Werte: - `allow` - Versandarten, die in `shippingMethods` stehen, sind erlaubt. - `deny` - Versandarten, die in `shippingMethods` stehen, sind nicht erlaubt.

`paymentValidation.accountType` - Validierung des Kundentyps für Zahlungsarten

Prüft, ob die gewählte Zahlart nur für bestimmte Kundentypen verwendet werden darf (Gast, Neukunde oder Bestandskunde).

Beispielkonfiguration

"validations": [
  {
    "options": {
      "deny": [
        "guest",
        "newCustomer"
      ]
    },
    "service": "paymentValidation.accountType"
  }
]

Parameterübersicht

Parameter	Beschreibung
`deny`	Liste an Kundentypen, für die die Zahlart gesperrt ist. Mögliche Werte: - „`guest`” - Gastbesteller - „`newCustomer`” - Neukunde - „`customer`” - Bestandskunde

Wie der Kundentyp ermittelt wird

guest - Der Kunde bestellt als Gast (ohne Benutzerkonto).
newCustomer - Ein eingeloggter Kunde, der beim Login die in accounts.account.newCustomerRules konfigurierten Neukunden-Regeln erfüllt. Eine Neuregistrierung im Bestellablauf führt unabhängig von den Regeln immer zum Typ newCustomer.
customer - Jeder andere eingeloggte Kunde. Sind keine Neukunden-Regeln konfiguriert, gelten eingeloggte Kunden immer als customer.

Der hier geprüfte Kundentyp ist nicht identisch mit der Template-Variable $wsCheckout.accountType (guest / new / registered): Diese gibt die im Bestellablauf gewählte Anmeldemethode aus, während die Validierung zwischen Neu- und Bestandskunden (newCustomer / customer) unterscheidet. In den Bestelldaten werden customer und newCustomer beide als registered ausgegeben.

`paymentValidation.denyDifferingShippingAddress` - Validierung abweichender Lieferadressen für Zahlungsarten

Prüft, ob Rechnungsadresse und Lieferadresse identisch sind.
Die Zahlart ist nur erlaubt, wenn keine abweichende Lieferadresse verwendet wird.

Beispielkonfiguration

"validations": [
  {
    "service": "paymentValidation.denyDifferingShippingAddress"
  }
]

Parameterübersicht

Parameter	Beschreibung
—	Keine zusätzlichen Parameter.

`paymentValidation.voucherDeny` - Validierung von Gutscheinprodukten für Zahlungsarten

Prüft, ob Gutscheinprodukte im Warenkorb sind. Wenn Gutscheinprodukte im Warenkorb sind, ist diese Zahlart nicht erlaubt.

Beispielkonfiguration

"validations": [
  {
    "service": "paymentValidation.voucherDeny"
  }
]

Parameterübersicht

Parameter	Beschreibung
—	Keine zusätzlichen Parameter.

`paymentValidation.total` - Validierung von Mindest- / Maximalbestellwert für Zahlungsarten

Prüft, ob die Zahlart nur verwendet werden darf, wenn ein bestimmter Mindest- oder Maximalbestellwert erreicht bzw. überschritten wird.

Beispielkonfiguration

"validations": [
  {
    "options": {
      "total": 600,
      "type": "max"
    },
    "service": "paymentValidation.total"
  }
]

Parameterübersicht

Parameter	Beschreibung
`total`	Grenzwert der Gesamtsumme (Warenwert), ab bzw. bis zu der die Zahlart erlaubt ist.
`type`	Art der Prüfung. Mögliche Werte: - „`min`” - Die Zahlart ist nur erlaubt, wenn der Bestellwert mindestens `total` erreicht. - „`max`” - Die Zahlart ist nur erlaubt, wenn der Bestellwert `total` nicht überschreitet.

Wenn Mindest- und Maximalbestellwert gleichzeitig geprüft werden sollen, muss diese Prüfung zweimal mit unterschiedlichen Optionen konfiguriert werden.

`paymentValidation.inventoryState` - Validierung des Lagerbestandes für Zahlungsarten

Prüft, ob sich im Warenkorb Produkte mit einem bestimmten Lagerbestand befinden. Wenn ein Produkt im Warenkorb einen in deny konfigurierten Status hat, ist die Zahlungsart nicht erlaubt.

Beispielkonfiguration

"validations": [
  {
    "options": {
      "deny": [
        "red",
        "yellow"
      ]
    },
    "service": "paymentValidation.inventoryState"
  }
]

Parameterübersicht

Parameter	Beschreibung
`deny`	Liste an Lagerbestandsdaten, bei denen die Zahlungsart verboten ist. Mögliche Werte: - „`red`” - ausverkauft - „`yellow`” - nur noch wenige vorhanden - „`green`” - viele vorhanden Die Grenzwerte der einzelnen Lagerbestände werden in `content.inventory` festgelegt: content - Katalog (Kategorien & Produkte)

`paymentValidation.productDependency` - Validierung der Produkt-Abhängigkeiten für Zahlungsarten

Prüft die Produkte im Warenkorb anhand der Konfiguration checkout.productDependency.
Eine Zahlungsart wird nur angeboten, wenn alle referenzierten Produktabhängigkeiten erfüllt sind. Auf diese Weise koppeln Sie eine Zahlungsart an Warenkorb-Eigenschaften, ohne die Prüflogik zu duplizieren. Die eigentlichen Bedingungen (Produktfelder, Freifelder, Wertevergleiche) werden zentral in checkout.productDependency gepflegt.

Beispielkonfiguration

Die Option “Kauf auf Rechnung” soll gesperrt werden, sobald sich ein personalisiertes Produkt (z.B. mit Gravur) im Warenkorb befindet. Weil personalisierte Artikel nicht retournierbar sind, tragen sie ein höheres Zahlungsausfallrisiko. Die Bedingung “keine Gravur im Warenkorb” definieren Sie in checkout.productDependency und referenzieren sie anschließend hier.

"validations": [
  {
    "options": {
      "list": [
        "checkout.productDependency.noEngraving"
      ]
    },
    "service": "paymentValidation.productDependency"
  }
]

Parameterübersicht

Parameter	Beschreibung
`list`	Liste mit IDs der Konfigurationen aus checkout.productDependency, die geprüft werden sollen. Damit die Validierung erfolgreich ist und die Zahlungsart angeboten wird, müssen alle hier angegebenen Werte erfüllt sein.

`paymentValidation.userAgent` - Validierung des User-Agents für Zahlungsarten

Prüft, ob eine Zahlungsart basierend auf dem genutzten Gerät oder Browser des Kunden angezeigt wird. Geräte und Browser übermitteln beim Seitenaufruf automatisch eine technische Kennung, den sogenannten User-Agent. Anhand dieser Kennung lässt sich z.B. erkennen, ob jemand ein iPhone, ein iPad oder einen Mac verwendet. Die in userAgents eingetragenen Begriffe werden gegen diese Kennung geprüft, ein Treffer genügt. So lässt sich eine Zahlungsart gezielt nur für bestimmte Geräte oder Browser freischalten oder sperren, z.B. wenn Apple Pay nur für Kunden angezeigt werden soll, die ein Apple-Gerät oder einen kompatiblen Browser verwenden.

Beispielkonfiguration

"validations": [
  {
    "options": {
      "userAgents": [
        "Macintosh",
        "Mac OS X",
        "iPhone",
        "iPad"
      ],
      "rule": "allow"
    },
    "service": "paymentValidation.userAgent"
  }
]

Parameterübersicht

Parameter	Beschreibung
`userAgents`	Liste von Begriffen, die in der Gerät-/Browser-Kennung des Kunden gesucht werden. Ein Treffer genügt. Die Werte sind nicht durch WEBSALE vorgegeben, sondern entsprechen den tatsächlichen Zeichenketten, die das jeweilige Gerät oder der Browser übermittelt. Die korrekten Werte müssen selbst am jeweiligen Gerät ermittelt werden, z.B. über die Browser-Konsole.
`rule`	Steuerung der Regel. Mögliche Werte: - `allow` - Zahlart wird nur angezeigt, wenn mindestens ein Begriff aus `userAgents` erkannt wird. - `deny` - Zahlart wird ausgeblendet, wenn ein Treffer gefunden wird.

`shippingMethodValidation.*` - Versandarten-Validierung

shippingMethodValidation.* enthält Regeln, mit denen festgelegt wird, ob eine Versandart im Checkout erlaubt ist. Die Prüfung kann z.B. vom Lieferland, vom Warenwert, von Produkttypen oder von der gewählten Zahlungsart abhängen. Diese Regeln können in der Konfiguration der jeweiligen Versandart unter validations eingetragen werden. Das Frontend stellt dann nur die Versandarten bereit, die zu den aktuellen Bedingungen passen. Auswertung im Frontend Im Template werden die konfigurierten Regeln über die Methode $wsCheckout.isValidShippingMethod(shippingMethodId) ausgewertet (gleiches Muster wie bei den Zahlungsarten). Die Gründe für eine deaktivierte Versandart lassen sich zusätzlich über $wsCheckout.getShippingMethodDisabledErrors(shippingMethodId) ausgeben.

`shippingMethodValidation.shippingCountry` - Validierung des Landes (Lieferadresse)

Beispielkonfiguration

"validations": [
  {
    "options": {
      "countryList": [
        "general.country.de",
        "general.country.at"
      ],
      "rule": "allow"
    },
    "service": "shippingMethodValidation.shippingCountry"
  }
]

Parameterübersicht

Parameter	Beschreibung
`countryList`	Liste der Länder, auf die diese Regel angewendet werden soll. (ISO-Länderkennungen, z.B. „`DE`”, „`AT`”, „`CH`”)
`rule`	Steuerung der Regel. Mögliche Werte: - `allow` - Länder, die in `countryList` stehen, sind erlaubt. - `deny` - Länder, die in `countryList` stehen, sind nicht erlaubt.

`shippingMethodValidation.paymentMethod` - Validierung der Zahlungsart für Versandarten

Prüft, ob eine Versandart nur mit bestimmten Zahlungsarten verwendet werden darf.

Beispielkonfiguration

"validations": [
  {
    "options": {
      "paymentMethods": [
        "payment.method.invoice",
        "payment.method.prepayment"
      ],
      "rule": "allow"
    },
    "service": "shippingMethodValidation.paymentMethod"
  }
]

Parameterübersicht

Parameter	Beschreibung
`paymentMethods`	Liste der Zahlungsarten-IDs, die auf diese Regel angewendet werden. Die IDs entsprechen den internen Namen der Zahlungsarten (z.B. `payment.method.invoice`)
`rule`	Steuerung der Regel. Mögliche Werte: - `allow` - Zahlungsarten, die in `paymentMethods` stehen, sind erlaubt. - `deny` - Zahlungsarten, die in `paymentMethods` stehen, sind nicht erlaubt.

`shippingMethodValidation.valueOfGoods` - Validierung des Mindest-/Maximalbestellwerts für Versandarten

Prüft, ob die Versandart nur verwendet werden darf, wenn ein bestimmter Mindest- oder Maximalbestellwert erreicht bzw. überschritten wird.

Beispielkonfiguration

"validations": [
  {
    "options": {
      "valueOfGoods": 100,
      "type": "min"
    },
    "service": "shippingMethodValidation.valueOfGoods"
  }
]

Parameterübersicht

Parameter	Beschreibung
`valueOfGoods`	Grenzwert der Gesamtsumme (Warenwert), ab bzw. bis zu der die Versandart erlaubt ist.
`type`	Art der Prüfung. Mögliche Werte: - „`min`” - Die Versandart ist nur erlaubt, wenn der Bestellwert mindestens `valueOfGoods` erreicht. - „`max`” - Die Versandart ist nur erlaubt, wenn der Bestellwert `valueOfGoods` nicht überschreitet.

`shippingMethodValidation.productType` - Validierung des Produkttyps für Versandarten

Prüft, ob alle Produkte im Warenkorb einen passenden Produkttyp haben.

Beispielkonfiguration

"validations": [
  {
    "options": {
      "rule": "allow",
      "ruleList": [
        "productType.digital"
      ],
      "includeList": [
        "productType.service"
      ]
    },
    "service": "shippingMethodValidation.productType"
  }
]

Parameterübersicht

Parameter	Beschreibung
`rule`	Art der Prüfung. Mögliche Werte: - „`allow`” - Nur Produkttypen aus `ruleList` und `includeList` sind erlaubt. - „`deny`” - Produkttypen aus `ruleList` sind nicht erlaubt. Ausnahme: Produkttypen aus `includeList` sind immer erlaubt.
`ruleList`	Liste der Produkttypen, die - abhängig von `rule` - erlaubt oder nicht erlaubt sind.
`includeList`	Liste der Produkttypen, die immer erlaubt sind.

`shippingMethodValidation.productDependency` - Validierung der Produkt-Abhängigkeiten für Versandarten

Prüft die Produkte im Warenkorb anhand der Konfiguration checkout.productDependency.

Beispielkonfiguration

"validations": [
  {
    "options": {
      "list": [
        "checkout.productDependency.digitalOnly",
        "checkout.productDependency.noBulkyGoods"
      ]
    },
    "service": "shippingMethodValidation.productDependency"
  }
]

Parameterübersicht

Parameter	Beschreibung
`list`	Liste mit IDs der Konfigurationen aus `checkout.productDependency`, die geprüft werden sollen. Damit die Validierung erfolgreich ist, müssen alle hier angegebenen Werte erfüllt sein.

`shippingMethodValidation.expressCheckout` - Validierung des Express-Checkout für Versandarten

Prüft, ob eine Versandart abhängig von der im Express-Checkout verwendeten Zahlungsart erlaubt ist. Die Prüfung greift bei PayPal Express sowie Apple Pay und Google Pay Express (PayPal Commerce Platform).

Beispielkonfiguration

Die Versandart soll nicht wählbar sein, wenn der Kunde den Bestellvorgang als PayPal-Express-Checkout durchläuft:

"validations": [
  {
    "options": {
      "rule": "deny",
      "ruleList": [
        "paypalCheckout"
      ]
    },
    "service": "shippingMethodValidation.expressCheckout"
  }
]

Parameterübersicht

Parameter	Beschreibung
`rule`	Art der Prüfung. Mögliche Werte: - „`deny`” - Läuft der Bestellvorgang als Express-Checkout mit einer Zahlungsart aus `ruleList`, ist die Versandart gesperrt. Außerhalb des Express-Checkouts ist die Versandart erlaubt. - „`allow`” - Die Versandart ist nur erlaubt, wenn der Bestellvorgang als Express-Checkout mit einer Zahlungsart aus `ruleList` läuft. Im normalen Checkout (kein Express-Checkout aktiv) ist die Versandart damit immer gesperrt - `allow` definiert also eine reine Express-Checkout-Versandart.
`ruleList`	Liste der Zahlungsarten-IDs, die - abhängig von `rule` - im Express-Checkout erlaubt bzw. verboten sind. Die IDs entsprechen den Kennungen der Zahlarten aus payment.payment (z.B. `paypalCheckout`).

Schlägt die Prüfung fehl, liefert die Validierung den Fehler expressCheckoutDenied bzw. expressCheckoutNotAllowed; im Frontend lässt er sich über $wsCheckout.getShippingMethodDisabledErrors() ausgeben.

urls - URL (Webadressen)

⌘I

​addressCheck.* - Adressvalidierungen

​addressCheck.minLength - Mindestlänge

​Beispielkonfiguration für (accounts.addressField.firstName)

​Parameterübersicht

​addressCheck.maxLength - Maximallänge

​Beispielkonfiguration für (accounts.addressField.firstName)

​Parameterübersicht

​addressCheck.numeric - Nur Ziffern

​Beispielkonfiguration für (accounts.addressField.phone)

​Parameterübersicht

​addressCheck.country - Ländercode (ISO)

​Beispielkonfiguration für (accounts.addressField.country)

​Parameterübersicht

​addressCheck.zip - Postleitzahl (PLZ)

​Beispielkonfiguration für (accounts.addressField.zip)

​Parameterübersicht

​addressCheck.salutation - Anrede (Code)

​Beispielkonfiguration für (accounts.addressField.salutationCode)

​Parameterübersicht

​addressCheck.regex - Regulärer Ausdruck

​Beispielkonfiguration für (accounts.addressField.additionalInfo)

​Parameterübersicht

​addressCheck.phone - Telefonnummer

​Beispielkonfiguration für (accounts.addressField.phone)

​Parameterübersicht

​addressCheck.alpha - Nur Buchstaben (A–Z)

​Beispielkonfiguration für (accounts.addressField.additionalInfo)

​Parameterübersicht

​addressCheck.alphanum - Buchstaben/Ziffern (A–Z/0–9)

​Beispielkonfiguration für (accounts.addressField.additionalInfo)

​Parameterübersicht

​addressCheck.legalSigns - Erlaubte Zeichen

​Beispielkonfiguration für (accounts.addressField.additionalInfo)

​Parameterübersicht

​addressCheck.illegalSigns - Verbotene Zeichen

​Beispielkonfiguration für (accounts.addressField.phone)

​Parameterübersicht

​addressCheck.date - Datum

​Beispielkonfiguration für (accounts.addressField.additionalInfo)

​Parameterübersicht

​addressCheck.allowedSelection - Auswahl (Listenelement)

​Beispielkonfiguration für (accounts.addressField.addressType)

​Parameterübersicht

​dataChecker.* - Allgemeine Feldvalidierungen

​dataChecker.minLength - Mindestlänge

​Beispielkonfiguration für (inquiry.form.catalogue.fields.firstName)

​Parameterübersicht

​dataChecker.maxLength - Maximallänge

​Beispielkonfiguration für (inquiry.form.catalogue.fields.firstName)

​Parameterübersicht

​dataChecker.numeric - Nur Ziffern

​Beispielkonfiguration für (inquiry.form.catalogue.fields.phone)

​Parameterübersicht

​dataChecker.country - Ländercode (ISO)

​Beispielkonfiguration für (inquiry.form.catalogue.fields.country)

​Parameterübersicht

​dataChecker.zip - Postleitzahl (PLZ)

​Beispielkonfiguration für (inquiry.form.catalogue.fields.zip)

​Parameterübersicht

​dataChecker.salutation - Anrede (Code)

​Beispielkonfiguration für (inquiry.form.catalogue.fields.salutation)

​Parameterübersicht

​dataChecker.regex - Regulärer Ausdruck

​Beispielkonfiguration für (inquiry.form.catalogue.fields.additionalInfo)

​Parameterübersicht

​dataChecker.email - E‑Mail-Adresse

​Beispielkonfiguration für (inquiry.form.catalogue.fields.mail)

​Parameterübersicht

​dataChecker.alphaClass - Buchstaben (min/verschiedene)

​Beispielkonfiguration für (inquiry.form.catalogue.fields.additionalInfo)

​Parameterübersicht

​dataChecker.lowerAlphaClass - Kleinbuchstaben

​Beispielkonfiguration für (inquiry.form.catalogue.fields.additionalInfo)

​Parameterübersicht

​dataChecker.upperAlphaClass - Großbuchstaben

​Beispielkonfiguration für (inquiry.form.catalogue.fields.additionalInfo)

​Parameterübersicht

​dataChecker.digitClass - Ziffern

​Beispielkonfiguration für (inquiry.form.catalogue.fields.additionalInfo)

​Parameterübersicht

`addressCheck.*` - Adressvalidierungen

`addressCheck.minLength` - Mindestlänge

Beispielkonfiguration für (`accounts.addressField.firstName`)

Parameterübersicht

`addressCheck.maxLength` - Maximallänge

Beispielkonfiguration für (`accounts.addressField.firstName`)

Parameterübersicht

`addressCheck.numeric` - Nur Ziffern

Beispielkonfiguration für (`accounts.addressField.phone`)

Parameterübersicht

`addressCheck.country` - Ländercode (ISO)

Beispielkonfiguration für (`accounts.addressField.country`)

Parameterübersicht

`addressCheck.zip` - Postleitzahl (PLZ)

Beispielkonfiguration für (`accounts.addressField.zip`)

Parameterübersicht

`addressCheck.salutation` - Anrede (Code)

Beispielkonfiguration für (`accounts.addressField.salutationCode`)

Parameterübersicht

`addressCheck.regex` - Regulärer Ausdruck

Beispielkonfiguration für (`accounts.addressField.additionalInfo`)

Parameterübersicht

`addressCheck.phone` - Telefonnummer

Beispielkonfiguration für (`accounts.addressField.phone`)

Parameterübersicht

`addressCheck.alpha` - Nur Buchstaben (A–Z)

Beispielkonfiguration für (`accounts.addressField.additionalInfo`)

Parameterübersicht

`addressCheck.alphanum` - Buchstaben/Ziffern (A–Z/0–9)

Beispielkonfiguration für (`accounts.addressField.additionalInfo`)

Parameterübersicht

`addressCheck.legalSigns` - Erlaubte Zeichen

Beispielkonfiguration für (`accounts.addressField.additionalInfo`)

Parameterübersicht

`addressCheck.illegalSigns` - Verbotene Zeichen

Beispielkonfiguration für (`accounts.addressField.phone`)

Parameterübersicht

`addressCheck.date` - Datum

Beispielkonfiguration für (`accounts.addressField.additionalInfo`)

Parameterübersicht

`addressCheck.allowedSelection` - Auswahl (Listenelement)

Beispielkonfiguration für (`accounts.addressField.addressType`)

Parameterübersicht

`dataChecker.*` - Allgemeine Feldvalidierungen

`dataChecker.minLength` - Mindestlänge

Beispielkonfiguration für (`inquiry.form.catalogue.fields.firstName`)

Parameterübersicht

`dataChecker.maxLength` - Maximallänge

Beispielkonfiguration für (`inquiry.form.catalogue.fields.firstName`)

Parameterübersicht

`dataChecker.numeric` - Nur Ziffern

Beispielkonfiguration für (`inquiry.form.catalogue.fields.phone`)

Parameterübersicht

`dataChecker.country` - Ländercode (ISO)

Beispielkonfiguration für (`inquiry.form.catalogue.fields.country`)

Parameterübersicht

`dataChecker.zip` - Postleitzahl (PLZ)

Beispielkonfiguration für (`inquiry.form.catalogue.fields.zip`)

Parameterübersicht

`dataChecker.salutation` - Anrede (Code)

Beispielkonfiguration für (`inquiry.form.catalogue.fields.salutation`)

Parameterübersicht

`dataChecker.regex` - Regulärer Ausdruck

Beispielkonfiguration für (`inquiry.form.catalogue.fields.additionalInfo`)

Parameterübersicht

`dataChecker.email` - E‑Mail-Adresse

Beispielkonfiguration für (`inquiry.form.catalogue.fields.mail`)

Parameterübersicht

`dataChecker.alphaClass` - Buchstaben (min/verschiedene)

Beispielkonfiguration für (`inquiry.form.catalogue.fields.additionalInfo`)

Parameterübersicht

`dataChecker.lowerAlphaClass` - Kleinbuchstaben

Beispielkonfiguration für (`inquiry.form.catalogue.fields.additionalInfo`)

Parameterübersicht

`dataChecker.upperAlphaClass` - Großbuchstaben

Beispielkonfiguration für (`inquiry.form.catalogue.fields.additionalInfo`)

Parameterübersicht

`dataChecker.digitClass` - Ziffern

Beispielkonfiguration für (`inquiry.form.catalogue.fields.additionalInfo`)

Parameterübersicht