Fehlerbehebung

Die häufigsten Ursachen, wenn ein Login-Code nicht ankommt oder eine unerwartete Meldung erscheint – und wo Sie nachsehen. Alle Punkte auf dieser Seite entsprechen dem tatsächlichen Verhalten der Erweiterung.

Kein Login-Code per E-Mail

Prüfen Sie der Reihe nach:

• Adresse registriert? Die Versand-Meldung erscheint aus Sicherheitsgründen immer – auch wenn zur Adresse kein Kundenkonto existiert. Ohne Konto wird keine E-Mail versendet. Prüfen Sie die Schreibweise der Adresse.
• Spam-Ordner: Die E-Mail kann im Spam gelandet sein.
• Ratenbegrenzung: Mehr als 3 Anfragen pro Minute (Standard) je Kombination aus Empfänger und IP-Adresse werden gedrosselt; die Meldung nennt die Wartezeit in Sekunden. Der Button „Code erneut senden“ wird erst nach 20 Sekunden wieder frei.
• Flow aktiv? Der Versand läuft über den Flow „Customer login code requested“. Ist er deaktiviert oder die Aktion „E-Mail versenden“ entfernt, kommt keine E-Mail an – das Formular zeigt trotzdem die Versand-Meldung. Siehe E-Mails.

Keine SMS kommt an

• Zugangsdaten: Prüfen Sie die Zugangsdaten des SMS-Anbieters mit der Schaltfläche „API-Zugangsdaten überprüfen“ direkt in der jeweiligen Anbieter-Karte der Einstellungen.
• Land nicht erlaubt: Ist die Ländervorwahl nicht in der Einstellung „Login per Handynummer erlauben“ ausgewählt, erscheint „Handynummern aus dem ausgewählten Land sind nicht erlaubt.“
• Ungültiges Format oder Festnetz: Es werden nur gültige Handynummern akzeptiert. Die Meldung nennt ein Beispiel im richtigen Format für das gewählte Land, z. B. „… das internationale Format, z. B. ‚+49 1512 3456789‘.“
• Unbekannte Nummer blockiert: Mit „Unbekannte Handynummern blockieren“ geht an nicht verknüpfte Nummern keine SMS; der Kunde sieht den Hinweis „Der Login per SMS ist für diese Handynummer nicht verfügbar.“
• Anbieter-Fehler: Schlägt die Anfrage an den Anbieter fehl, erscheint „Wir konnten den Login-Code nicht per SMS senden …“ – der Fehler steht im Fehlerprotokoll.

Die Meldung „Bitte bestätigen Sie Ihre E-Mail-Adresse“

Diese Meldung ist kein Fehler. Sie erscheint, wenn ein Kunde den Login-Code per SMS für eine Handynummer korrekt eingegeben hat, die noch keinem Kundenkonto zugeordnet ist. Die Anmeldung wird abgeschlossen, indem sich der Kunde in derselben Browser-Sitzung innerhalb von 20 Minuten mit einem Login-Code per E-Mail anmeldet – dabei wird die Nummer mit dem Konto verknüpft. Details unter Handynummern verknüpfen.

Vorlage oder Flow fehlt

Bei einer Deinstallation ohne Shopwares Option „Benutzerdaten behalten“ entfernt die Erweiterung ihre E-Mail-Vorlage, den Flow und ihre Datenbanktabellen vollständig. Eine anschließende Neuinstallation legt Vorlage und Flow wieder neu an – eigene Anpassungen der alten Vorlage sind dann nicht mehr vorhanden. Mit „Benutzerdaten behalten“ bleibt alles erhalten.

Wo Fehler protokolliert werden

Die Erweiterung schreibt Fehler in eine eigene Protokolldatei: var/log/cwk_quick_auth_<Umgebung>.log (z. B. cwk_quick_auth_prod.log), mit Dateirotation und nur für Einträge ab dem Schweregrad „Fehler“. Bei SMS-Problemen und fehlgeschlagenen Verknüpfungen sehen Sie zuerst dort nach. Fragen: support@commercewerk.de.