Weiter zum Inhalt
Konto erstellen
oder
anmelden
Das Logo der Stripe-Dokumentation
/
KI fragen
Konto erstellen
Anmelden
Jetzt starten
Zahlungen
Finanzautomatisierung
Plattformen und Marktplätze
Geldmanagement
Entwickler-Tools
Jetzt starten
Zahlungen
Finanzautomatisierung
Jetzt starten
Zahlungen
Finanzautomatisierung
Plattformen und Marktplätze
Geldmanagement
Übersicht
Versionierung
Änderungsprotokoll
Aktualisieren Sie Ihre API-Version
Ihre SDK-Version aktualisieren
Entwickler-Tools
SDKs
API
Tests
Workbench
Ereignisziele
Arbeitsabläufe
Stripe-CLI
Stripe Shell
Entwickler-Dashboard
Agent-Toolkit
Stripe-StatuswarnungenBuild with LLMsStripe für Visual Studio CodeHochgeladene Dateien
Sicherheit
Sicherheit
Extend Stripe
Stripe-Apps
Stripe Connectors
    Übersicht
    Einen Connector integrieren
    Commercetools
    Adobe Commerce
      Payments und Stripe Tax Connector for Adobe Commerce
        Installation
        Konfiguration
        Abonnements nutzen
        Das Admin-Panel verwenden
        Nutzerdefinierte Storefront erstellen
        Steuererhebung und Berichterstattung automatisieren
        Versionshistorie
        Fehlerbehebung
      Eigenständiger Tax Connector for Adobe Commerce
      Cookbooks
    Mirakl
    NetSuite
    Oracle Opera
    Cegid
    PrestaShop
    Salesforce
    SAP
    Shopware 6
    Stripe Tax für WooCommerce
    Stripe Tax for BigCommerce
    Partner Connectors
    Entwickeln Sie Ihren eigenen Connector
Partner
Partner-Ecosystem
Partner-Zertifizierung
StartseiteEntwickler-ToolsStripe ConnectorsAdobe CommercePayments and tax connector for Adobe Commerce

Fehlerbehebung für Adobe Commerce

Erfahren Sie, wie Sie Fehler im Zusammenhang mit Stripe Connector for Adobe Commerce beheben können.

Seite kopieren

In den Entwicklermodus wechseln

Aktivieren Sie den Entwicklermodus, damit Sie Fehler einfacher finden können.

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:

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

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

Command Line
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).
  • Stellen Sie sicher, dass Sie keinen älteren Stripe-API-Schlüssel verwenden. Apple Pay erfordert 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 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:

Command Line
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>]

Notiz

Sie können ein vollständiges Datum und eine vollständige Uhrzeit festlegen (2021-12-21 11:22:33+0200) oder eine beliebige englische Datums-/Uhrzeitbeschreibung in Textform verwenden (last Monday). Diese Funktion verwendet Ihre Standardzeitzone in Magento, sofern nicht anders angegeben.

Siehe strtotime für alle unterstützten Datumsformate.

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:

Command Line
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:

Command Line
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.

War diese Seite hilfreich?
JaNein
Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
Schauen Sie sich unser Änderungsprotokoll an.
Fragen? Sales-Team kontaktieren.
LLM? Lesen Sie llms.txt.
Unterstützt von Markdoc