Fehlerbehebung

Modul lässt sich nicht aktivieren

Wenn die Aktivierung von Stripe Payment mit folgender Meldung scheitert, ist das Modul OXID Payment Base nicht aktiv:

Module "oe_payments_stripe_wallet" has unfulfilled dependencies in shop "1" and can not be activated.
"oe_payments_stripe_wallet" requires the following modules to be activated: "oe_payment_base"

Vorgehen

  1. Aktivieren Sie zuerst OXID Payment Base:

    ./vendor/bin/oe-console oe:module:activate oe_payment_base
    
  2. Aktivieren Sie anschließend Stripe Payment:

    ./vendor/bin/oe-console oe:module:activate oe_payments_stripe_wallet
    

In einem Shop mit Subshops gilt die Abhängigkeit pro Subshop: Aktivieren Sie OXID Payment Base in jedem Subshop, in dem Sie Stripe Payment nutzen wollen.

Datenbanktabellen fehlen

Wenn Zahlungsvorgänge scheitern und im Log ein Datenbankfehler wie Table '…oe_payments_contract' doesn't exist steht, wurden die Datenbank-Migrationen von OXID Payment Base nicht ausgeführt.

Vorgehen

  1. Führen Sie im Root-Verzeichnis Ihres eShops die Migrationen aus:

    ./vendor/bin/oe-eshop-db_migrate migrations:migrate
    
  2. Leeren Sie den Cache:

    ./vendor/bin/oe-console oe:cache:clear
    

Weitere Informationen finden Sie unter Installation, Schritt „Datenbank-Migrationen ausführen“.

Logging für die Fehlersuche hochsetzen

Wenn Zahlungsvorgänge mit Stripe Payment nicht erwartungsgemäß funktionieren, erhöhen Sie die Protokollierungsstufe, um die Ursache einzugrenzen.

Vorgehen

  1. Wählen Sie Erweiterungen ‣ Module ‣ Stripe Payment ‣ Einstell..

  2. Wählen Sie unter Protokollierung im Feld Protokollierungsstufe den Wert Debug (alle Kanäle + Browser-Konsole).

  3. Stellen Sie sicher, dass das Kontrollkästchen Webhooks protokollieren aktiviert ist.

  4. Speichern Sie Ihre Eingaben.

  5. Reproduzieren Sie den fehlerhaften Vorgang.

Resultat

Stripe Payment schreibt Log-Dateien mit Tages-Stempel in das Verzeichnis <Root-Verzeichnis Ihres OXID eShops>/log/stripe/:

  • stripe_requests_JJJJ-MM-TT.log – API-Requests und -Responses

  • stripe_webhooks_JJJJ-MM-TT.log – eingehende Webhook-Aufrufe von Stripe

  • stripe_events_JJJJ-MM-TT.log – interne Event-Verarbeitung

  • stripe_reconciliation_JJJJ-MM-TT.log – Ergebnisse des Bestellabgleichs (Console-Command stripe:reconcile-oxpaid)

In der Stufe Debug gibt das Modul zusätzlich Diagnosemeldungen in der Browser-Konsole aus.

Note

Setzen Sie die Protokollierungsstufe nach der Fehlersuche wieder auf Normal (Anfragen + Abstimmung) zurück, um die Menge der gespeicherten Daten gering zu halten.

Weitere Informationen zu den Protokollierungsstufen finden Sie unter Protokollierung konfigurieren.

Webhook-Probleme beheben

Wenn Statusmeldungen von Stripe nicht in Ihrem OXID eShop ankommen, prüfen Sie den Webhook.

Vorgehen

  1. Wählen Sie Erweiterungen ‣ Module ‣ Stripe Payment ‣ Einstell..

  2. Öffnen Sie den Bereich Webhooks.

  3. Prüfen Sie, ob neben dem Feld Webhook Endpoint der Status Konfiguriert angezeigt wird.

    Wird Nicht konfiguriert angezeigt, legen Sie den Webhook neu an (siehe Webhook anlegen).

  4. Wenn der Webhook konfiguriert ist, die Meldungen aber dennoch ausbleiben, setzen Sie ihn zurück:

    1. Wählen Sie die Schaltfläche Alle Webhooks löschen und bestätigen Sie die Rückfrage.

    2. Wählen Sie die Schaltfläche Webhooks erstellen.

    3. Speichern Sie Ihre Eingaben.

Resultat

Der Webhook-Endpunkt und sein Sicherheitsschlüssel werden neu erzeugt, neben dem Webhook Endpoint wird wieder der Status Konfiguriert angezeigt.

Important

Nach einem Update auf Version 3.5 einmal das Modul aktivieren

Ab Version 3.5 speichert das Modul den Sicherheitsschlüssel des Webhooks getrennt für Test- und Live-Modus. Einen Schlüssel aus einer älteren Version übernimmt es beim Aktivieren des Moduls einmalig.

Wurde das Modul nach dem Update nicht neu aktiviert, lehnt Ihr eShop alle Webhook-Aufrufe von Stripe ab. Deaktivieren und aktivieren Sie das Modul in diesem Fall einmal, oder führen Sie den Befehl ./vendor/bin/oe-console oe:module:activate oe_payments_stripe_wallet aus. Alternativ wählen Sie Webhooks erstellen.

Note

Die Schaltfläche Alle Webhooks löschen entfernt die für diesen Shop registrierten Webhook-Endpunkte in Ihrem Stripe-Plattform-Account.

Um eingehende Webhook-Aufrufe mitzuschneiden, aktivieren Sie unter Protokollierung das Kontrollkästchen Webhooks protokollieren.