VibeFox Stripe for OpenCart — Hilfe

Voraussetzungen

OpenCart: 3.0.x (getestet mit 3.0.5.0) oder 4.0.2 und neuer (getestet mit 4.1.0.3).

PHP: 8.0 oder neuer.

Stripe-Konto: Sie benötigen die geheimen API-Schlüssel Ihres Stripe-Kontos und einen Webhook-Endpunkt im Stripe Dashboard (siehe Konfiguration). Verwendet werden nur die geheimen Schlüssel und die Signaturgeheimnisse der Webhooks. Die veröffentlichbaren Schlüssel (pk_...) werden nicht benötigt, da Stripe Checkout eine von Stripe gehostete Seite ist.

VibeFox-Lizenzschlüssel: Erwerb auf vibefox.net. Ein Schlüssel funktioniert für eine Domain.

Installation

Der Download ist eine ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das Paket für OpenCart 3 wcp_stripe_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_stripe_gateway.ocmod.zip. Installieren Sie nur das Paket für Ihre OpenCart-Version. Der Lizenzschlüssel ist für beide Versionen gleich.

OpenCart 3

1. Gehen Sie im Admin zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_stripe_gateway-oc3-(version).ocmod.zip. Die Erweiterung enthält keine OCMOD-Modifikationen, daher muss Extensions > Modifications nicht aktualisiert werden. Statt des Installers können Sie auch den Inhalt des Ordners upload aus diesem Paket in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox Stripe Gateway und klicken Sie auf Install (der grüne +-Button). Ihr Admin-Benutzer benötigt das Recht, die Liste der Zahlungserweiterungen zu ändern.

3. Klicken Sie auf Edit (der Stift-Button), um die Einstellungsseite zu öffnen. Fügen Sie Ihren VibeFox-Lizenzschlüssel in License key im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. Fügen Sie Ihre geheimen Stripe-Schlüssel ein, richten Sie den Webhook im Stripe Dashboard ein und fügen Sie dessen Signaturgeheimnisse ein (siehe Konfiguration).

5. Schalten Sie Enable/Disable ein und klicken Sie auf Save. Testen Sie eine Zahlung im Testmodus mit der Karte 4242 4242 4242 4242 und schalten Sie danach Test Mode aus.

OpenCart 4

1. Gehen Sie im Admin zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_stripe_gateway.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 entnimmt den Code der Erweiterung dem Dateinamen, und ein umbenanntes Paket funktioniert nicht.

2. Das Paket erscheint auf derselben Seite in der Liste der installierten Erweiterungen. Klicken Sie daneben auf Install (der grüne +-Button).

3. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox Stripe Gateway, klicken Sie auf Install (der grüne +-Button) und dann auf Edit (der Stift-Button).

4. Fügen Sie den Lizenzschlüssel und die Stripe-Schlüssel ein und richten Sie den Webhook ein, wie in den Schritten 3 bis 5 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Webhook-URL ist anders (siehe Webhook).

Eine neue Installation startet mit deaktivierter Zahlungsart und eingeschaltetem Testmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Payments > VibeFox Stripe Gateway > Edit. Die Abschnitte sind links aufgelistet; der Button Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt Sie die Seite, wenn für den aktuellen Modus kein geheimer Schlüssel hinterlegt ist (die Zahlungsart wird dann an der Kasse ausgeblendet) oder kein Signaturgeheimnis des Webhooks (Bestellungen werden dann erst bestätigt, wenn der Kunde nach der Zahlung in den Shop zurückkehrt). Außerdem zeigt sie Testmodus ist aktiv: Es werden keine echten Zahlungen angenommen., solange der Testmodus eingeschaltet ist. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern muss Title 1 bis 128 Zeichen haben, Sort Order muss eine ganze Zahl sein und Total muss eine Zahl von 0 oder mehr sein. Beginnt ein Schlüssel oder ein Geheimnis nicht mit dem erwarteten Präfix, werden die Einstellungen gespeichert, und oberhalb der Einstellungen erscheint eine Warnung, die das betreffende Feld nennt.

Stripe Checkout

Enable/Disable: Enable Stripe Gateway schaltet die Zahlungsart ein oder aus. Standard: aus.

Title: der Name der Zahlungsart, den Kunden an der Kasse sehen. Er wird auch als Zahlungsart in der Bestellung gespeichert. Standard: Stripe. Pflichtfeld.

Description: der Text, den der Kunde im Schritt Confirm Order über der Bestätigungsschaltfläche sieht. Standard: Pay securely with your credit or debit card via Stripe.

Sort Order: die Position von Stripe unter den Zahlungsarten an der Kasse. Lassen Sie das Feld leer oder geben Sie eine ganze Zahl ein.

Geo Zone: Stripe nur für Zahlungsadressen in der gewählten Geozone anbieten. Standard: All zones. Geozonen richten Sie unter System > Localisation > Geo Zones ein.

Total: der Kassensumme in der Standardwährung des Shops, die eine Bestellung erreichen muss, bevor Stripe angeboten wird. Lassen Sie das Feld leer, um Stripe bei jedem Betrag anzubieten.

API-Schlüssel

Kopieren Sie die geheimen Schlüssel aus Stripe Dashboard > Developers > API keys (die Seite enthält einen Link dorthin). Test- und Live-Schlüssel sind getrennt. Der Testmodus verwendet nur die Testschlüssel, der Live-Modus nur die Live-Schlüssel.

Test Mode: verwendet die Stripe-Testschlüssel. Es wird kein echtes Geld belastet; bezahlen Sie mit Stripe-Testkarten wie 4242 4242 4242 4242. Standard: eingeschaltet. Schalten Sie es aus, um echte Zahlungen anzunehmen. Solange es eingeschaltet ist, sehen Kunden im Schritt Confirm Order Testmodus: Es wird keine echte Zahlung angenommen.

Test Secret Key: der geheime Schlüssel des Testmodus. Er beginnt mit sk_test_ (oder rk_test_ bei einem eingeschränkten Schlüssel).

Test Webhook Secret: das Signaturgeheimnis (whsec_...) des im Testmodus angelegten Webhook-Endpunkts.

Live Secret Key: der geheime Schlüssel des Live-Modus. Er beginnt mit sk_live_ (oder rk_live_ bei einem eingeschränkten Schlüssel).

Live Webhook Secret: das Signaturgeheimnis (whsec_...) des im Live-Modus angelegten Webhook-Endpunkts.

Gespeicherte Schlüssel und Geheimnisse werden nie erneut angezeigt. Das Feld bleibt leer und zeigt Gespeichert — zum Beibehalten leer lassen. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um einen gespeicherten Wert zu entfernen, setzen Sie unter dem Feld den Haken bei Clear the saved value on save und klicken Sie auf Save.

Webhook

Der Webhook teilt Ihrem Shop mit, dass eine Zahlung erfolgt ist. Fügen Sie unter Stripe Dashboard > Developers > Webhooks einen Endpunkt im Testmodus und einen weiteren im Live-Modus hinzu. Verwenden Sie die URL, die in diesem Abschnitt unter Endpoint URL angezeigt wird. Bei OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_stripe_gateway/webhook, bei OpenCart 4 so: https://your-store/index.php?route=extension/wcp_stripe_gateway/payment/wcp_stripe_gateway.webhook. Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet. Kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen.

Wählen Sie für jeden Endpunkt diese Ereignisse aus (sie sind auch in diesem Abschnitt aufgeführt):

Kopieren Sie nach dem Anlegen jedes Endpunkts dessen Signaturgeheimnis (whsec_...) aus Stripe und fügen Sie es in Test Webhook Secret bzw. Live Webhook Secret ein. Webhooks ohne gültige Signatur werden abgelehnt. Ein Ereignis wird nur akzeptiert, wenn es mit dem Geheimnis des Modus signiert ist, in dem die Zahlung erfolgte; ein Testgeheimnis bestätigt also nie eine echte Zahlung. Ohne den Webhook wird eine Bestellung erst bestätigt, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine unvollständige Bestellung). Die Bestellung erhält erst dann einen Status, wenn Stripe die Zahlung bestätigt hat. Jedes Feld unten listet Ihre OpenCart-Bestellstatus auf.

Order Status After Payment: der Status, der nach einer erfolgreichen Zahlung gesetzt wird. Standard: Processing.

Awaiting Payment Status: eine verzögerte Zahlung: Der Bestellvorgang ist abgeschlossen, Stripe hat das Geld aber noch nicht bestätigt. Standard: Pending.

On Hold (Review) Status: die Zahlung muss von Ihnen geprüft werden (siehe Bestellstatus). Standard: Pending, da OpenCart keinen Status On hold hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Failed Payment Status: eine verzögerte Zahlung ist fehlgeschlagen. Standard: Failed.

Refunded Status: die Zahlung wurde von der Bestellseite aus vollständig erstattet. Standard: Refunded.

Erweitert

Logging: schreibt Stripe-Anfragen und Webhooks in strg_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei lässt sich nicht über das Web öffnen; bei 5 MB wird sie nach strg_debug.old.log.php verschoben. Schlüssel und Kundendaten werden nicht protokolliert. Standard: aus. Solange es ausgeschaltet ist, wird nichts geschrieben, auch keine Fehler.

Log: zeigt die Größe und die neuesten Einträge des Protokolls. Klicken Sie auf Clear log, um es zu leeren.

Delete Data on Uninstall: Wenn eingeschaltet, entfernt die Deinstallation der Erweiterung die Gateway-Einstellungen und das Protokoll. Stripe-Transaktionen und -Erstattungen bleiben immer erhalten, sodass alte Bestellungen erstattungsfähig bleiben. Standard: aus.

Import / Export

Exportieren: Download JSON speichert die Einstellungen als JSON-Datei. Geheime Schlüssel werden nicht exportiert.

Importieren: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Gespeicherte geheime Schlüssel bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Stripe). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis Sie werden zu Stripe weitergeleitet, um die Zahlung sicher abzuschließen. OpenCart legt die Bestellung in diesem Schritt an, weiterhin ohne Status. Klickt der Kunde auf Confirm Order, erstellt die Erweiterung eine Stripe-Checkout-Sitzung für die Bestellsumme in der Bestellwährung und leitet den Kunden zur Zahlungsseite von Stripe weiter. Dort bezahlt der Kunde mit Kredit- oder Debitkarte. Bei OpenCart 4 wählt der Kunde die Zahlungsart mit dem Button Choose im Block der Zahlungsart, im Fenster Payment method options, und klickt unten auf der Kassenseite auf Confirm Order. Die E-Mail-Adresse des Kunden wird an Stripe übergeben, und auf der Stripe-Seite erscheint die Zahlung als Order # mit der Bestellnummer.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, nachdem Stripe die Zahlung bestätigt hat: entweder über den signierten Webhook oder über eine serverseitige Anfrage an Stripe, wenn der Kunde zurückkehrt. Danach erhält die Bestellung ihren Status auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die OpenCart-Erfolgsseite der Bestellung. Bei einer verzögerten Zahlung zeigt die Seite zusätzlich Ihre Zahlung wird von Stripe bestätigt. Sie erhalten eine E-Mail, sobald sie bestätigt ist. Hat Stripe die Zahlung bei der Rückkehr des Kunden noch nicht bestätigt, zeigt eine Seite Zahlungsbestätigung denselben Text und eine Schaltfläche Check again; der Webhook setzt den Bestellstatus, sobald er eintrifft.

Bricht der Kunde auf der Stripe-Seite ab, wird die Stripe-Sitzung geschlossen und der Kunde kehrt zur Kasse zurück, mit Die Zahlung wurde abgebrochen. Sie können es erneut versuchen oder eine andere Zahlungsart wählen. Wurde die Zahlung nicht abgeschlossen oder ist eine verzögerte Zahlung fehlgeschlagen, lautet die Meldung Die Zahlung wurde nicht abgeschlossen. Sie können es erneut versuchen oder eine andere Zahlungsart wählen. Der Warenkorb bleibt erhalten. Bei OpenCart 4 werden diese Meldungen oberhalb der Kassenseite angezeigt. Jeder neue Versuch (OpenCart 3 legt jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird, OpenCart 4 aktualisiert die Bestellung der Kasse) schließt die vorherigen offenen Stripe-Sitzungen des Warenkorbs, sodass er nicht doppelt bezahlt werden kann. Stellt sich heraus, dass eine vorherige Sitzung bereits bezahlt wurde, wird diese Zahlung bestätigt, statt eine neue zu starten. Ist eine andere Bestellung desselben Warenkorbs bereits mit Stripe bezahlt, wird keine neue Zahlung gestartet, und der Kunde sieht die Erfolgsseite der Bestellung. Jede Änderung des Warenkorbs, auch eine neue Menge, gilt als neuer Warenkorb, der eine eigene Zahlung benötigt.

Bei OpenCart 4 bleibt die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel weil ihre verzögerte Zahlung fehlgeschlagen ist oder Sie sie abgebrochen haben), wird der Kunde mit der Meldung über die nicht abgeschlossene Zahlung zur Kasse zurückgeschickt, und der nächste Klick auf Confirm Order bezahlt eine neue Bestellung. Eine bezahlte Bestellung wird für einen anderen Warenkorb nie als bezahlt angezeigt.

Kann Stripe die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung oberhalb der Schaltfläche, zum Beispiel Die Bestellsumme liegt unter dem Mindestbetrag, den Stripe in dieser Währung abbuchen kann. Bitte wählen Sie eine andere Zahlungsart. Der technische Grund wird im Protokoll festgehalten.

Der Webhook funktioniert auch, während der Shop im Wartungsmodus ist, weil OpenCart Anfragen für Zahlungserweiterungen durchlässt.

Die Erweiterung nimmt nur Kartenzahlungen an, die auf der Stripe-Seite sofort erfasst werden. Sie hat keine gespeicherten Karten, Abonnements oder wiederkehrenden Zahlungen, kein Kartenformular auf Ihrer Website, keine Apple-Pay- oder Google-Pay-Buttons auf Ihrer Website und keine getrennte Autorisierung und Erfassung.

Bestellungen und Erstattungen

Bestellstatus

Ohne Status (unvollständige Bestellung): Der Kunde wurde zu Stripe weitergeleitet und hat nicht bezahlt, oder Stripe hat die Zahlung noch nicht bestätigt. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Order Status After Payment (Standard Processing): Die Zahlung wurde bestätigt. Eine Notiz zeigt die Stripe-Zahlung (pi_...), die Sitzung und wie sie bestätigt wurde (Webhook oder Rückkehr).

Awaiting Payment Status (Standard Pending): Der Kunde hat den Bestellvorgang mit einer verzögerten Zahlungsart abgeschlossen. Wenn Stripe die Zahlung bestätigt, wechselt die Bestellung zu Order Status After Payment; schlägt die Zahlung fehl, wechselt sie zu Failed Payment Status. OpenCart benachrichtigt den Kunden über diese Änderungen.

On Hold (Review) Status (Standard Pending): Stripe hat einen anderen Betrag oder eine andere Währung als die Bestellsumme gemeldet, oder die Zahlung ist eingegangen, nachdem die Bestellung storniert wurde oder ihr Status sich geändert hat. Die Notiz erklärt dies. Prüfen Sie die Bestellung und versenden Sie sie oder erstatten Sie die Zahlung.

Refunded Status (Standard Refunded): Die Zahlung wurde über die Erweiterung vollständig erstattet.

Geht eine zweite Zahlung für eine bereits bezahlte Bestellung ein, bleibt die Bestellung unverändert. Eine Notiz bittet Sie, sie zu prüfen und das Duplikat im Stripe Dashboard zu erstatten. Dasselbe gilt, wenn die Zahlung zu einer anderen Bestellung eines bereits bezahlten Warenkorbs gehört: Diese Bestellung bleibt ohne Status, und die Notiz wird der bezahlten Bestellung hinzugefügt.

Notizen sind Einträge im History der Bestellung, die der Kunde nicht sieht.

Registerkarte VibeFox Stripe Gateway

Öffnen Sie unter Sales > Orders eine mit Stripe bezahlte Bestellung. Am unteren Rand der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox Stripe Gateway die Stripe-Zahlungs-ID (mit Link zur Zahlung im Stripe Dashboard) mit einem Hinweis Test mode bei Testzahlungen, die Checkout Session, den Zahlungs-Status, die Beträge Paid / refunded, das Erstattungsformular, den Erstattungsverlauf und die Stripe notes der Bestellung. Die Registerkarte wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie in der Registerkarte VibeFox Stripe Gateway den Amount ein (der noch nicht erstattete Betrag wird eingetragen), optional einen Reason (optional), und klicken Sie auf Refund via Stripe. Bestätigen Sie die Frage Diesen Betrag über Stripe erstatten? Dies kann nicht rückgängig gemacht werden. Vollständige und Teilerstattungen werden unterstützt. Sie benötigen das Recht, die Erweiterung zu ändern (einzustellen unter System > Users > User Groups). Erstattungen erfolgen in dem Betrag und der Währung, die Stripe belastet hat, nicht in der Bestellsumme. Die Erstattung wird im Modus gesendet, in dem die Zahlung erfolgte (Test oder Live), daher muss der geheime Schlüssel dieses Modus gesetzt sein. Akzeptiert Stripe die Erstattung nicht, zeigt die Registerkarte den Fehler, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird mit der Stripe-Erstattungs-ID dem Verlauf und den Notizen hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf Refunded Status, ohne den Kunden zu benachrichtigen und ohne Produkte in den Bestand zurückzubuchen, wie bei einer manuellen Statusänderung. Eine Teilerstattung ändert den Status nicht. Erstattungen sind verfügbar, sobald Stripe die Zahlung bestätigt hat.

Produktretouren unter Sales > Returns zahlen über Stripe kein Geld zurück.

Im Stripe Dashboard vorgenommene Erstattungen kommen über den Webhook charge.refunded an und werden den Notizen mit dem insgesamt in Stripe erstatteten Betrag hinzugefügt. Der Bestellstatus wird nicht automatisch geändert. Aktualisieren Sie ihn bei Bedarf manuell.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Stripe Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Stripe Gateway > Edit, oberhalb der Einstellungen. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den maskierten Schlüssel, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig ist, und Ihre Domain) sowie die Buttons Check now zur erneuten Prüfung des Status, Change key zur Eingabe eines anderen Schlüssels und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: opencart-payment-stripe und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit dem Recht Modify für die Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen der Admin-Sprache (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt der Block den Grund, zum Beispiel Schlüssel nicht gefunden, Dieser Schlüssel gehört zu einem anderen Produkt, Domain-Limit erreicht oder Lizenz abgelaufen am mit einem Datum. Nachdem sich die Shop-Adresse geändert hat oder nachdem Sie einen Domain-Platz in Ihrem Konto freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet die Erweiterung mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert für eine Domain: die Shop-Adresse aus der OpenCart-Konfiguration. Das Entfernen des Schlüssels aus dem Shop gibt seinen Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Stripe Kunden an der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde Diese Zahlungsart ist nicht verfügbar. Bitte wählen Sie eine andere. Ein Admin-Benutzer, der im Admin im selben Browser angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. Bei OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Anmeldung im Admin nicht, daher wird ohne aktiven Schlüssel die Zahlungsart für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint auf dem Dashboard des Admins eine Erinnerung. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, Updates und Support erfordern jedoch eine Verlängerung. Der Status wird automatisch erneut geprüft, wenn Sie das Dashboard oder die Seite Edit im Admin öffnen: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal wöchentlich. Ein Cron-Job ist nicht nötig. Beim Deinstallieren der Erweiterung werden immer Lizenzschlüssel und Lizenzstatus entfernt.

Fehlerbehebung

Stripe erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und der aktuelle Modus einen geheimen Schlüssel hat: Test Secret Key im Testmodus, Live Secret Key im Live-Modus. Die Einstellungsseite zeigt eine Warnung, wenn der Schlüssel fehlt. Prüfen Sie außerdem, ob die Zahlungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht.

Die Zahlung war erfolgreich, aber die Bestellung bleibt ohne Status: Der Webhook funktioniert nicht. Prüfen Sie im Stripe Dashboard, ob der Endpunkt im verwendeten Modus (Test oder Live) existiert, ob seine URL genau der unter Endpoint URL angezeigten entspricht und ob die vier Ereignisse ausgewählt sind. Prüfen Sie, ob das Signaturgeheimnis dieses Endpunkts im passenden Feld steht (Test Webhook Secret oder Live Webhook Secret). Das Stripe Dashboard zeigt die Antwort Ihres Shops für jeden Webhook. Die Bestellung erhält ihren Status auch, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

Der Webhook antwortet „Webhook secret not configured“: Es ist kein Webhook-Geheimnis gesetzt. Fügen Sie das Signaturgeheimnis in die Einstellungen ein.

Der Webhook antwortet „Invalid signature“: Das Signaturgeheimnis gehört zu einem anderen Endpunkt oder einem anderen Modus, oder die Serveruhr ist falsch. Stripe-Signaturen werden nur innerhalb von 5 Minuten nach der Serverzeit akzeptiert. Die Antwort lautet ebenfalls „Invalid signature“, wenn ein Ereignis einer Live-Zahlung mit dem Testgeheimnis signiert ist oder umgekehrt: Prüfen Sie, ob Test- und Live-Geheimnisse vertauscht sind.

Der Webhook antwortet „Busy, retry“: Die Bestellung wurde gerade von einer anderen Anfrage bestätigt, oder der Bestellstatus konnte nicht gesetzt werden. Stripe wiederholt den Webhook automatisch. Schalten Sie Logging ein, um den Grund zu sehen.

Die Webhook-URL zeigt im Browser „Method not allowed“: Das ist normal. Die URL akzeptiert nur Anfragen von Stripe.

Warnung „The value does not look right“ beim Speichern: Ein Schlüssel wurde in das falsche Feld eingefügt. Geheime Schlüssel beginnen mit sk_test_ / rk_test_ oder sk_live_ / rk_live_, Webhook-Geheimnisse mit whsec_.

Der Kunde sieht nach Confirm Order einen Fehler: Schalten Sie Logging ein und sehen Sie sich das Feld Log auf der Erweiterungsseite an. Diese Zahlungsart ist nicht verfügbar. Bitte laden Sie die Kasse neu. bedeutet, dass die Checkout-Sitzung nicht mehr zur Bestellung passt oder die Zahlungsart inzwischen ausgeschaltet wurde: Der Kunde lädt die Kasse neu. Ein falscher Schlüssel führt zur Meldung, dass die Zahlungsart nicht richtig konfiguriert ist. Eine Bestellsumme unter dem Stripe-Mindestbetrag für die Währung (zum Beispiel 0,50 EUR) kann nicht mit Stripe bezahlt werden.

Testzahlungen bestätigen keine Live-Zahlung: Test- und Live-Zahlungen werden getrennt gehalten. Stellen Sie Test Mode auf den gewünschten Modus um und verwenden Sie die Schlüssel und den Webhook dieses Modus.

Bestellung nach der Zahlung im Prüfstatus: Lesen Sie die Notizen in der Registerkarte VibeFox Stripe Gateway (siehe Bestellstatus) und versenden Sie dann die Bestellung oder erstatten Sie die Zahlung.

Kein Erstattungsformular in der Registerkarte: Die Registerkarte nennt den Grund: Die Zahlung ist noch nicht bestätigt, sie ist vollständig erstattet, oder Ihre Benutzergruppe hat kein Recht, die Erweiterung zu ändern.

Erstattung schlägt mit einer Meldung zum Modus fehl: Die Zahlung wurde im Testmodus oder im Live-Modus getätigt, und der geheime Schlüssel dieses Modus ist nicht gesetzt. Tragen Sie ihn ein und versuchen Sie es erneut.

Für Entwickler: Bevor die Stripe-Sitzung erstellt wird, löst die Erweiterung das OpenCart-Event strg_checkout_session_params mit den Sitzungsparametern und der Bestellung aus.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Stripe Gateway auf Uninstall (der rote −-Button). Lizenzschlüssel und Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart entfernt immer die eigenen Einstellungen der Erweiterung: Enable/Disable, Sort Order, Geo Zone, Total und die Bestellstatus im Bereich Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Das OpenCart-Event der Erweiterung wird ebenfalls entfernt (bei OpenCart 4 seine Events und seine Startaktion, die den Webhook im Wartungsmodus durchlässt). Ist Delete Data on Uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Testmodus, Schlüssel, Webhook-Geheimnisse, Logging) und das Protokoll entfernt. Ist es ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Stripe-Transaktionen und -Erstattungen bleiben immer erhalten, sodass früher bezahlte Bestellungen nach einer Neuinstallation weiterhin erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Bei OpenCart 4 entfernen Sie außerdem die Dateien der Erweiterung: Gehen Sie nach der Deinstallation zu Extensions > Installer, klicken Sie in der Liste der installierten Erweiterungen neben VibeFox Stripe Gateway auf Uninstall (der orangefarbene −-Button) und danach auf Delete (der rote Papierkorb-Button), um das hochgeladene Paket zu entfernen.

Stripe ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist nicht mit Stripe verbunden und wird von Stripe nicht unterstützt.