VibeFox Pesapal 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 KES, UGX, TZS, ZMW, RWF oder USD erfolgen. Bei anderen Währungen wird die Zahlungsart an der Kasse ausgeblendet. Die Bestellung wird in ihrer eigenen Währung belastet; die Erweiterung rechnet keine Währungen um. Beträge werden in Hauptwährungseinheiten gesendet und auf die Genauigkeit der Währung gerundet (UGX und RWF ohne Dezimalstellen).

Pesapal-Konto: Sie benötigen den Consumer Key und das Consumer Secret eines Pesapal-Händlerkontos. Sandbox- und Live-Schlüssel sind verschieden. Sandbox-Schlüssel stammen von einem Demo-Händlerkonto auf cybqa.pesapal.com (Pesapal veröffentlicht außerdem Demo-Schlüssel auf seinem Entwicklerportal). Live-Schlüssel stammen aus Ihrem Pesapal-Händler-Dashboard. Im Pesapal-Dashboard muss sonst nichts eingerichtet werden: Die Erweiterung registriert ihre Benachrichtigungs-URL selbst. Ihr Shop muss aus dem Internet erreichbar sein, da Pesapal Zahlungsbenachrichtigungen an ihn sendet.

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

Installation

Der Download ist eine einzelne ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das OpenCart-3-Paket wcp_pesapal_pay-oc3-(Version).ocmod.zip und das OpenCart-4-Paket wcp_pesapal_pay.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_pesapal_pay-oc3-(Version).ocmod.zip. Die Erweiterung hat keine OCMOD-Änderungen, daher muss Extensions > Modifications nicht aktualisiert werden. Statt des Installers können Sie den Inhalt des Ordners upload aus diesem Paket auch in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox Pesapal Pay Gateway 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 im Lizenzblock oben auf der Seite in License key ein und klicken Sie auf Activate (siehe License key).

4. Geben Sie den Sandbox-Consumer-Key und das Sandbox-Secret ein, aktivieren Sie Enable/Disable, klicken Sie auf Save und führen Sie eine Testbestellung durch.

5. Geben Sie den Live-Consumer-Key und das Live-Secret ein, deaktivieren Sie Sandbox mode und klicken Sie auf Save, 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_pesapal_pay.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 Pesapal Pay Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

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

Eine neue Installation startet mit deaktivierter Zahlungsart und aktiviertem Sandbox-Modus.

Konfiguration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Payments > VibeFox Pesapal Pay Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Über den Einstellungen zeigt ein Hinweis den Modus an: SANDBOX — Testzahlungen auf cybqa.pesapal.com — es wird kein echtes Geld belastet. oder LIVE — Echte Zahlungen auf pay.pesapal.com. Eine Warnung erscheint, wenn die Schlüssel des aktuellen Modus fehlen (Geben Sie den Sandbox-Consumer-Key und das Sandbox-Secret ein — bis dahin wird Pesapal an der Kasse nicht angezeigt. oder der entsprechende Hinweis für Live) sowie wenn Pesapal die Standardwährung Ihres Shops nicht unterstützt. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen, kann sie aber nicht speichern.

Beim Speichern wird ein leerer Title nicht akzeptiert: Der bisherige Titel bleibt mit einer Fehlermeldung erhalten, die übrigen Felder werden gespeichert. Sort Order muss eine ganze Zahl sein (negative Werte sind erlaubt), Total eine Zahl größer oder gleich 0, und Geo Zone sowie die Bestellstatus müssen existieren; andernfalls behält dieses Feld seinen vorherigen Wert und zeigt einen Fehler. Beim Speichern werden die zwischengespeicherten Pesapal-Zugriffstoken verworfen.

Pesapal

Enable/Disable: Enable Pesapal 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: Pesapal (M-Pesa, Airtel Money, cards). Pflichtfeld, höchstens 128 Zeichen.

Description: der Text, den der Kunde im Schritt Confirm Order über der Bestätigungsschaltfläche sieht. Standard: Pay securely with M-Pesa, Airtel Money, card or bank via Pesapal. You will be redirected to Pesapal to complete the payment.

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

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

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

API-Zugangsdaten

Dieser Abschnitt erklärt, wo Sie die Schlüssel erhalten, und verlinkt auf cybqa.pesapal.com und pesapal.com. Geben Sie die Sandbox- und die Live-Schlüssel jeweils in ihr eigenes Feld ein.

Sandbox mode: Use the Pesapal sandbox (no real money). Wenn aktiviert, verwenden neue Zahlungen cybqa.pesapal.com mit den Sandbox-Schlüsseln. Deaktivieren Sie die Option, um echte Zahlungen auf pay.pesapal.com mit den Live-Schlüsseln anzunehmen. Standard: ein.

Sandbox consumer key: der Consumer Key Ihres Sandbox-(Demo-)Händlerkontos. Wird nur im Sandbox-Modus verwendet.

Sandbox consumer secret: das Consumer Secret Ihres Sandbox-Händlerkontos. Wird nur im Sandbox-Modus verwendet.

Live consumer key: der Consumer Key aus Ihrem Pesapal-Händler-Dashboard. Wird verwendet, wenn der Sandbox-Modus deaktiviert ist.

Live consumer secret: das Consumer Secret aus Ihrem Pesapal-Händler-Dashboard. Wird verwendet, wenn der Sandbox-Modus deaktiviert ist.

Gespeicherte Schlüssel und Secrets werden nie wieder 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.

Clear saved consumer keys and secrets: wird angezeigt, wenn ein Schlüssel gespeichert ist. Aktivieren Sie das Kästchen und klicken Sie auf Save, um alle vier gespeicherten Schlüssel und Secrets zu entfernen.

Beim Wechsel des Modus oder beim Ändern von Schlüsseln werden nie ein Zugriffstoken oder eine Benachrichtigungs-ID des anderen Modus bzw. der anderen Schlüssel wiederverwendet. Eine im einen Modus gestartete Zahlung wird immer in diesem Modus geprüft, auch nach dem Wechsel.

Bestellstatus

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält erst dann einen Status, wenn Pesapal die Zahlung als „Completed“ gemeldet hat. Jedes Feld unten listet Ihre OpenCart-Bestellstatus auf.

Order Status After Payment: der Status, der gesetzt wird, wenn Pesapal die Zahlung bestätigt. Standard: Processing.

Pesapal Payment On Hold Status: Zahlungen, deren Betrag oder Währung nicht zur Bestellung passt, sowie Zahlungen, die nach einer Stornierung eingehen. Eine Notiz erklärt den Grund. 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.

Cancelled Order Status: Eine Pesapal-Zahlung, die für eine Bestellung in diesem Status (oder im Status für Erstattungen) eingeht, setzt die Bestellung auf Halt, statt sie stillschweigend wieder zu öffnen. Standard: Canceled.

Refunded Status: wird gesetzt, wenn Pesapal meldet, dass die Zahlung der Bestellung rückgängig gemacht wurde. Standard: Refunded.

Zahlungsbenachrichtigungen (IPN)

IPN URL: zeigt die Benachrichtigungs-URL Ihres Shops. Auf OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_pesapal_pay/ipn, auf OpenCart 4 so: https://your-store/index.php?route=extension/wcp_pesapal_pay/payment/wcp_pesapal_pay.ipn. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet. Die URL wird bei der ersten Zahlung automatisch bei Pesapal registriert, getrennt für Sandbox und Live und für jeden Consumer Key, sodass nichts zu konfigurieren ist. Nach der ersten Zahlung zeigt der Abschnitt Registered IPN ID: mit der von Pesapal zurückgegebenen ID an; davor steht dort Für den aktuellen Modus und die aktuellen Schlüssel noch nicht registriert. Die URL muss aus dem Internet erreichbar sein: keine Firewall oder Passwortschutz davor. Sie funktioniert auch im Wartungsmodus des Shops weiter, 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 Pesapal durchlässt).

Erweitert

Debug log: protokolliert Pesapal-Anfragen und -Benachrichtigungen in pesapal_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden; bei 5 MB wird sie nach pesapal_p_debug.old.log.php verschoben. Fehler und Warnungen werden immer protokolliert, auch wenn der Schalter aus ist. Schlüssel, Token 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: löscht die Erweiterungseinstellungen und Protokolle bei der Deinstallation. Pesapal-Daten, die an Bestellungen gespeichert sind (Tracking-IDs, Notizen), gehören zur Zahlungshistorie und bleiben immer erhalten. Das Deaktivieren der Erweiterung löscht nichts. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Consumer Keys und Secrets werden nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Gespeicherte Consumer Keys und Secrets bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Pesapal (M-Pesa, Airtel Money, cards)). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung. OpenCart legt die Bestellung in diesem Schritt an, weiterhin ohne Status. Auf OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose des Zahlungsartenblocks im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine Pesapal-Zahlungsanforderung für den Bestellbetrag in der Bestellwährung, mit den Rechnungsdaten der Zahlungsadresse (auf OpenCart 4, wenn die Kasse keine Zahlungsadresse verlangt, mit denen der Lieferadresse), und leitet den Kunden auf die Pesapal-Zahlungsseite weiter. Die an Pesapal gesendete Zahlungsbeschreibung lautet Order, die Bestellnummer und der Shopname. Dort bezahlt der Kunde mit einer der von Pesapal angebotenen Methoden, etwa M-Pesa, Airtel Money, MTN, Karte oder Banküberweisung. Eine Notiz zur Bestellung hält die Zahlungsanforderung fest.

Die Bestellung wird erst als bezahlt markiert, wenn Pesapal sie bestätigt. Benachrichtigungen von Pesapal und die Rückkehr des Kunden enthalten weder Zahlungsdaten noch Signatur, daher vertraut die Erweiterung ihnen nicht: Bei jeder dieser Meldungen fragt sie den Transaktionsstatus bei Pesapal mit einer authentifizierten Server-zu-Server-Anfrage ab, im Modus, in dem die Zahlung gestartet wurde. Außerdem prüft sie, ob die Transaktion zu dieser Bestellung gehört und ob der bezahlte Betrag und die Währung mit der Bestellung übereinstimmen. 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 Erfolgsseite der OpenCart-Bestellung.

Zahlungen per Mobile Money können einen Moment dauern. Hat Pesapal die Zahlung noch nicht bestätigt, wenn der Kunde zurückkehrt, zeigt eine Seite Payment confirmation den Text Ihre Zahlung wird von Pesapal bestätigt. Sie erhalten eine E-Mail, sobald sie bestätigt ist — Sie müssen nicht erneut bezahlen. mit den Schaltflächen Check again und Back to checkout. Die Benachrichtigung von Pesapal setzt den Bestellstatus, sobald die Zahlung bestätigt ist. Wurde die Bestellung auf Halt gesetzt, zeigt die Erfolgsseite Ihre Zahlung ist eingegangen und wird vom Shop geprüft. Sie erhalten eine E-Mail, sobald die Bestellung bestätigt ist. Wenn eine spätere Zahlung die Bestellung vom Haltstatus in den Bezahlt-Status verschiebt, wird der Kunde per E-Mail benachrichtigt.

Bricht der Kunde auf der Pesapal-Seite ab, kehrt er zur Kasse zurück, mit dem Hinweis Die Pesapal-Zahlung wurde abgebrochen. Sie können es erneut versuchen oder eine andere Zahlungsart wählen. Ist die Zahlung fehlgeschlagen, lautet die Meldung Die Pesapal-Zahlung war nicht erfolgreich. Bitte versuchen Sie es erneut oder wählen Sie eine andere Zahlungsart., und eine Notiz zur Bestellung nennt den Grund. Der Warenkorb bleibt erhalten, und der Kunde kann erneut bezahlen. Auf OpenCart 4 werden diese Meldungen über der Kassenseite angezeigt. OpenCart 3 legt jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird; OpenCart 4 aktualisiert die Bestellung der Kasse. Deshalb prüft die Erweiterung vor einer neuen Zahlung die früheren Versuche des Warenkorbs bei Pesapal: Wurde einer davon inzwischen bezahlt, erhält diese Bestellung ihren Status und der Kunde gelangt zur Erfolgsseite, ohne doppelt zu zahlen. Eine später auf einer älteren Pesapal-Seite des Warenkorbs getätigte Zahlung wird weiterhin akzeptiert. Eine Änderung des Warenkorbs, auch eine neue Menge, gilt als neuer Warenkorb, der eine eigene Zahlung benötigt.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Ist diese Bestellung inzwischen geschlossen worden (zum Beispiel haben Sie sie storniert), oder wurde sie für einen früheren Warenkorb bezahlt und der Warenkorb hat sich seitdem geändert, wird der Kunde zur Kasse zurückgeschickt, mit der Meldung Ihre vorherige Bestellung ist bereits geschlossen. Bitte bestätigen Sie die Bestellung erneut: Der Warenkorb wird mit einer neuen Bestellung bezahlt. Das nächste Confirm Order bezahlt eine neue Bestellung. Eine geschlossene Bestellung wird nie als bezahlt angezeigt.

Kann Pesapal die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order und sieht eine kurze Meldung über der Schaltfläche, zum Beispiel Pesapal ist vorübergehend nicht verfügbar. Bitte versuchen Sie es in ein paar Minuten erneut oder wählen Sie eine andere Zahlungsart., Pesapal ist derzeit nicht verfügbar. Bitte wählen Sie eine andere Zahlungsart. (falsche Schlüssel) oder Pesapal konnte die Zahlung nicht starten: gefolgt vom Grund, den Pesapal angibt. Der technische Grund wird in das Protokoll und in die Bestellnotizen geschrieben. Der Bestellbetrag muss größer als null sein.

Die Erweiterung hat kein Zahlungsformular auf Ihrer eigenen Website (der Kunde bezahlt immer auf der Pesapal-Seite), keine gespeicherten Karten, keine Abonnements oder wiederkehrenden Zahlungen und keine Währungsumrechnung.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (fehlende Bestellung): Der Kunde wurde zu Pesapal geschickt und hat nicht bezahlt, die Zahlung ist fehlgeschlagen oder Pesapal 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): Pesapal meldet die Zahlung als Completed, und Betrag und Währung stimmen überein. Eine Notiz zeigt Betrag, Zahlungsart, den Pesapal-Bestätigungscode und die Tracking-ID. Jede Zahlung wird nur einmal angewendet.

Pesapal Payment On Hold Status (Standard Pending): Der bezahlte Betrag oder die Währung weicht von der Bestellung ab (Notiz Pesapal amount/currency mismatch — held for review), oder Geld ist für eine Bestellung im Status „storniert“ oder „erstattet“ eingegangen. Prüfen Sie die Zahlung im Pesapal-Dashboard und schließen Sie danach die Bestellung ab oder erstatten Sie die Zahlung.

Refunded Status (Standard Refunded): Pesapal meldet die Zahlung, mit der die Bestellung bezahlt wurde, als rückgängig gemacht. Eine Rückbuchung eines anderen Versuchs wird nur an der Bestellung vermerkt.

Wird eine zweite Zahlung für eine Bestellung oder einen Warenkorb, die bzw. der bereits bezahlt ist, ebenfalls abgeschlossen, bleibt die Bestellung unverändert. Eine Notiz an der bezahlten Bestellung bittet Sie, die zweite Zahlung im Pesapal-Dashboard zu erstatten. Stornierte und erstattete Bestellungen werden nie automatisch wieder geöffnet.

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

VibeFox Pesapal Pay Gateway tab

Öffnen Sie unter Sales > Orders eine mit Pesapal bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox Pesapal Pay Gateway die Tracking-ID mit dem Hinweis Sandbox oder Live, die Händlerreferenz, den Pesapal-Status, die Zahlungsart, den Bestätigungscode, den angeforderten und den bezahlten Betrag, den Grund für eine Prüfung, alle Payment attempts der Bestellung (wenn es mehr als einen gibt) und die Payment notes. Der Reiter ist nur lesbar und wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Die Erweiterung sendet keine Erstattungen an Pesapal. Erstatten Sie die Zahlung im Pesapal-Dashboard und erfassen Sie die Erstattung danach manuell in OpenCart. Produktrücksendungen unter Sales > Returns schicken kein Geld über Pesapal zurück.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Pesapal Pay Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Pesapal Pay 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 Schaltflächen Check now zur erneuten Statusprüfung, Change key zum Eingeben eines anderen Schlüssels und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: opencart-payment-pesapal und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit der Berechtigung 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. Nachdem sich die Shop-Adresse geändert hat 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 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 Pesapal 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-Bereich im selben Browser angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert mit (nicht lizenziert — nur für Admins sichtbar), sodass Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. Auf OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop 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 im Admin-Bereich 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 Pesapal-Benachrichtigungen zu bestehenden Zahlungen, einschließlich Rückbuchungen, werden weiterhin angewendet.

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 Admin-Dashboard oder die Seite Edit öffnen: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Die Deinstallation der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Pesapal erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, Consumer Key und Secret des aktuellen Modus eingegeben sind (Sandbox consumer key und Sandbox consumer secret im Sandbox-Modus, Live consumer key und Live consumer secret im Live-Modus) und die Bestellwährung KES, UGX, TZS, ZMW, RWF oder USD ist. Die Warnungen oben in den Einstellungen nennen 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: Die Benachrichtigung von Pesapal hat Ihren Shop nicht erreicht, und der Kunde ist nicht zurückgekehrt. Prüfen Sie, ob die URL unter IPN URL aus dem Internet erreichbar ist (keine Firewall oder kein Passwortschutz davor). Aktivieren Sie Debug log und sehen Sie im Feld Log auf der Erweiterungsseite nach.

So antwortet der Shop auf Benachrichtigungen: Eine verarbeitete Benachrichtigung wird mit HTTP 200 beantwortet. Kann die Erweiterung sie nicht verarbeiten, antwortet sie mit einem Fehler, und Pesapal sendet die Benachrichtigung später erneut: 400 (Tracking-ID fehlt oder ist fehlerhaft), 404 (keine Bestellung dieses Shops hat diese Tracking-ID), 409 (die Transaktion gehört zu einer anderen Händlerreferenz; es wird nichts geändert), 502 (die Pesapal-API war in diesem Moment nicht erreichbar oder die Schlüssel des Modus, in dem die Zahlung gestartet wurde, fehlen) und 503 (die Bestellung wurde gleichzeitig durch die Rückkehr des Kunden verarbeitet oder der Bestellstatus konnte nicht gesetzt werden).

Der Kunde sieht den Hinweis „Pesapal is not available at the moment“: Pesapal hat den Consumer Key oder das Secret des aktuellen Modus abgelehnt. Prüfen Sie, ob die Schlüssel zum Modus passen: Sandbox-Schlüssel funktionieren nur im Sandbox-Modus, Live-Schlüssel nur im Live-Modus. Das Protokoll zeigt den Pesapal-Fehler.

Der Kunde sieht den Hinweis „Pesapal is temporarily unavailable“: Pesapal war nicht erreichbar oder die Benachrichtigungs-URL konnte nicht registriert werden. Lesen Sie das Protokoll und versuchen Sie es erneut.

Der Kunde sieht den Hinweis „This payment method is not available. Please reload the checkout page.“: Die Kassensitzung passt nicht mehr zur Bestellung, oder die Zahlungsart wurde inzwischen deaktiviert. Der Kunde lädt die Kasse neu.

Der Kunde sieht den Hinweis „We could not verify the Pesapal payment“: Der Rücksprung-Link von Pesapal passte zu keiner Bestellung des Shops. Wurde Geld belastet, suchen Sie die Zahlung im Pesapal-Dashboard und prüfen Sie die Bestellung, bevor der Kunde erneut bezahlt.

Zahlungen eines älteren Modus werden nach dem Wechsel nicht bestätigt: Eine Zahlung wird mit den Schlüsseln des Modus geprüft, in dem sie gestartet wurde. Lassen Sie die Schlüssel dieses Modus eingetragen, bis seine Zahlungen bestätigt sind.

Bestellung ist nach der Zahlung im Haltstatus: Lesen Sie die Notizen im Reiter VibeFox Pesapal Pay Gateway. Der bezahlte Betrag oder die Währung wich von der Bestellung ab, oder die Zahlung kam an, nachdem die Bestellung storniert worden war. Prüfen Sie die Zahlung im Pesapal-Dashboard und bearbeiten Sie dann die Bestellung oder erstatten Sie die Zahlung.

Für Entwickler: Die Erweiterung löst die OpenCart-Ereignisse pesapal_p_supported_currencies (die Währungsliste) und pesapal_p_submit_order_payload (die Zahlungsanforderung vor dem Senden an Pesapal) aus.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Pesapal Pay Gateway auf Uninstall (die rote −-Schaltfläche). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart entfernt immer die eigenen Einstellungen der Erweiterung: Enable/Disable, Sort Order, Geo Zone, Total und die Bestellstatus aus dem Abschnitt Bestellstatus, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Das OpenCart-Ereignis der Erweiterung, die zwischengespeicherten Pesapal-Zugriffstoken und die registrierten Benachrichtigungs-IDs werden ebenfalls immer entfernt (auf OpenCart 4 außerdem seine Ereignisse und seine Startaktion, die Benachrichtigungen und die Rückkehr des Kunden im Wartungsmodus durchlässt). Ist Delete data aktiviert, werden die übrigen Einstellungen (Titel, Beschreibung, Sandbox-Modus, Schlüssel, Schalter für das Debug-Protokoll) und das Protokoll entfernt. Ist die Option aus, bleiben sie für eine spätere Neuinstallation erhalten. Die Pesapal-Zahlungsversuche bleiben immer erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Pesapal-Tracking-IDs.

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

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