VibeFox Stripe for WooCommerce — Hilfe
Anforderungen
WordPress: 6.0 oder neuer.
WooCommerce: 7.0 oder neuer, installiert und aktiv. Das Plugin lässt sich ohne WooCommerce nicht aktivieren.
PHP: 8.0 oder neuer.
HTTPS: Ihre Website sollte für Live-Zahlungen HTTPS verwenden.
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: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert auf einer Domain.
Installation
1. Gehen Sie in WordPress zu Plugins > Add New > Upload Plugin, wählen Sie die ZIP-Datei des Plugins und klicken Sie auf Install Now. Sie können den Ordner wcp_stripe_gateway auch per FTP nach /wp-content/plugins/ hochladen.
2. Klicken Sie auf Activate.
3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Stripe > Manage, oder klicken Sie auf der Plugins-Seite unter dem Namen des Plugins auf Settings.
4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.
5. 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).
6. Aktivieren Sie Enable/Disable. Testen Sie eine Zahlung im Testmodus mit der Karte 4242 4242 4242 4242 und deaktivieren Sie danach Test Mode.
Konfiguration
Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Stripe. Oberhalb der Felder warnt die Seite, wenn der aktuelle Modus keinen geheimen Schlüssel hat (die Zahlungsmethode wird dann an der Kasse ausgeblendet) oder kein Webhook-Signaturgeheimnis, und sie zeigt Test mode is on: no real payments are taken., solange der Testmodus aktiv ist. In der Liste der Zahlungsmethoden wird Stripe als einrichtungsbedürftig markiert, bis der aktuelle Modus einen geheimen Schlüssel hat.
Allgemein
Enable/Disable: Enable Stripe Gateway schaltet die Zahlungsmethode ein oder aus. Standard: aus.
Title: der Name der Zahlungsmethode, den Kunden an der Kasse sehen. Standard: Stripe.
Description: der Text unter der Zahlungsmethode an der Kasse. Standard: Pay securely with your credit or debit card via Stripe.
API-Schlüssel
Kopieren Sie die geheimen Schlüssel aus Stripe Dashboard > Developers > API keys. Test- und Live-Schlüssel sind getrennt. Der Testmodus verwendet nur die Testschlüssel, der Live-Modus nur die Live-Schlüssel. Beim Speichern warnt das Plugin, wenn ein Wert nicht mit dem erwarteten Präfix beginnt, etwa wenn statt eines geheimen Schlüssels ein veröffentlichbarer Schlüssel eingefügt wurde.
Test Mode: Enable test mode verwendet die Stripe-Testschlüssel. Es wird kein echtes Geld belastet; bezahlen Sie mit Stripe-Testkarten wie 4242 4242 4242 4242. Standard: ein. Deaktivieren Sie die Option, um echte Zahlungen anzunehmen.
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 erstellten 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 erstellten Webhook-Endpunkts.
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 der Einstellungen angezeigt wird. Sie sieht etwa so aus: https://your-site/wc-api/strg_stripe_webhook/. Wenn Ihre Website in den URLs ein Sprachpräfix verwendet, kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen, denn Stripe folgt keinen Weiterleitungen.
Wählen Sie für jeden Endpunkt diese Ereignisse aus:
Kopieren Sie nach dem Erstellen jedes Endpunkts dessen Signaturgeheimnis (whsec_...) aus Stripe und fügen Sie es in Test Webhook Secret oder Live Webhook Secret ein. Webhooks ohne gültige Signatur werden abgelehnt. Ohne den Webhook wird eine Bestellung nur bestätigt, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.
Bestellungen
Order Status After Payment: der Bestellstatus, der nach einer erfolgreichen Zahlung gesetzt wird. Der Status wird sofort gesetzt, ohne einen zweiten Statuswechsel.
Erweitert
Logging: Enable logging schreibt Stripe-Anfragen und Webhooks in WooCommerce > Status > Logs, Quelle wcp_stripe_gateway. Schlüssel und Kundendaten werden nicht protokolliert. Standard: aus.
Delete Data on Uninstall: Wenn aktiviert, entfernt das Löschen des Plugins die Gateway-Einstellungen, die an Bestellungen gespeicherten Stripe-Daten und die Protokolle. Standard: aus.
Kasse
Der Kunde wählt die Zahlungsmethode (standardmäßig Stripe) und gibt die Bestellung auf. Das Plugin erstellt für den Bestellbetrag in der Bestellwährung eine Stripe-Checkout-Sitzung und leitet den Kunden auf die Stripe-Zahlungsseite weiter. Dort bezahlt der Kunde mit Kredit- oder Debitkarte. Die Rechnungs-E-Mail 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 auf die Seite „Bestellung eingegangen“ Ihres Shops zurück. Die Bestellung wird erst als bezahlt markiert, wenn Stripe die Zahlung bestätigt hat: durch den signierten Webhook oder durch eine serverseitige Anfrage an Stripe, sobald der Kunde auf dieser Seite ankommt. Ist die Zahlung noch nicht bestätigt, zeigt die Seite Your payment is being confirmed by Stripe. You will receive an e-mail as soon as it is confirmed.
Bricht der Kunde auf der Stripe-Seite ab, wird die Bestellung auf die übliche WooCommerce-Weise storniert. Ein Kunde kann eine unbezahlte Bestellung erneut bezahlen, zum Beispiel über die Seite Pay for order. Jeder neue Versuch schließt die vorherige Stripe-Sitzung, sodass die Bestellung nicht zweimal bezahlt werden kann.
Kann Stripe die Zahlung nicht starten, sieht der Kunde eine kurze Meldung, zum Beispiel dass der Bestellbetrag unter dem Mindestbetrag liegt, den Stripe in dieser Währung abbuchen kann, und kann eine andere Zahlungsmethode wählen. Der technische Grund wird den Bestellnotizen und dem Protokoll hinzugefügt. Angemeldete Shop-Manager sehen ihn zusätzlich in der Meldung.
Die Zahlungsmethode funktioniert in der klassischen Kasse, im Checkout-Block und auf der Seite Pay for order. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.
Das Plugin akzeptiert nur Kartenzahlungen, die sofort auf der Stripe-Seite erfasst werden. Es gibt keine gespeicherten Karten, keine Abonnements oder wiederkehrenden Zahlungen, kein Kartenformular auf Ihrer Website, keine Apple-Pay- oder Google-Pay-Schaltflächen auf Ihrer Website und keine getrennte Autorisierung und Erfassung.
Bestellungen und Erstattungen
Bestellstatus
Pending payment: der Kunde wurde zu Stripe weitergeleitet und hat noch nicht bezahlt, oder Stripe hat die Zahlung noch nicht bestätigt.
Processing, Completed or On Hold: die Zahlung wurde bestätigt. Der Status folgt Order Status After Payment. Die Bestellnotiz zeigt die Stripe-Zahlung und wie sie bestätigt wurde (Webhook oder Rückkehr des Kunden). Die Transaktions-ID ist die Stripe-Zahlungs-ID (pi_...) und auf der Bestellseite mit der Zahlung im Stripe Dashboard verknüpft.
On hold after payment: Stripe hat einen anderen Betrag oder eine andere Währung gemeldet als den Bestellbetrag (zum Beispiel wurde die Bestellung geändert, nachdem die Zahlung begonnen hatte), oder die Zahlung ging ein, nachdem die Bestellung storniert worden war. Die Bestellnotiz erklärt das. Prüfen Sie die Bestellung und bearbeiten Sie sie oder erstatten Sie die Zahlung.
Failed: eine verzögerte Zahlung ist fehlgeschlagen.
Cancelled: der Kunde hat auf der Stripe-Seite abgebrochen, oder die Bestellung wurde von Ihnen oder durch das Zeitlimit der WooCommerce-Lagerreservierung storniert. Die offene Stripe-Sitzung der Bestellung wird geschlossen, sodass sie nicht mehr bezahlt werden kann.
Geht eine zweite Zahlung für eine bereits bezahlte Bestellung ein, wird die Bestellung nicht erneut geändert. Eine Notiz bittet Sie, dies zu prüfen und das Duplikat im Stripe Dashboard zu erstatten.
Erstattungen
Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via Stripe. Vollständige und teilweise Erstattungen werden unterstützt. Die Erstattung wird in dem Modus gesendet, in dem die Zahlung erfolgt ist (Test oder Live), daher muss der geheime Schlüssel dieses Modus gesetzt sein. Lehnt Stripe die Erstattung ab, zeigt WooCommerce den Fehler an und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird mit der Stripe-Erstattungs-ID in den Bestellnotizen vermerkt.
Im Stripe Dashboard vorgenommene Erstattungen kommen über den Webhook charge.refunded an und werden in den Bestellnotizen vermerkt. Sie werden nicht automatisch als WooCommerce-Erstattungen erfasst. Erstellen Sie bei Bedarf in WooCommerce eine manuelle Erstattung ohne Refund via Stripe.
Lizenzschlüssel
Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > Stripe. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain. Mit Check now prüfen Sie den Status erneut, mit Change key geben Sie einen anderen Schlüssel ein und mit Remove key entfernen Sie ihn von dieser Website. Der Link Manage licenses and domains in your account öffnet Ihr vibefox.net-Konto.
Ein Schlüssel funktioniert auf einer Domain. Das Entfernen des Schlüssels von einer Website gibt deren 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 This payment method is not available. Please choose another one. Angemeldete Shop-Manager sehen die Zahlungsmethode weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin einrichten und testen können, bevor Sie einen Schlüssel kaufen. Auf der Plugins-Seite und auf WooCommerce-Seiten erscheint ein Hinweis. Bestehende Bestellungen sind nicht betroffen: bereits begonnene Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.
Läuft eine Lizenz ab, funktioniert das Plugin weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird im Hintergrund automatisch erneut geprüft.
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 an, wenn der Schlüssel fehlt.
Die Zahlung ist durchgegangen, aber die Bestellung bleibt Pending payment: 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 in den Einstellungen angezeigten entspricht und ob die vier Ereignisse ausgewählt sind. Prüfen Sie, ob das Signaturgeheimnis dieses Endpunkts im richtigen Feld steht (Test Webhook Secret oder Live Webhook Secret). Das Stripe Dashboard zeigt für jeden Webhook die Antwort Ihres Shops an. Die Bestellung wird auch bestätigt, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.
Webhook antwortet Webhook secret not configured: Keines der beiden Webhook-Geheimnisse ist gesetzt. Fügen Sie das Signaturgeheimnis in die Einstellungen ein.
Webhook antwortet Invalid signature: Das Signaturgeheimnis gehört zu einem anderen Endpunkt oder einem anderen Modus, oder die Uhr des Servers ist falsch. Stripe-Signaturen werden innerhalb von 5 Minuten zur Serverzeit akzeptiert.
Webhook antwortet Busy, retry: Die Bestellung wurde im selben Moment von einer anderen Anfrage bestätigt. Stripe wiederholt den Webhook automatisch.
Warnung beim Speichern: Der Wert sieht nicht richtig aus: 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 beim Aufgeben der Bestellung einen Fehler: Öffnen Sie die Bestellnotizen oder aktivieren Sie Logging und sehen Sie unter WooCommerce > Status > Logs, Quelle wcp_stripe_gateway, nach. Ein falscher oder fehlender Schlüssel führt zur Meldung, dass die Zahlungsmethode nicht korrekt konfiguriert ist. Ein Bestellbetrag 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-Bestellung: Test- und Live-Zahlungen werden getrennt gehalten. Eine Testzahlung bestätigt nie eine Live-Bestellung und umgekehrt. Stellen Sie Test Mode auf den gewünschten Modus um und verwenden Sie die Schlüssel und den Webhook dieses Modus.
Bestellung ist nach der Zahlung On Hold: Lesen Sie die Bestellnotiz. Der bezahlte Betrag oder die Währung wich von der Bestellung ab, oder die Zahlung ging ein, nachdem die Bestellung storniert worden war. Bearbeiten Sie die Bestellung oder erstatten Sie die Zahlung.
Erstattung schlägt mit einer Meldung zum Modus fehl: Die Zahlung erfolgte im Test- oder Live-Modus, und der geheime Schlüssel dieses Modus ist nicht gesetzt. Geben Sie ihn ein und versuchen Sie es erneut.
Der Lizenzblock zeigt einen Fehler: Folgen Sie der Meldung im Block. Ist der Schlüssel zum Beispiel bereits auf einer anderen Domain verwendet, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Hat sich die Adresse der Website geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Ist der Lizenzserver nicht erreichbar, arbeitet das Plugin mit dem zuletzt bekannten Status weiter.
Deinstallation
Das Deaktivieren des Plugins behält alle Daten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Lizenzschlüssel und Lizenzstatus dieses Plugins werden immer entfernt. Die Gateway-Einstellungen, die an Bestellungen gespeicherten Stripe-Daten und die Protokolle werden nur entfernt, wenn Delete Data on Uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.
Stripe ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist nicht mit Stripe verbunden und wird nicht von Stripe unterstützt.