actions - Anmeldung & Registrierung

Aktionen rund um Anmeldung und Registrierung im Shop: Fehlertexte und E-Mail-Vorlagen für Login, Kontoentsperrung sowie Passwort-Zurücksetzen.

Auf dieser Seite sind alle Aktionen dokumentiert, die den Anmelde- und Registrierungsprozess im Onlineshop betreffen. Hier sind alle Meldungen und E-Mail-Vorlagen dokumentiert, die beim Anmelden, Entsperren eines Kontos oder Zurücksetzen eines Passworts angezeigt bzw. versendet werden.

---

**Fehlertexte sind schreibgeschützt.** Die Fehlercode-Felder auf dieser Seite enthalten den Namen eines Textbausteins (ws.error.<configId>.<errorCode>), nicht den Fehlertext. Gepflegt wird der Text ausschließlich im Textbaustein-Dienst des Admin-Interface – Änderungen an der Konfiguration werden beim Speichern abgewiesen, auch über die [REST API](/schnittstellen/admin-interface-api/api-referenz-konfiguration). E-Mail-Vorlagen sind nicht betroffen.

​

Übersicht der Aktionen

Die hier aufgeführten Aktionen wurden thematisch gruppiert, um die zugehörigen Fehlermeldungen und E-Mail-Vorlagen übersichtlich darzustellen.

Aktionen, die inhaltlich zu einem anderen Themenbereich gehören, finden sich in den entsprechenden Abschnitten dieser Dokumentation oder in der alphabetischen Übersicht der Aktionen.

​

Auszug der Grundstruktur actions

{
  "actions": {
    "acceptInvitation": {...},
    "checkPasswordStrength": {...},
    "login": {...},
    "unlockLogin": {...},
    "passwordForgotten": {...},
    "resetPassword": {...}
  }
}

​

Aktionsübersicht

Aktion	Beschreibung
acceptInvitation	Definiert die Fehlermeldungen, die beim Annehmen einer Einladung zu einem B2B-Konto ausgegeben werden.
checkPasswordStrength	Steuert, ob der Shop die Stärke eines Passworts prüft.
login	Definiert die Fehlermeldungen, die beim Anmeldevorgang im Kundenkonto ausgegeben werden.
unlockLogin	Definiert die Fehlermeldungen, die beim Aufheben einer Login-Sperre ausgegeben werden.
passwordForgotten	Definiert die Fehlermeldungen, die beim “Passwort vergessen”-Vorgang ausgegeben werden, sowie die E-Mail, die versendet wird.
resetPassword	Definiert die Fehlermeldungen, die beim Ändern des Passworts ausgegeben werden.

---

​

actions.acceptInvitation - Einladung annehmen (B2B)

Mithilfe der Aktion acceptInvitation werden die Fehlermeldungen gesteuert, die ausgegeben werden, wenn ein eingeladener Nutzer eine B2B-Kontoeinladung über einen Double-Opt-In-Link annimmt.

​

Beispielkonfiguration

{
  "errorCodes": {
    "invalidAccountId": "<Textbaustein>",
    "actionNotAllowed": "<Textbaustein>"
  }
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
errorCodes	object	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
invalidAccountId	string	Fehlermeldung, die ausgegeben wird, wenn der Double-Opt-In-Token keinem Kundenkonto zugeordnet werden kann. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
actionNotAllowed	string	Fehlermeldung, die ausgegeben wird, wenn der Double-Opt-In-Token ungültig ist. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.

---

​

actions.checkPasswordStrength - Passwortstärke resp. Passwortsicherheit

Mit der Aktion checkPasswordStrength wird gesteuert, ob das Shopsystem bei Aktionen wie der Registrierung oder der Passwortänderung die Stärke eines Passworts serverseitig überprüft (beispielsweise anhand der Mindestlänge oder der Komplexität).

​

Beispielkonfiguration

{
  "active": true
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
active	bool	Aktiviert bzw. deaktiviert die serverseitige Prüfung der Passwortstärke. Default: true

---

​

actions.login - Anmeldung

Mithilfe der Aktion login wird definiert, welche Fehlermeldungen beim Anmeldevorgang im Kundenkonto ausgegeben werden.

​

Beispielkonfiguration

{
  "errorCodes": {
    "missingId": "<Textbaustein>",
    "missingPassword": "<Textbaustein>",
    "emailCheckFailed": "<Textbaustein>",
    "loginBlocked": "<Textbaustein>",
    "invalidCredentials": "<Textbaustein>",
    "ipAddressBlocked": "<Textbaustein>",
    "duplicatePendingReview": "<Textbaustein>",
    "passwordNotSet": "<Textbaustein>"
  }
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
errorCodes	object	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
missingId	string	Fehlermeldung, die ausgegeben wird, wenn keine Login-ID (beispielsweise E-Mail-Adresse) übermittelt wurde. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
missingPassword	string	Fehlermeldung, die ausgegeben wird, wenn kein Passwort übermittelt wurde. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
emailCheckFailed	string	Fehlermeldung, die ausgegeben wird, wenn die angegebene E-Mail-Adresse als ungültig bewertet wird. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
loginBlocked	string	Fehlermeldung, die ausgegeben wird, wenn das Benutzerkonto vorübergehend gesperrt ist. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
invalidCredentials	string	Fehlermeldung, die ausgegeben wird, wenn die Kombination aus E-Mail-Adresse und Passwort nicht stimmt. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
ipAddressBlocked	string	Fehlermeldung, die ausgegeben wird, wenn die aktuelle IP-Adresse blockiert ist (Blacklist). Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
duplicatePendingReview	string	Fehlermeldung, die ausgegeben wird, wenn eine Anmeldung nicht möglich ist, weil sich das Konto noch in der Duplettenprüfung befindet (siehe accounts.account → duplicate). Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
passwordNotSet	string	Fehlermeldung, die ausgegeben wird, wenn für das Mitarbeiterkonto noch kein Passwort vergeben wurde (nur bei aktivierten Mitarbeiterkonten). Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.

---

​

actions.unlockLogin - Anmeldung entsperren

Mit der Aktion unlockLogin können Fehlermeldungen definiert werden, die beim Aufheben einer Login-Sperre für ein Kundenkonto ausgegeben werden.

​

Beispielkonfiguration

{
  "errorCodes": {
    "unauthorized": "<Textbaustein>"
  }
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
errorCodes	object	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
unauthorized	string	Fehlermeldung, die ausgegeben wird, wenn die Entsperrung nicht zulässig ist (beispielsweise ungültiger Link oder fehlende Berechtigung). Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.

---

​

actions.passwordForgotten - Passwort vergessen

Mit der Aktion passwordForgotten werden die Fehlermeldungen definiert, die beim Vorgang „Passwort vergessen“ angezeigt werden.

​

Beispielkonfiguration

{
  "email": {
    "template": "password_forgotten.htm",
    "subject": "Passwort zurücksetzen",
    "fromAddress": "[e-mail]",
    "fromName": "Mein Onlineshop"
  },
  "errorCodes": {
    "missingEmail": "<Textbaustein>",
    "emailCheckFailed": "<Textbaustein>",
    "passwordRecoveryFailed": "<Textbaustein>"
  }
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
email	object	Konfiguriert die E-Mail, die beim Zurücksetzen des Passworts versendet wird. Betreff, Absender und Template werden über die allgemeinen E-Mail-Parameter gesteuert, siehe hier: E-Mail Einstellungen
errorCodes	object	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
missingEmail	string	Fehlermeldung, die ausgegeben wird, wenn keine E-Mail-Adresse übermittelt wurde. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
emailCheckFailed	string	Fehlermeldung, die ausgegeben wird, wenn die angegebene E-Mail-Adresse als ungültig bewertet wurde. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
passwordRecoveryFailed	string	Fehlermeldung, die ausgegeben wird, wenn der Passwort-Reset fehlschlägt. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.

---

​

actions.resetPassword - Passwort zurücksetzen

Mithilfe der Aktion resetPassword wird festgelegt, welche Fehlermeldungen beim Ändern des Passworts für ein bestehendes Kundenkonto ausgegeben werden und welche Prüfungen/Aktionen ausgeführt werden.

Das neue Passwort muss sich vom bisherigen Passwort unterscheiden. Nach einer erfolgreichen Änderung setzt der Shop die gespeicherten Auto-Login-Daten des Kontos zurück und beendet bestehende Sessions. Der Link aus der E-Mail zum Zurücksetzen des Passworts kann nur einmal verwendet werden.

​

Beispielkonfiguration

{
  "autoLogout": true,
  "checkOldPassword": true,
  "checkLoginID": false,
  "errorCodes": {
    "notLoggedIn": "<Textbaustein>",
    "missingEmail": "<Textbaustein>",
    "emailMismatch": "<Textbaustein>",
    "missingPassword": "<Textbaustein>",
    "passwordMismatch": "<Textbaustein>",
    "missingPasswordAuth": "<Textbaustein>",
    "failedPasswordAuth": "<Textbaustein>",
    "passwordCheckFailed": "<Textbaustein>",
    "samePassword": "<Textbaustein>"
  }
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
autoLogout	bool	Legt fest, ob der Kunde nach einer erfolgreichen Passwortänderung automatisch ausgeloggt wird. Gilt nicht, wenn die Änderung über einen Opt-In-Token erfolgt. Default: true
checkOldPassword	bool	Gibt an, ob zur Änderung des Passworts zusätzlich das bisherige Passwort (passwordAuth) abgefragt und geprüft werden soll. Gilt nicht, wenn die Änderung über einen Opt-In-Token erfolgt. Default: true
checkLoginID	bool	Wenn true, wird zusätzlich geprüft, ob die im Parameter email angegebene Login-ID/E-Mail mit dem Konto übereinstimmt. Default: false
errorCodes	object	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
notLoggedIn	string	Fehlermeldung, die ausgegeben wird, wenn der Benutzer nicht eingeloggt ist. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
missingEmail	string	Fehlermeldung, die ausgegeben wird, wenn keine E-Mail-Adresse übermittelt wurde. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
emailMismatch	string	Fehlermeldung, die ausgegeben wird, wenn die angegebene E-Mail-Adresse nicht zum Konto gehört. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
missingPassword	string	Fehlermeldung, die ausgegeben wird, wenn kein Passwort übermittelt wurde. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
passwordMismatch	string	Fehlermeldung, die ausgegeben wird, wenn Passwort und Passwort-Bestätigung nicht übereinstimmen. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
missingPasswordAuth	string	Fehlermeldung, die ausgegeben wird, wenn das aktuelle Passwort als Bestätigung erforderlich, aber nicht angegeben ist. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
failedPasswordAuth	string	Fehlermeldung, die ausgegeben wird, wenn das eingegebene, aktuelle Passwort, nicht korrekt ist. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
passwordCheckFailed	string	Fehlermeldung, die ausgegeben wird, wenn das Passwort die Mindestanforderungen nicht erfüllt. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
samePassword	string	Fehlermeldung, die ausgegeben wird, wenn das neue Passwort mit dem bisherigen Passwort übereinstimmt. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.