VibeFox Paystack for WooCommerce — Hilfe
Anforderungen
WordPress: 5.8 oder neuer.
WooCommerce: 7.0 oder neuer, installiert und aktiv. Das Plugin lässt sich ohne WooCommerce nicht aktivieren.
PHP: 8.0 oder neuer.
Währung: Die Bestellung muss in einer Währung erfolgen, die Paystack akzeptiert: NGN, USD, GHS, ZAR, KES, XOF, EGP oder RWF, wie in Ihrem Paystack-Konto aktiviert. In anderen Währungen wird die Zahlungsmethode ausgeblendet. Bei XOF und RWF akzeptiert Paystack nur ganze Beträge.
Paystack-Konto: Sie benötigen die geheimen Schlüssel Ihres Paystack-Kontos: den geheimen Testschlüssel (sk_test_...) und/oder den geheimen Live-Schlüssel (sk_live_...). Die öffentlichen Schlüssel (pk_...) werden nicht benötigt, weil die Zahlung auf der gehosteten Seite von Paystack erfolgt. Im Paystack-Dashboard stellen Sie außerdem die Webhook-URL Ihres Shops ein (siehe Konfiguration). Ihre Website muss aus dem Internet erreichbar sein, um Webhooks zu empfangen.
VibeFox-Lizenzschlüssel: Er wird auf vibefox.net erworben. Ein Schlüssel gilt für eine 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. Alternativ können Sie den Ordner wcp_paystack_payment per FTP nach /wp-content/plugins/ hochladen.
2. Klicken Sie auf Activate.
3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Paystack > Manage, oder klicken Sie auf der Plugins-Seite unter dem Plugin-Namen auf Settings.
4. Tragen Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.
5. Fügen Sie Ihre geheimen Schlüssel aus dem Paystack-Dashboard ein und hinterlegen Sie die Webhook-URL im Paystack-Dashboard (siehe Konfiguration).
6. Aktivieren Sie Enable/Disable und speichern Sie. Lassen Sie Test Mode eingeschaltet, bis Sie eine Testzahlung durchgeführt haben, und schalten Sie es danach aus, um echte Zahlungen anzunehmen.
Konfiguration
Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Paystack. Oberhalb der Felder zeigt ein Statusfeld den Modus an: Testmodus: Es wird kein echtes Geld abgebucht. oder Live-Modus: Echte Zahlungen werden angenommen. Es warnt außerdem, wenn der geheime Schlüssel des aktuellen Modus fehlt, wenn ein öffentlicher Schlüssel (pk_...) in ein Feld für geheime Schlüssel eingegeben wurde, wenn der Live-Modus einen Testschlüssel (sk_test_...) oder der Testmodus einen Live-Schlüssel (sk_live_...) hat und wenn Paystack Ihre Shopwährung nicht akzeptiert. Solange ein Schlüsselproblem besteht, wird die Zahlungsmethode auf der Kasse ausgeblendet. In der Liste der Zahlungsmethoden ist Paystack als einrichtungsbedürftig markiert, bis der aktuelle Modus einen geheimen Schlüssel hat.
Kasse
Enable/Disable: Enable Paystack Payment schaltet die Zahlungsmethode ein oder aus. Standard: aus.
Title: der Name der Zahlungsmethode, den Kunden auf der Kasse sehen. Standard: Paystack.
Description: der Text, der auf der Kasse unter der Zahlungsmethode angezeigt wird. Standard: Pay securely using your debit card, credit card, or bank account via Paystack.
API-Schlüssel
Kopieren Sie die geheimen Schlüssel aus dem Paystack-Dashboard, Seite Settings > API Keys & Webhooks. Der Abschnitt verlinkt dorthin.
Test Mode: Enable Test Mode verwendet für neue Zahlungen den geheimen Testschlüssel, und es wird kein echtes Geld abgebucht. Deaktivieren Sie die Option, um echte Zahlungen mit dem geheimen Live-Schlüssel anzunehmen. Zahlungen, die im anderen Modus erfolgt sind, verwenden für Prüfung und Erstattungen weiterhin den Schlüssel ihres eigenen Modus. Standard: an.
Test Secret Key: Ihr geheimer Paystack-Testschlüssel. Er beginnt mit sk_test_.
Live Secret Key: Ihr geheimer Paystack-Live-Schlüssel. Er beginnt mit sk_live_.
Webhook
Der Webhook teilt Ihrem Shop mit, dass eine Zahlung erfolgt ist, auch wenn der Kunde nicht in den Shop zurückkehrt. Setzen Sie im Paystack-Dashboard, Seite Settings > API Keys & Webhooks, die in diesem Abschnitt angezeigte URL sowohl als Test Webhook URL als auch als Live Webhook URL. Sie sieht etwa so aus: https://your-site/wc-api/paystack_p_webhook/. Kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen.
Paystack signiert jeden Webhook mit Ihrem geheimen Schlüssel, daher ist nichts weiter einzurichten. Test-Webhooks werden mit dem geheimen Testschlüssel geprüft, Live-Webhooks mit dem geheimen Live-Schlüssel. Webhooks ohne gültige Signatur werden abgelehnt. Das Plugin verwendet das Ereignis charge.success:
Andere Ereignisse werden mit OK beantwortet und ignoriert. Ohne Webhook wird eine Bestellung nur bestätigt, wenn der Kunde nach der Zahlung in den Shop zurückkehrt. Banküberweisungen und USSD-Zahlungen, die später abgeschlossen werden, werden nur durch den Webhook bestätigt.
Bestellungen
Autocomplete Order: Automatically mark orders as completed after successful payment. Ist die Option aktiv, werden bezahlte Bestellungen statt auf Processing auf Abgeschlossen gesetzt, mit einer Statusänderung und einer E-Mail an den Kunden. Standard: aus.
Erweitert
Debug log: Log Paystack events and API calls for debugging schreibt Details nach WooCommerce > Status > Logs, Quelle wcp_paystack_payment. Fehler werden immer protokolliert. Schlüssel und Kundendaten werden nie protokolliert. Standard: aus.
Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted. Das Deaktivieren des Plugins löscht nichts. Zahlungsdaten, die in Bestellungen gespeichert sind, bleiben immer erhalten. Standard: aus.
Kasse
Der Kunde wählt die Zahlungsmethode (standardmäßig Paystack) und gibt die Bestellung auf. Im Testmodus zeigt die Kasse TESTMODUS AKTIVIERT. Es werden keine echten Abbuchungen vorgenommen. an. Das Plugin startet für die Bestellsumme in der Bestellwährung eine Paystack-Transaktion mit der Rechnungs-E-Mail der Bestellung und leitet den Kunden zur gehosteten Checkout-Seite von Paystack weiter. Dort bezahlt er mit einem der Kanäle, die in Ihrem Paystack-Konto aktiviert sind.
Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn Paystack die Zahlung bestätigt: Wenn der Kunde zurückkehrt und wenn der Webhook eintrifft, liest das Plugin die Transaktion über die Paystack-API mit dem geheimen Schlüssel des Modus aus, in dem die Zahlung gestartet wurde, und prüft Referenz, Status, Betrag und Währung. Wird die Zahlung noch verarbeitet, etwa bei einer Banküberweisung, zeigt die Seite „Bestellung eingegangen“ den Hinweis Ihre Zahlung wird von Paystack bestätigt. Sie erhalten eine E-Mail, sobald die Zahlung bestätigt ist. Der Webhook schließt die Bestellung später ab.
Bricht der Kunde auf der Paystack-Seite ab oder verlässt sie ohne zu zahlen, wartet die Bestellung weiterhin auf die Zahlung. Der Kunde kehrt mit einer Meldung zur Kasse oder zur Seite Pay for order zurück, zum Beispiel Die Zahlung wurde abgebrochen. Sie können es erneut versuchen oder eine andere Zahlungsmethode wählen., Die Zahlung wurde nicht abgeschlossen. Sie können es erneut versuchen oder eine andere Zahlungsmethode wählen. oder Ihre Zahlung wurde abgelehnt. Sie können es erneut versuchen oder eine andere Zahlungsmethode wählen. Der Kunde kann dieselbe Bestellung erneut bezahlen. Eine ältere Zahlungsseite der Bestellung bleibt gültig: Wird sie später bezahlt, wird die Zahlung trotzdem akzeptiert.
Die Seite „Bestellung eingegangen“ öffnet sich nur für den Kunden der Bestellung: über den signierten Rücklink, die Checkout-Sitzung, die die Bestellung angelegt hat, oder das Kundenkonto. Alle anderen werden mit einer neutralen Meldung zur Kasse geleitet, und die Bestellseite wird nicht angezeigt.
Kann Paystack die Zahlung nicht starten, sieht der Kunde eine kurze Meldung, zum Beispiel Paystack konnte die Zahlung nicht starten: gefolgt vom Grund laut Paystack, oder Paystack ist vorübergehend nicht verfügbar. Bitte versuchen Sie es in einem Moment erneut oder wählen Sie eine andere Zahlungsmethode. Die Bestellsumme muss größer als null sein, und die Bestellung braucht eine gültige E-Mail-Adresse.
Die Zahlungsmethode funktioniert auf der klassischen Kasse, im Block „Kasse“ und auf der Seite Pay for order. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.
Das Plugin bietet kein eingebettetes oder Pop-up-Zahlungsformular, keine gespeicherten Karten, keine Abonnements, keine geteilten Zahlungen oder Subaccounts und keine Auswahl von Zahlungskanälen in WooCommerce.
Bestellungen und Erstattungen
Bestellstatus
Pending payment: Der Kunde wurde zu Paystack geleitet und hat noch nicht bezahlt, hat die Paystack-Seite ohne Zahlung verlassen oder die Zahlung wird von Paystack noch verarbeitet. Kehrt der Kunde ohne Zahlung zurück, weist eine Notiz darauf hin, dass die Bestellung weiterhin auf die Zahlung wartet.
Processing or Completed: Die Zahlung wurde bestätigt. Der Status ist Abgeschlossen, wenn Autocomplete Order aktiv ist. Die Bestellnotiz zeigt Betrag, Paystack-Referenz, Transaktionsnummer, Modus (Test oder Live), Zahlungskanal, bei Kartenzahlungen den Kartentyp und die letzten Ziffern sowie die vom Kunden gezahlten Paystack-Gebühren. Die Transaktions-ID der Bestellung ist die Paystack-Referenz (order_...).
On hold: Der bezahlte Betrag oder die Währung weicht von der Bestellung ab (Notiz Paystack amount or currency mismatch), oder die Zahlung ist eingegangen, nachdem die Bestellung storniert worden war. Die Bestellnotiz erklärt, was zu prüfen ist. Bearbeiten Sie die Bestellung oder erstatten Sie die Zahlung.
Failed: Paystack meldet den letzten Zahlungsversuch einer wartenden Bestellung als fehlgeschlagen oder rückgängig gemacht. Ein Fehler bei einem älteren Versuch ändert die Bestellung nicht. Der Kunde kann erneut bezahlen.
Wird ein zweiter Zahlungsversuch für eine bereits bezahlte Bestellung ebenfalls bezahlt, bleibt die Bestellung unverändert. Eine Notiz fordert Sie auf, die doppelte Zahlung im Paystack-Dashboard zu erstatten. Eine Zahlung, die für eine Bestellung in einem anderen Status eingeht, zum Beispiel Refunded, wird nur an der Bestellung vermerkt.
Erstattungen
Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via Paystack. Vollständige und teilweise Erstattungen werden unterstützt. Die Schaltfläche für Erstattungen wird nur bei Bestellungen angeboten, die über eine geprüfte Paystack-Transaktion bezahlt wurden. Die Erstattung geht an die Transaktion, mit der die Bestellung bezahlt wurde, und verwendet den geheimen Schlüssel des Modus (Test oder Live), in dem sie erfolgte; dieser Schlüssel muss also eingerichtet sein. Bei XOF und RWF müssen Erstattungen ganze Beträge sein. Paystack stellt Erstattungen in eine Warteschlange: Die Bestellnotiz zeigt den Status, den Paystack zurückmeldet, etwa pending, sowie die Erstattungs-ID. Lehnt Paystack die Erstattung ab, zeigt WooCommerce Paystack refund failed: mit dem Grund an, und es wird keine Erstattung erfasst.
Im Paystack-Dashboard vorgenommene Erstattungen sowie der endgültige Status von Erstattungen, die Paystack in die Warteschlange gestellt hat, werden nicht mit WooCommerce synchronisiert. Erfassen Sie sie bei Bedarf manuell.
Lizenzschlüssel
Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > Paystack. 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 gültig 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 gilt für eine 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 Paystack Kunden auf der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde Diese Zahlungsmethode ist nicht verfügbar. Bitte wählen Sie eine andere. Angemeldete Shopbetreiber sehen die Zahlungsmethode weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Ein Hinweis erscheint auf der Plugins-Seite und auf den WooCommerce-Seiten. 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
Paystack erscheint nicht auf der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, der aktuelle Modus einen korrekten geheimen Schlüssel hat (Test Secret Key mit sk_test_... im Testmodus, Live Secret Key mit sk_live_... im Live-Modus) und die Bestellwährung eine von Paystack akzeptierte ist. Das Statusfeld oben in den Einstellungen nennt das Problem.
Die Zahlung ist erfolgt, aber die Bestellung bleibt auf Pending payment: Der Webhook hat Ihren Shop nicht erreicht, und der Kunde ist nicht zurückgekehrt. Prüfen Sie im Paystack-Dashboard, ob die Test Webhook URL und die Live Webhook URL genau der in den Einstellungen angezeigten URL entsprechen und ob kein Wartungsmodus, keine Firewall oder kein Passwortschutz sie blockiert. Sehen Sie unter WooCommerce > Status > Logs, Quelle wcp_paystack_payment, nach abgelehnten Webhooks.
Der Webhook antwortet mit „Invalid signature“: Der Webhook wurde nicht mit dem in den Einstellungen eingetragenen geheimen Test- oder Live-Schlüssel signiert, zum Beispiel weil die Schlüssel zu einem anderen Paystack-Konto gehören. Tragen Sie die Schlüssel des Kontos ein, das den Webhook sendet.
Der Webhook antwortet mit „Secret key not configured“: Es ist kein geheimer Schlüssel hinterlegt. Tragen Sie die geheimen Schlüssel in den Einstellungen ein.
Der Webhook antwortet mit „Verification failed“ oder „Busy, retry later“: Die Transaktion konnte in diesem Moment nicht über die Paystack-API gelesen werden, oder die Bestellung wurde gleichzeitig durch die Rückkehr des Kunden aktualisiert. Die Bestellung wird nicht verändert, und Paystack sendet den Webhook erneut.
Der Webhook antwortet mit „OK - unknown reference“: Die Zahlung galt keiner Bestellung dieses Shops, zum Beispiel einer Paystack-Zahlungsseite oder einer anderen Integration im selben Konto. Sie wird ignoriert.
Der Kunde sieht „Payment gateway is not properly configured“: Der geheime Schlüssel des aktuellen Modus fehlt oder ist falsch. Korrigieren Sie ihn entsprechend dem Statusfeld oben in den Einstellungen.
Die 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.
Die 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 eingerichtet. Tragen Sie ihn ein und versuchen Sie es erneut. Die Meldung No verified Paystack payment was found for this order bedeutet, dass die Bestellung nicht über eine geprüfte Paystack-Transaktion bezahlt wurde. Erstatten Sie sie im Paystack-Dashboard.
Der Lizenzblock zeigt einen Fehler: Folgen Sie der Meldung im Block. Ist der Schlüssel etwa 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 Einstellungen des Zahlungsgateways 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, Transaktions-IDs und Paystack-Referenzen.
Paystack ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist nicht mit Paystack verbunden und wird nicht von Paystack unterstützt.