Fehlerbehebung für Adobe Commerce

Verwenden Sie diesen Leitfaden für die Fehlerbehebung im Zusammenhang mit dem Stripe Connector for Adobe Commerce.

Installationsprobleme

Das häufigste Problem während des Installationsvorgangs ist die folgende Fehlermeldung bei Verwendung von Composer:

Composer package not found: Could not find a matching version of package stripe/stripe-payments

Wenn dieses Problem auftritt, führen Sie die folgenden Schritte aus:

1. Bestellen Sie das Modul über den Adobe Marketplace.
2. Falls Sie die falschen Adobe Commerce-API-Schlüssel eingegeben haben, löschen Sie die Datei unter ~/.composer/auth.json.
3. Führen Sie den Composer-Befehl erneut aus. Möglicherweise müssen Sie einen Nutzernamen und ein Passwort eingeben. Stellen Sie sicher, dass Sie die Adobe Commerce-API-Schlüssel des Kontos eingeben, über das Sie die Bestellung aufgegeben haben. Ihre Authentifizierungsschlüssel erhalten Sie von Adobe Commerce.

Upgrades und Caching-Probleme

Wenn Sie das Modul aktualisieren, aber die Änderungen aus irgendeinem Grund nicht angezeigt werden, können Sie den Cache von Adobe Commerce manuell löschen, indem Sie einige Verzeichnisse löschen. In der offiziellen Dokumentation von Adobe Commerce wird beschrieben, welche Verzeichnisse für Adobe Commerce 2.3 und Adobe Commerce 2.4 gelöscht werden müssen.

Führen Sie nach dem Löschen dieser Verzeichnisse die folgenden Befehle aus:

php bin/magento setup:upgrade
php bin/magento cache:flush

Im Produktionsbetrieb müssen Sie Adobe Commerce neu kompilieren und Ihre statischen Ressourcen bereitstellen:

php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

Wenn Sie Varnish ausführen, müssen Sie nach dem Löschen der Dateien unter var/cache/* Varnish neu starten. Es gibt außerdem Browser, die Adobe Commerce-Anfragen im Cache zwischenspeichern. Wenn Sie weiterhin Cache-Probleme haben, wählen Sie einen anderen Browser.

Keine Zahlungsmethode beim Bezahlvorgang

Die Zahlungsmethode wird möglicherweise aus den folgenden Gründen beim Bezahlvorgang nicht angezeigt:

• Die Stripe-PHP-Bibliothek fehlt, oder Sie nutzen eine ältere Version. Sie können diese Abhängigkeit in Schritt 3 der Installationsanweisungen installieren.
• Sie haben ein anderes Stripe-Modul installiert, das eine ältere Version der Stripe-PHP-Bibliothek verwendet. Deaktivieren oder deinstallieren Sie alle anderen aktiven Stripe-Module.
• Sie haben die Stripe-API-Schlüssel nicht ordnungsgemäß konfiguriert.
• Sie haben die Verfügbarkeit der Zahlungsmethode auf bestimmte Länder oder Währungen begrenzt.

Apple Pay oder Google Pay werden nicht angezeigt

Wenn Sie die Schaltfläche für Zahlungsanfragen konfiguriert haben und sie weiterhin nicht angezeigt wird, versuchen Sie Folgendes:

• Achten Sie darauf, dass Apple Pay und Google Pay in Ihren Einstellungen für Zahlungsmethoden aktiviert sind.
• Verwenden Sie für Apple Pay Safari auf einem iPhone unter iOS 10 und höher.
• Verwenden Sie für Google Pay Chrome Desktop oder Chrome Mobile mit einem angemeldeten Google-Konto.
• Stellen Sie sicher, dass Sie mindestens eine Karte in Ihrer Wallet haben.
  • In iOS können Sie eine Karte hinzufügen, indem Sie zu Einstellungen > Wallet > Apple Pay gehen.
  • In Chrome können Sie eine Karte hinzufügen, indem Sie zu Einstellungen > Autofill > Zahlungsmethoden > Neue Kreditkarte hinzufügen gehen.
• Bestätigen Sie, dass Ihr iOS-Gerät Apple Pay unterstützt.
• Bestätigen Sie, dass Ihr Android-Gerät Google Pay unterstützt.
• Bestätigen Sie, dass Ihre Domain registriert ist und verifiziert wurde.
• Wenn Ihre Website mit www beginnt, müssen Sie sicherstellen, dass die Domain www.example.com ist und nicht example.com.
• Sie müssen Ihre Website mit einem gültigen TLS 1.2-Zertifikat über HTTPS bereitstellen. Prüfen Sie dies in Ihrem Browser oder über SSL Labs.
• Stellen Sie sicher, dass Ihre HTTPS-Seite weder Bilder, noch CSS oder JavaScript auf unsichere Weise lädt. Dies können Sie prüfen, indem Sie auf das Schloss-Symbol in der URL-Leiste Ihres Browsers klicken.
• Achten Sie darauf, dass die Schaltfläche Wallet im Konfigurationsabschnitt des Moduls aktiviert ist.
• Vergessen Sie nicht, ein Zweitland als Standard zu konfigurieren (Stores > Konfiguration > Allgemein > Länderoptionen > Standardland).
• Vergewissern Sie sich, dass Sie keinen älteren Stripe-API-Schlüssel verwenden. Apple Pay verlangt einen modernen API-Schlüssel, der mit pk_live_ oder pk_test_ beginnt. Sie können Ihren zu veröffentlichenden Schlüssel im Abschnitt Entwickler/innen des Dashboards neu generieren.
• Wenn Sie ein OneStepCheckout-Modul verwenden, müssen Sie das OSC-Modul möglicherweise zusätzlich so konfigurieren, dass das Zahlungsformular aktualisiert wird, wenn Gastkundinnen/Gastkunden ihre Rechnungsadresse übermitteln. In den meisten Fällen ist dies nicht nötig.

Wenn Apple Pay beim Bezahlvorgang, aber nicht auf den Produktseiten angezeigt wird, kann es hierfür weitere Gründe geben:

• Sie haben Bezahlvorgänge als Gast über den Adobe Commerce-Admin deaktiviert.
• Ihre Website stellt Ihre Produktseiten ohne gültiges TLS 1.2-Zertifikat bereit.
• Sie haben die Vorlage für die Schaltfläche In den Warenkorb in Ihrem Design überschrieben. Versuchen Sie, Text zu app/code/StripeIntegration/Payments/view/frontend/templates/express/product_button.phtml hinzuzufügen. Wenn Ihre Produktseiten unverändert bleiben, passen Sie Ihr Design an und integrieren Sie die beiden Vorlagen zusammen.
• Bei der Initialisierung von Stripe.js treten JavaScript-Fehler auf. Prüfen Sie Ihre Browserkonsole auf JavaScript-Fehler im Zusammenhang mit Stripe.js.

Ausstehende Bestellung ist hängen geblieben

Eine neu erstellte Bestellung hat zunächst den Status Pending Payment. Das bedeutet, dass die Autorisierung der Zahlung durch die Kundenbank noch aussteht. Bei allen auf Weiterleitungen basierenden Zahlungsmethoden erhält Ihre Website bei Autorisierung eine Benachrichtigung von Stripe mittels Webhooks. Wenn der Status Ihrer Bestellungen nicht von Pending Payment in Processing geändert wird, weist dies möglicherweise darauf hin, dass Webhooks fehlen oder falsch sind.

Rufen Sie Ihre Webhook-Einstellungen auf, um zu prüfen, ob ein Webhook-Endpoint mit Ihrer Store-URL vorhanden ist. Wenn nicht, können Sie versuchen, manuell einen zu erstellen, indem Sie den folgenden Befehl aus Ihrem Magento-Stammverzeichnis ausführen:

bin/magento stripe:webhooks:configure

Wenn der Webhook-Endpoint bereits existiert, überprüfen Sie die Fehlerquote, um die fehlerhaften Webhooks zu identifizieren. Sie können auf den Webhook-Endpoint klicken, um die Fehlermeldungen anzuzeigen. Hilfe bei Webhook-Problemen, die nicht auf eine falsche Serverkonfiguration zurückzuführen sind, erhalten Sie beim Stripe-Support. Hier können Sie uns Einzelheiten zu den aufgetretenen Fehlern mitteilen.

Nachdem das Webhook-Problem behoben wurde, müssen Sie die charge.succeeded-Ereignisse, die nicht korrekt an Ihre Website übermittelt wurden, erneut senden. Das Modul bietet drei Befehle, um ein einzelnes Ereignis, eine Reihe von Ereignissen oder Ereignisse innerhalb eines Datumsbereichs erneut zu senden:

bin/magento stripe:webhooks:process-event [-f|--force] <event_id>
bin/magento stripe:webhooks:process-events-range <from_event_id> <to_event_id>
bin/magento stripe:webhooks:process-events-date-range <from_date> [<to_date>]

Sie können eine Liste aller fehlgeschlagenen charge.succeeded-Ereignisse im Entwicklerbereich Ihres Stripe-Dashboards abrufen und entscheiden, welche mithilfe der vorstehenden Befehle erneut gesendet werden sollen.

Fehlerprotokollierung und serverseitige Fehler (HTTP 500)

Adobe Commerce protokolliert alle während der Laufzeit der Anwendung auftretenden Fehler und Ausnahmen im Verzeichnis var/log. Sie finden diese Fehler in den folgenden zwei Dateien:

var/log/system.log
var/log/exception.log

Wenn Sie SSH-Zugriff haben, können Sie die Fehlermeldungen mit dem folgenden Befehl filtern:

grep -i Stripe var/log/system.log

Sie können Fehler live in der Konsole anzeigen lassen, wenn sie auftreten (oder wenn Sie eine bestimmte Seite aktualisieren). Führen Sie zur Überwachung von Fehlern den folgenden Befehl aus, um das Fehlerprotokoll einzusehen:

tail -f var/log/*

Wenn sie nicht über Shell-Zugriff verfügen, können Sie diese Datei herunterladen und mit einem Texteditor nach Stripe-Fehlern suchen.