VibeFox Paystack for OpenCart — Hilfe

Anforderungen

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.

Währung: Die Bestellung muss in einer Währung vorliegen, die Paystack akzeptiert: NGN, USD, GHS, ZAR, KES, XOF, EGP oder RWF, sofern in Ihrem Paystack-Konto aktiviert. In anderen Währungen wird die Zahlungsart 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, da die Zahlung auf der gehosteten Seite von Paystack erfolgt. Im Paystack-Dashboard legen Sie außerdem die Webhook-URL Ihres Shops fest (siehe Konfiguration). Ihr Shop muss aus dem Internet erreichbar sein, um Webhooks zu empfangen.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert auf einer 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_paystack_payment-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_paystack_payment.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-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_paystack_payment-oc3-(version).ocmod.zip. Die Erweiterung hat keine OCMOD-Änderungen, daher muss Extensions > Modifications nicht aktualisiert werden. Statt des Installers können Sie auch den Inhalt des Ordners upload dieses Pakets in das Stammverzeichnis Ihres Shops kopieren.

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

3. Klicken Sie auf Edit (die Stift-Schaltfläche), 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 Schlüssel aus dem Paystack-Dashboard ein und legen Sie die Webhook-URL im Paystack-Dashboard fest (siehe Konfiguration).

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Lassen Sie Test Mode eingeschaltet, bis Sie eine Testzahlung durchgeführt haben, und schalten Sie ihn dann aus, um echte Zahlungen anzunehmen.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_paystack_payment.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 (die grüne +-Schaltfläche).

3. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox Paystack Payment, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

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

Bei einer neuen Installation ist die Zahlungsart zunächst deaktiviert und der Testmodus eingeschaltet.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Paystack Payment > Edit. Die Abschnitte sind links aufgeführt; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen zeigt ein Statusfeld den Modus an: Testmodus: Es wird kein echtes Geld belastet. oder Live-Modus: Echte Zahlungen werden angenommen. Es warnt außerdem, wenn der geheime Schlüssel des aktuellen Modus leer ist, wenn in einem Feld für geheime Schlüssel ein öffentlicher Schlüssel (pk_...) eingegeben wurde, wenn im Live-Modus ein Testschlüssel (sk_test_...) oder im Testmodus ein Live-Schlüssel (sk_live_...) hinterlegt ist und wenn Paystack die Standardwährung Ihres Shops nicht akzeptiert. Solange ein Schlüsselproblem besteht, wird die Zahlungsart in der Kasse ausgeblendet. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern darf Title nicht leer sein und nicht länger als 128 Zeichen sein, Sort Order muss eine ganze Zahl sein, Total muss eine Zahl von 0 oder größer sein, und die Geo Zone sowie die Bestellstatus müssen vorhanden sein; andernfalls wird nichts gespeichert. Schlüsselprobleme verhindern das Speichern nicht: Das Statusfeld nennt sie.

Paystack

Der Abschnitt beginnt mit einem kurzen Hinweis: Karten, Banküberweisungen, USSD und mobiles Geld auf der gehosteten Zahlungsseite von Paystack, jede Zahlung wird auf dem Server über die Paystack-API bestätigt, sowie die akzeptierten Währungen.

Enable/Disable: Enable Paystack Payment schaltet die Zahlungsart ein oder aus. Standard: aus.

Title: der Name der Zahlungsart, den Kunden in der Kasse sehen. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Standard: Paystack. Pflichtfeld, höchstens 128 Zeichen.

Description: der Text, der dem Kunden im Schritt Confirm Order oberhalb der Bestätigungsschaltfläche angezeigt wird. Standard: Pay securely using your debit card, credit card, or bank account via Paystack.

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

Geo Zone: Paystack nur für Zahlungsadressen in der gewählten Geo Zone anbieten. Standard: All zones. Geo Zones werden unter System > Localisation > Geo Zones eingerichtet.

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

API-Schlüssel

Kopieren Sie die geheimen Schlüssel aus dem Paystack-Dashboard, Seite Settings > API Keys & Webhooks. Der Abschnitt verlinkt auf diese Seite.

Test Mode: verwendet für neue Zahlungen den geheimen Testschlüssel, und es wird kein echtes Geld belastet. Schalten Sie ihn aus, um echte Zahlungen mit dem geheimen Live-Schlüssel anzunehmen. Zahlungen, die im anderen Modus getätigt wurden, verwenden für Prüfung und Erstattungen weiterhin den Schlüssel ihres eigenen Modus. Standard: ein. Solange er eingeschaltet ist, sehen Kunden im Schritt Confirm Order die Meldung TESTMODUS AKTIVIERT. Es werden keine echten Belastungen vorgenommen.

Test Secret Key: Ihr geheimer Testschlüssel von Paystack. Er beginnt mit sk_test_.

Live Secret Key: Ihr geheimer Live-Schlüssel von Paystack. Er beginnt mit sk_live_.

Gespeicherte Schlüssel werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Gespeichert — leer lassen, um ihn zu behalten. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um einen gespeicherten Schlüssel zu entfernen, aktivieren Sie unter dem Feld Clear the saved value und klicken Sie auf Save.

Webhook

Der Webhook teilt Ihrem Shop mit, dass eine Zahlung erfolgt ist, auch wenn der Kunde nicht in den Shop zurückkehrt. Tragen Sie im Paystack-Dashboard, auf der Seite Settings > API Keys & Webhooks, die URL, die unter Webhook URL in diesem Abschnitt angezeigt wird, sowohl als Test Webhook URL als auch als Live Webhook URL ein. Auf OpenCart 3 hat sie das Format https://your-store/index.php?route=extension/payment/wcp_paystack_payment/webhook, auf OpenCart 4 https://your-store/index.php?route=extension/wcp_paystack_payment/payment/wcp_paystack_payment.webhook. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet. Kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen.

Paystack signiert jeden Webhook mit Ihrem geheimen Schlüssel, daher muss nichts weiter konfiguriert werden. Webhooks ohne gültige Signatur werden abgelehnt. Die Erweiterung verwendet das Ereignis charge.success:

Andere Ereignisse werden mit OK beantwortet und ignoriert. Ohne den 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

OpenCart erstellt die Bestellung im Schritt Confirm Order ohne Status (eine fehlende Bestellung, missing order). Die Bestellung erhält erst dann einen Status, wenn Paystack die Zahlung über die API bestätigt hat. Jedes Statusfeld unten listet Ihre OpenCart-Bestellstatus auf.

Autocomplete Order: ist sie aktiviert, erhalten bezahlte Bestellungen den Complete Order Status statt des Paid Order Status. Standard: aus.

Paid Order Status: der Status nach einer bestätigten Zahlung. Standard: Processing.

Complete Order Status: der Status nach einer bestätigten Zahlung, wenn Autocomplete Order aktiviert ist. Standard: Complete.

Awaiting Payment Status: Der Kunde ist zurückgekehrt, während Paystack die Zahlung noch verarbeitete (Banküberweisung, USSD, mobiles Geld). Die Bestellung behält diesen Status, bis der Webhook die Zahlung 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 Status: eine Zahlung, die Paystack noch verarbeitete, ist für eine Bestellung im Wartestatus fehlgeschlagen. Standard: Failed.

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

Erweitert

Debug log: schreibt Paystack-Ereignisse und API-Aufrufe in paystack_p_debug.log.php im Logordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden, und bei 5 MB wird sie nach paystack_p_debug.old.log.php verschoben. Fehler und Warnungen werden immer protokolliert. Schlüssel und Kundendaten werden nie protokolliert. Standard: aus.

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: ist sie aktiviert, entfernt das Deinstallieren der Erweiterung die Gateway-Einstellungen und das Protokoll. Zahlungsdaten, die in Bestellungen gespeichert sind, bleiben immer erhalten. Standard: aus.

Import / Export

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

Import: fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Die gespeicherten geheimen Schlüssel bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Paystack). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis Sie werden zur sicheren Paystack-Seite weitergeleitet, um die Zahlung abzuschließen. OpenCart erstellt die Bestellung in diesem Schritt, weiterhin ohne Status. Auf OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose im Block der Zahlungsart im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order. Wenn der Kunde auf Confirm Order klickt, startet die Erweiterung eine Paystack-Transaktion über den Bestellbetrag in der Bestellwährung mit der E-Mail-Adresse des Kunden und leitet den Kunden zur gehosteten Kassenseite von Paystack weiter. Dort bezahlt der Kunde über einen der Kanäle, die in Ihrem Paystack-Konto aktiviert sind. Die Zahlung enthält die Bestellnummer und den Namen des Kunden.

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 die Erweiterung die Transaktion über die Paystack-API und prüft Referenz, Status, Betrag und Währung. Die Bestellung erhält dann ihren Status auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung.

Wenn die Zahlung noch verarbeitet wird, zum Beispiel bei einer Banküberweisung, erhält die Bestellung den Awaiting Payment Status, sobald der Kunde zurückkehrt, und die Erfolgsseite zeigt Vielen Dank. Ihre Zahlung wird von Paystack bestätigt; Sie erhalten eine E-Mail-Bestätigung. Der Webhook schließt die Bestellung später ab, und der Kunde erhält die OpenCart-Statusmitteilung per E-Mail, sobald die Bestellung bezahlt ist oder die Zahlung fehlschlägt. Bei einer Bestellung in Prüfung zeigt die Erfolgsseite Ihre Zahlung wurde empfangen und Ihre Bestellung wird geprüft. Wir melden uns, falls noch etwas benötigt wird. Wenn Paystack beim Zurückkehren des Kunden nicht erreicht werden kann oder die Zahlung noch nicht bestätigt hat, bittet eine Seite Payment confirmation den Kunden, nicht erneut zu zahlen, und bietet Check again und Back to checkout an; der Webhook setzt den Bestellstatus, sobald er eintrifft.

Klickt der Kunde auf der Paystack-Seite auf Cancel payment, verlässt er sie ohne zu zahlen, oder wird die Zahlung abgelehnt, bleibt die Bestellung ohne Status und der Warenkorb bleibt erhalten. Der Kunde kehrt mit einer Meldung zur Kasse zurück: Die Zahlung wurde abgebrochen. Sie können es erneut versuchen oder eine andere Zahlungsart wählen., Die Zahlung wurde nicht abgeschlossen. Sie können es erneut versuchen oder eine andere Zahlungsart wählen. oder Ihre Zahlung wurde abgelehnt. Sie können es erneut versuchen oder eine andere Zahlungsart wählen. Auf OpenCart 4 werden diese Meldungen oberhalb der Kassenseite angezeigt.

Jeder neue Versuch (OpenCart 3 erstellt jedes Mal eine neue Bestellung, wenn der Schritt Confirm Order angezeigt wird, OpenCart 4 aktualisiert die Bestellung der Kasse) startet eine neue Paystack-Transaktion. Eine ältere Zahlungsseite bleibt gültig: Wird sie später bezahlt, wird die Zahlung trotzdem angenommen. Bevor eine neue Zahlung startet, werden die offenen Versuche desselben Warenkorbs der letzten 24 Stunden bei Paystack geprüft. Ist der Warenkorb bereits bezahlt, in Prüfung oder wartet er auf eine Banküberweisung, gelangt der Kunde direkt zur Erfolgsseite und es wird keine zweite Zahlung gestartet. Wird eine andere Bestellung desselben Warenkorbs dennoch bezahlt, bleibt diese Bestellung ohne Status, und die bezahlte Bestellung erhält eine Notiz, die doppelte Zahlung zu erstatten. Eine Änderung des Warenkorbs, auch eine neue Menge, gilt als neuer Warenkorb, der eine eigene Zahlung benötigt.

Auf OpenCart 4 bleibt die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel von Ihnen storniert), wird der Kunde mit der Meldung Ihre vorherige Bestellung wurde ohne Zahlung storniert. Bitte bestätigen Sie die Bestellung erneut, um mit einer neuen Bestellung zu bezahlen. zurück zur Kasse geschickt. Das nächste Confirm Order bezahlt eine neue Bestellung. War diese Bestellung bereits für einen früheren Warenkorb bezahlt und hat sich der Warenkorb seitdem geändert, wird der Kunde zur Kasse zurückgeführt, und das nächste Confirm Order bezahlt eine neue Bestellung des aktuellen Warenkorbs. Eine geschlossene Bestellung wird nie als bezahlt angezeigt.

Der Rücksprung-Link funktioniert nur mit seinem eigenen zufälligen Token. Eine Rückkehr, die keiner Bestellung zugeordnet werden kann, führt zur Kasse mit der Meldung Diese Zahlung konnte keiner Bestellung zugeordnet werden. Falls Ihnen etwas berechnet wurde, kontaktieren Sie uns bitte.

Kann Paystack die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung oberhalb der Schaltfläche, zum Beispiel Paystack konnte die Zahlung nicht starten: gefolgt vom Grund aus Paystack, oder Paystack ist vorübergehend nicht verfügbar. Bitte versuchen Sie es in Kürze erneut oder wählen Sie eine andere Zahlungsart. Der Bestellbetrag muss größer als null sein, und der Kunde braucht eine gültige E-Mail-Adresse.

Der Webhook funktioniert auch, wenn der Shop im Wartungsmodus ist, weil OpenCart Anfragen von Zahlungserweiterungen durchlässt (auf OpenCart 4 fügt die Erweiterung dafür eine eigene Startaktion hinzu, die außerdem die Rückkehr des Kunden von Paystack zulässt).

Die Erweiterung hat kein eingebettetes oder Popup-Zahlungsformular, keine gespeicherten Karten, keine Abonnements, keine Teilzahlungen oder Subaccounts und keine Auswahl von Zahlungskanälen in OpenCart.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (fehlende Bestellung): der Kunde wurde zu Paystack geschickt und hat nicht bezahlt, hat die Paystack-Seite verlassen, oder Paystack hat die Zahlung noch nicht bestätigt. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Awaiting Payment Status (Standard Pending): der Kunde ist zurückgekehrt, während Paystack die Zahlung noch verarbeitete, zum Beispiel bei einer Banküberweisung oder USSD. Die Bestellung wechselt in den bezahlten Status, sobald Paystack die Zahlung bestätigt. Wird eine solche Zahlung nie abgeschlossen, bleibt die Bestellung in diesem Status, bis Sie ihn ändern.

Paid Order Status (Standard Processing) oder Complete Order Status: die Zahlung wurde bestätigt. Der Complete-Status wird verwendet, wenn Autocomplete Order aktiviert ist. Eine Notiz zeigt den Betrag, die Paystack-Referenz, die Transaktionsnummer, den Modus (Test oder Live), den Zahlungskanal, bei Kartenzahlungen den Kartentyp und die letzten Ziffern sowie alle Paystack-Gebühren, die vom Kunden getragen wurden.

On Hold (Review) Status (Standard Pending): der bezahlte Betrag oder die Währung weicht von der Bestellung ab (Notiz Paystack amount or currency mismatch), oder die Zahlung ging ein, nachdem die Bestellung storniert oder ohne Zahlung auf einen anderen Status gesetzt wurde. Die Notiz erklärt, was zu prüfen ist. Bearbeiten Sie die Bestellung oder erstatten Sie die Zahlung.

Failed Status (Standard Failed): Paystack meldet den letzten Zahlungsversuch einer Bestellung im Wartestatus als fehlgeschlagen oder rückgängig gemacht. Ein Fehler eines älteren Versuchs ändert die Bestellung nicht.

Trifft eine zweite Zahlung für eine bereits bezahlte Bestellung ein, wird die Bestellung nicht geändert. Eine Notiz bittet Sie, die doppelte Zahlung im Paystack-Dashboard zu erstatten. Eine Zahlung, die für eine Bestellung in einem anderen Verarbeitungsstatus eingeht, zum Beispiel Shipped, wird nur auf der Bestellung vermerkt.

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

Registerkarte VibeFox Paystack Payment

Öffnen Sie unter Sales > Orders eine Bestellung, die mit Paystack bezahlt wurde. Unten auf der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox Paystack Payment die Transaction reference, den Mode mit der Kennzeichnung Test für Testzahlungen, den Status der Zahlung, die Transaction ID, den Channel und die Card, das Zahlungsdatum, die Beträge Paid / refunded, das Erstattungsformular, den Erstattungsverlauf und die Paystack notes der Bestellung. Die Registerkarte wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie auf der Registerkarte VibeFox Paystack Payment den Amount ein (der noch nicht erstattete Betrag wird eingetragen), optional einen Reason (optional), und klicken Sie auf Refund via Paystack. Bestätigen Sie die Abfrage Diesen Betrag über Paystack erstatten? Dies kann nicht rückgängig gemacht werden. Vollständige und teilweise Erstattungen werden unterstützt. Sie benötigen das Recht, die Erweiterung zu ändern (einzustellen unter System > Users > User Groups). 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; daher muss dieser Schlüssel hinterlegt sein. Erstattungen erfolgen in dem Betrag und der Währung, die Paystack belastet hat. Daher können Sie bei einer Bestellung in Prüfung nach einer Abweichung von Betrag oder Währung nur bis zu dem erstatten, was der Kunde tatsächlich bezahlt hat, nicht den Bestellbetrag. Bei XOF und RWF müssen Erstattungen ganze Beträge sein.

Paystack reiht Erstattungen in eine Warteschlange ein: Die Notiz und der Erstattungsverlauf zeigen den von Paystack gemeldeten Status, zum Beispiel pending, sowie die Erstattungs-ID. Lehnt Paystack die Erstattung ab, zeigt die Registerkarte Paystack refund failed: mit dem Grund, und es wird keine Erstattung verbucht. Eine vollständige Erstattung setzt die Bestellung auf den Refunded Status, ohne den Kunden zu benachrichtigen und ohne Produkte zurück in den Bestand zu buchen, wie bei einer manuellen Statusänderung. Eine Teilerstattung ändert den Status nicht. Erstattungen sind verfügbar, sobald Paystack die Zahlung bestätigt hat.

Produktrücksendungen unter Sales > Returns senden kein Geld über Paystack zurück. Im Paystack-Dashboard vorgenommene Erstattungen sowie der endgültige Status von Erstattungen, die Paystack in die Warteschlange gestellt hat, werden nicht mit OpenCart synchronisiert. Falls nötig, tragen Sie sie manuell ein.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Paystack Payment ist der erste Block unter Extensions > Extensions > Payments > VibeFox Paystack Payment > 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 Schaltflächen Check now, um den Status erneut zu prüfen, Change key, um einen anderen Schlüssel einzugeben, und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: opencart-payment-paystack 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 Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Nach einer Änderung der Shop-Adresse oder nachdem Sie in Ihrem Konto einen Domain-Platz 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 auf einer Domain: der 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 Paystack Kunden in der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Ein Admin-Benutzer, der im Admin-Bereich im selben Browser angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert mit (unlicensed — visible to admins only), sodass Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. Auf OpenCart 4 ist diese Vorschau nicht verfügbar: Die Shop-Seite sieht die Admin-Anmeldung nicht, daher wird die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint auf dem Dashboard des Admin-Bereichs eine Erinnerung. Schließen Sie sie mit ×, um sie für 7 Tage auszublenden. Bestehende Bestellungen sind nicht betroffen: Bereits begonnene Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, aber Updates und Support benötigen eine Verlängerung. Der Status wird automatisch erneut geprüft, wenn Sie das Dashboard oder die Seite Edit im Admin-Bereich ö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 Lizenzschlüssel und Lizenzstatus immer entfernt.

Fehlerbehebung

Paystack erscheint nicht in 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 ist, die Paystack akzeptiert. Das Statusfeld oben in den Einstellungen nennt das Problem. 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-Betrag erreicht.

Die Zahlung ist erfolgt, aber die Bestellung bleibt ohne Status: der Webhook hat Ihren Shop nicht erreicht, und der Kunde ist nicht zurückgekehrt. Prüfen Sie im Paystack-Dashboard, dass die Test Webhook URL und die Live Webhook URL genau der URL unter Webhook URL entsprechen und dass keine Firewall oder kein Passwortschutz sie blockiert. Aktivieren Sie Debug log und sehen Sie im Feld Log nach abgelehnten Webhooks.

Der Webhook antwortet Invalid signature: der Webhook wurde nicht mit dem in den Einstellungen eingetragenen 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 Secret key not configured: es ist kein geheimer Schlüssel hinterlegt. Tragen Sie die geheimen Schlüssel in den Einstellungen ein.

Der Webhook antwortet Verification failed, Busy, retry later oder Order could not be updated, retry later: die Transaktion konnte in diesem Moment nicht über die Paystack-API gelesen werden, der Warenkorb wurde gleichzeitig durch die Rückkehr des Kunden verarbeitet, oder der Bestellstatus konnte nicht gesetzt werden. Paystack sendet den Webhook erneut. Das Protokoll zeigt den Grund.

Der Webhook antwortet OK - unknown reference: die Zahlung wurde nicht für eine Bestellung dieses Shops getätigt, zum Beispiel über eine Paystack-Zahlungsseite oder eine andere Integration auf demselben Konto. Sie wird ignoriert.

Die Webhook-URL zeigt im Browser Empty body: das ist normal. Die URL akzeptiert nur Anfragen von Paystack.

Der Kunde sieht Payment gateway is not properly configured: der geheime Schlüssel des aktuellen Modus fehlt oder ist falsch. Beheben Sie es, wie es das Statusfeld oben in den Einstellungen angibt. This payment method is not available. nach Confirm Order bedeutet, dass die Zahlungsart in der Zwischenzeit deaktiviert wurde oder die Kasse nicht mehr zur Bestellung passt: Der Kunde lädt die Kasse neu.

Die Bestellung ist nach der Zahlung im Prüfstatus: lesen Sie die Notizen auf der Registerkarte VibeFox Paystack Payment (siehe Bestellstatus) und bearbeiten Sie dann die Bestellung oder erstatten Sie die Zahlung.

Die Bestellung bleibt im Wartestatus: Paystack hat die Zahlung noch nicht bestätigt. Prüfen Sie die Transaktion im Paystack-Dashboard und die Webhook-Einstellungen. Hat der Kunde die Zahlung nie abgeschlossen, ändern Sie den Status manuell.

Kein Erstattungsformular auf der Registerkarte: die Registerkarte nennt den Grund: Die Zahlung ist noch nicht bestätigt, sie ist vollständig erstattet, Ihre Benutzergruppe hat kein Recht, die Erweiterung zu ändern, oder der geheime Schlüssel des Zahlungsmodus fehlt.

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

Für Entwickler: Die Erweiterung löst die OpenCart-Ereignisse paystack_p_payment_request (die Transaktionsanfrage), paystack_p_supported_currencies und paystack_p_currency_decimals aus.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Paystack Payment auf Uninstall (die rote −-Schaltfläche). 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ückkehren. Das OpenCart-Ereignis der Erweiterung wird ebenfalls entfernt (auf OpenCart 4 werden seine Ereignisse und seine Startaktion entfernt, über die Webhook und Rückkehr des Kunden auch im Wartungsmodus durchgelassen werden). Ist Delete data on uninstall aktiviert, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Testmodus, Schlüssel, Autocomplete, Protokollierung) und das Protokoll entfernt. Ist die Option deaktiviert, bleiben sie für eine spätere Neuinstallation erhalten. Die Paystack-Zahlungsdaten der Bestellungen und die Erstattungen bleiben immer erhalten, sodass zuvor bezahlte Bestellungen nach einer Neuinstallation noch erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Um auch die Dateien der Erweiterung zu entfernen, gehen Sie auf OpenCart 4 nach der Deinstallation zu Extensions > Installer und klicken neben VibeFox Paystack Payment in der Liste der installierten Erweiterungen auf Uninstall (die orangefarbene −-Schaltfläche) und danach auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

Paystack ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung steht in keiner Verbindung zu Paystack und wird von Paystack nicht unterstützt.