VibeFox PayPal 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.

PayPal-Konto: ein PayPal-Geschäftskonto mit einer REST-API-App im PayPal Developer Dashboard. Sie benötigen die Client-ID und das Secret der App. Sandbox- und Live-Apps haben unterschiedliche Zugangsdaten. Es ist kein Webhook nötig: Die Erweiterung bestätigt jede Zahlung auf Ihrem Server, während der Kunde im Checkout ist.

Währung: eine der von PayPal unterstützten Währungen: AUD, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, HUF, ILS, JPY, MXN, MYR, NOK, NZD, PHP, PLN, SEK, SGD, THB, TWD oder USD.

VibeFox-Lizenzschlüssel: Erwerb auf vibefox.net. 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_paypal_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_paypal_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-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_paypal_gateway-oc3-(version).ocmod.zip. Die Erweiterung hat keine OCMOD-Modifikationen, 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 PayPal 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 in License key im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate (siehe License key).

4. Erstellen Sie im PayPal Developer Dashboard eine REST-API-App (Sandbox und/oder Live) und kopieren Sie deren Client-ID und Secret in den Abschnitt API credentials.

5. Wählen Sie Capture oder Authorize, aktivieren Sie Enable/Disable und klicken Sie auf Save.

6. Testen Sie mit einem PayPal-Sandbox-Käuferkonto, schalten Sie dann Sandbox mode aus und geben Sie die Live-Zugangsdaten ein.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_paypal_gateway.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 entnimmt den Erweiterungscode 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 PayPal Gateway, klicken Sie auf Install (die grüne Schaltfläche +) und dann auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel, die PayPal-Zugangsdaten und die Zahlungsaktion wie in den Schritten 3 bis 6 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Die Erweiterung verändert die PayPal-Erweiterung, die mit OpenCart 4 mitgeliefert wird, nicht: Beide können im selben Shop installiert werden.

Eine neue Installation startet mit ausgeschalteter Zahlungsmethode und eingeschaltetem Sandbox-Modus.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox PayPal Gateway > Edit. Die Abschnitte stehen links; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt Sie die Seite, wenn die Zahlungsmethode aktiviert ist, aber Client-ID oder Secret des gewählten Modus fehlen, und wenn PayPal die Standardwährung des Shops nicht unterstützt. In beiden Fällen wird die Zahlungsmethode im Checkout ausgeblendet. Solange der Sandbox-Modus eingeschaltet ist, zeigt die Seite Sandbox mode is on: payments go to the PayPal sandbox, no real money is moved. an. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen, kann sie aber nicht speichern.

Beim Speichern darf Title nicht leer sein (bis zu 128 Zeichen), Sort Order muss eine ganze Zahl sein (negative Zahlen sind erlaubt), Total eine Zahl größer oder gleich 0, und die Bestellstatus müssen existieren. Schlägt eine Prüfung fehl, wird nichts gespeichert und die Seite listet die Fehler auf. Beim Speichern der Einstellungen werden zwischengespeicherte PayPal-Zugriffstoken verworfen, sodass die neuen Zugangsdaten sofort verwendet werden.

Allgemein

Enable/Disable: Enable PayPal Gateway schaltet die Zahlungsmethode ein oder aus. Standard: aus.

Title: der Name der Zahlungsmethode, den Kunden in der Kasse sehen. Er wird auch als Zahlungsmethode in der Bestellung gespeichert. Standard: PayPal. Pflichtfeld, bis zu 128 Zeichen.

Description: der Text, den Kunden im Schritt Confirm Order über der PayPal-Schaltfläche sehen. Standard: Pay with your PayPal account or a card via PayPal.

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

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

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

API credentials

Erstellen Sie im PayPal Developer Dashboard eine REST-API-App und kopieren Sie deren Client-ID und Secret. Der Abschnitt enthält Links zu den Sandbox-Apps und den Live-Apps. Es werden nur die Felder des gewählten Modus angezeigt; die Zugangsdaten beider Modi bleiben gespeichert.

Sandbox mode: Zahlungen gehen mit den Sandbox-Zugangsdaten an die PayPal-Sandbox; es wird kein echtes Geld bewegt. Standard: ein. Schalten Sie ihn aus, um Live-Zahlungen anzunehmen. Erfassungen, Stornierungen und Erstattungen verwenden immer die Umgebung, in der die Bestellung bezahlt wurde. Solange er eingeschaltet ist, sieht der Kunde im Schritt Confirm Order den Hinweis Sandbox mode: pay with a PayPal sandbox buyer account — no real money is charged.

Sandbox Client ID: die Client-ID Ihrer REST-API-App für die Sandbox.

Sandbox Secret: das Secret Ihrer REST-API-App für die Sandbox.

Live Client ID: die Client-ID Ihrer REST-API-App für den Live-Betrieb.

Live Secret: das Secret Ihrer REST-API-App für den Live-Betrieb.

Gespeicherte Secrets werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um ein gespeichertes Secret zu entfernen, aktivieren Sie unter dem Feld Clear the saved secret on save und klicken Sie auf Save.

Zahlung

Payment action: was geschieht, wenn der Kunde die Zahlung genehmigt. Standard: Capture.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält erst dann einen Status, nachdem PayPal auf Ihrem Server die Erfassung oder Autorisierung beantwortet hat. Eine abgelehnte Zahlung lässt die Bestellung ohne Status, und der Kunde bleibt im Schritt Confirm Order. Jedes der folgenden Felder listet Ihre OpenCart-Bestellstatus auf.

Order Status After Payment: die Erfassung ist abgeschlossen, auch wenn eine Autorisierung erfasst oder eine ausstehende Erfassung auf der Bestellregisterkarte abgeschlossen wird. Standard: Processing.

Awaiting Payment Status: die Erfassung ist bei PayPal PENDING (Zahlungsprüfung, Mittel noch nicht verbucht). Standard: Pending.

Authorized Status: Zahlungsaktion Authorize: die Mittel sind reserviert, aber noch nicht bezahlt. Standard: Pending.

On Hold (Review) Status: PayPal hat Geld eingezogen, aber die Zahlung konnte nicht gelesen werden oder der Betrag bzw. die Währung stimmt nicht mit der Bestellung überein. Eine Notiz erklärt, was zu prüfen ist. Standard: Pending, da OpenCart keinen Status „On hold“ hat. Eigene Status können Sie unter System > Localisation > Order Statuses anlegen und hier auswählen.

Voided Status: die Autorisierung wurde im Reiter der Bestellung storniert und die reservierten Mittel wurden freigegeben. Standard: Canceled.

Refunded Status: die Zahlung ist vollständig erstattet. Teilerstattungen fügen nur eine Notiz hinzu. Standard: Refunded.

Failed Status: eine ausstehende Erfassung wurde von PayPal abgelehnt. Standard: Failed.

Erweitert

Debug log: protokolliert API-Anfragen in wc_plg_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 wc_plg_debug.old.log.php verschoben. Fehler und Warnungen werden immer protokolliert, auch wenn dieser Schalter aus ist. Zugangsdaten, Tokens und Käuferdaten 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 die Option eingeschaltet, entfernt die Deinstallation der Erweiterung die Einstellungen des Gateways und das Protokoll. Die zwischengespeicherten Tokens werden immer entfernt. Zahlungsdaten der Bestellungen (PayPal-IDs der Bestellungen, Erstattungen) bleiben immer erhalten, sodass früher bezahlte Bestellungen nach einer Neuinstallation noch erstattet, erfasst oder storniert werden können. Standard: aus.

Import / Export

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

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

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsmethode (standardmäßig PayPal). OpenCart legt die Bestellung im Schritt Confirm Order an, noch ohne Status. Dort sieht der Kunde Ihre Beschreibung und die PayPal-Schaltfläche. Ein Klick auf die Schaltfläche erstellt auf Ihrem Server eine PayPal-Bestellung über die Bestellsumme in der Bestellwährung. Der Betrag wird immer auf dem Server berechnet, niemals im Browser. In OpenCart 4 wählt der Kunde die Zahlungsmethode mit der Schaltfläche Choose im Block der Zahlungsmethode, im Fenster Payment method options; die Beschreibung und die PayPal-Schaltfläche erscheinen dann im Bestätigungsblock am Ende der Kassenseite, zusammen mit der Schaltfläche Confirm Order.

Der Kunde genehmigt die Zahlung im PayPal-Fenster mit einem PayPal-Konto oder einer anderen von PayPal angebotenen Finanzierungsquelle. Die Kasse zeigt dann PayPal payment approved. Completing your order… und schließt die Bestellung selbstständig ab. Klickt der Kunde auf Confirm Order, ohne eine Zahlung zu genehmigen, lautet die Meldung Please click the PayPal button and approve the payment first.

Ihr Server liest anschließend die PayPal-Bestellung und prüft, ob sie genehmigt ist, in diesem Checkout erstellt wurde, nicht zu einer anderen Bestellung gehört und ob Betrag und Währung mit der Bestellung übereinstimmen. Erst danach wird die Zahlung erfasst (oder autorisiert). Die Bestellung wird erst als bezahlt markiert, nachdem PayPal es bestätigt hat. Anschließend erhält die Bestellung ihren Status auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung; der Warenkorb wird geleert, und der Kunde sieht die OpenCart-Erfolgsseite der Bestellung.

Hat sich die Bestellsumme nach der Genehmigung geändert, wird nichts erfasst. Der Kunde sieht The order total changed after you approved the payment in PayPal. Please click the PayPal button again to approve the new total. Lehnt PayPal die Zahlung ab, bleibt die Bestellung ohne Status, und der Kunde wird gebeten, auf die PayPal-Schaltfläche zu klicken oder eine andere Zahlungsart zu wählen. Schließt der Kunde das PayPal-Fenster, zeigt die Kasse You cancelled the PayPal payment.

Antwortet PayPal während der Erfassung nicht, sieht der Kunde We could not confirm your PayPal payment yet. Please try again in a moment — you will not be charged twice. Die Genehmigung bleibt für diesen Warenkorb erhalten, auch nach einem Neuladen der Seite: Die Kasse zeigt PayPal payment approved. Click "Confirm Order" to complete it. und Confirm Order verwendet sie erneut. Hat PayPal den früheren Versuch abgeschlossen, wird diese Zahlung verwendet, und eine neue Genehmigung wird nicht erfasst. Wurde die Zahlung eingezogen, der Bestellstatus aber nicht gesetzt, sieht der Kunde Your payment was received, but the order could not be completed automatically. Please contact us — do not pay again. Der nächste Versuch setzt den Status anhand der gespeicherten Zahlung, ohne erneut zu belasten.

OpenCart 3 legt jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird, und OpenCart 4 aktualisiert die Bestellung der Kasse, daher gehört die Zahlung zum Warenkorb: Eine Genehmigung für eine frühere Bestellung desselben Warenkorbs bezahlt die aktuelle Bestellung, wenn die Summe gleich ist, und ein bereits bezahlter Warenkorb wird nie erneut belastet. Eine Änderung des Warenkorbs, auch eine neue Menge, zählt als neuer Warenkorb, der eine eigene Zahlung braucht. Das PayPal-Skript wird nur im Schritt Confirm Order von PayPal geladen und liegt in einem eigenen Namensraum, sodass es nicht mit einer anderen PayPal-Erweiterung auf der Seite kollidiert.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen geschlossen (zum Beispiel haben Sie sie storniert oder die ausstehende Erfassung wurde abgelehnt) oder war sie bereits für einen früheren Warenkorb bezahlt, sieht der Kunde Your previous order of this checkout is already closed or paid. Please refresh the page and confirm the order again — a new order will be created. Nach dem Neuladen der Seite bezahlt die nächste Zahlung eine neue Bestellung. Eine bezahlte Bestellung wird nie als bezahlt für einen anderen Warenkorb angezeigt.

Die Erweiterung hat keine PayPal-Webhooks, keine Pay-Later-Hinweise, keine Kartenfelder, kein Venmo, Apple Pay, Google Pay oder Fastlane, keine gespeicherten Zahlungsmethoden oder Abonnements und keine Schaltflächen auf Produkt- oder Warenkorbseiten. Verwendet werden die in der OpenCart-Kasse eingegebenen Adressen, nicht eine Adresse aus PayPal.

Bestellungen und Erstattungen

Bestellstatus

Ohne Status (fehlende Bestellung): der Kunde hat die Zahlung nicht genehmigt, oder PayPal hat sie abgelehnt. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Bestellstatus nach Zahlung (Standard Processing): die Erfassung ist abgeschlossen. Eine Notiz zeigt den Betrag, die PayPal-Bestellung und die Erfassung.

Autorisierter Status (Standard Pending): die Zahlung wurde autorisiert und wartet auf die Erfassung (Zahlungsaktion Authorize).

Ausstehender Zahlungsstatus (Standard Pending): die Erfassung ist bei PayPal PENDING, zum Beispiel wegen einer Zahlungsprüfung.

Status On Hold (Review) (Standard Pending): der bezahlte Betrag oder die Währung weicht von der Bestellung ab, oder die Zahlung konnte aus der Antwort von PayPal nicht gelesen werden. Die Notiz erklärt es. Prüfen Sie die Bestellung und erfüllen Sie sie oder erstatten Sie die Zahlung.

Status Voided (Standard Canceled): die Autorisierung wurde mit Void PayPal authorization storniert.

Status Failed (Standard Failed): eine ausstehende Erfassung wurde abgelehnt oder ist fehlgeschlagen.

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

Geht eine zweite Zahlung für einen bereits bezahlten Warenkorb ein, bleibt die bezahlte Bestellung unverändert. Eine Notiz bittet Sie, dies in Ihrem PayPal-Konto zu prüfen und zu erstatten.

Notizen sind Einträge im History der Bestellung, die der Kunde nicht sieht. Statusänderungen, die im Reiter der Bestellung vorgenommen werden (Erfassung, Stornierung, Statusprüfung, Erstattung), werden direkt geschrieben, ohne den Kunden zu benachrichtigen und ohne den Bestand zu ändern.

Reiter VibeFox PayPal Gateway

Öffnen Sie unter Sales > Orders eine mit PayPal bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox PayPal Gateway die PayPal order ID und den Intent, bei Sandbox-Zahlungen mit dem Hinweis Sandbox, die Capture ID (mit der Zahlung in Ihrem PayPal-Konto verlinkt, Sandbox oder Live), die Authorization ID, den Status der Zahlung, den Amount, die Beträge Paid / refunded, den Erstattungsverlauf und die PayPal notes der Bestellung. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben; seine Schaltflächen benötigen das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups). Das Ergebnis jeder Aktion wird im Reiter angezeigt.

Erstattungen

Geben Sie im Reiter VibeFox PayPal Gateway den Betrag ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Reason (optional, sent to the buyer), und klicken Sie auf Refund via PayPal. Bestätigen Sie die Frage Refund this amount through PayPal? This cannot be undone. Vollständige und teilweise Erstattungen werden unterstützt. Der Grund wird als Hinweis an den Käufer an PayPal übergeben. Erstattungen erfolgen in Betrag und Währung, die PayPal eingezogen hat; nach einer Abweichung bei Betrag oder Währung können Sie also nur bis zu dem erstatten, was der Kunde tatsächlich bezahlt hat, nicht bis zur Bestellsumme. Die Erstattung wird an die PayPal-Umgebung gesendet, in der die Zahlung erfolgte (Sandbox oder Live), daher müssen die Zugangsdaten dieser Umgebung hinterlegt sein. Akzeptiert PayPal die Erstattung nicht, zeigt der Reiter den Fehler, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird dem Erstattungsverlauf und den Notizen mit der PayPal-Erstattungs-ID und dem Status hinzugefügt; eine PENDING-Erstattung wird später von PayPal abgeschlossen. Eine vollständige Erstattung setzt die Bestellung auf den Refunded Status. Eine Teilerstattung ändert den Status nicht.

Eine nur autorisierte Zahlung kann nicht erstattet werden: Verwenden Sie stattdessen Void PayPal authorization. Produktrücksendungen unter Sales > Returns erstatten kein Geld über PayPal. Erstattungen, Streitfälle und Rückbuchungen, die in Ihrem PayPal-Konto vorgenommen werden, werden nicht mit OpenCart synchronisiert.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox PayPal Gateway ist der erste Block auf Extensions > Extensions > Payments > VibeFox PayPal 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 aktiv 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-paypal 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. 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 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 PayPal Kunden in der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, lehnt der Shop die Erstellung der PayPal-Bestellung ab, und der Kunde sieht An error occurred during PayPal checkout. Please try again. Ein Admin-Benutzer, der im Admin-Bereich im selben Browser angemeldet ist, sieht die Zahlungsmethode im Shop weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. Bei OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Admin-Anmeldung nicht, daher ist die Zahlungsmethode ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint im Dashboard des Admin-Bereichs eine Erinnerung. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: Erstattungen und die Aktionen im Reiter der Bestellung funktionieren weiterhin.

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

Fehlerbehebung

PayPal erscheint nicht in der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, Client-ID und Secret des gewählten Modus eingetragen sind, die Bestellwährung von PayPal unterstützt wird und die Bestellsumme größer als null ist. Die Einstellungsseite zeigt eine Warnung, wenn Zugangsdaten oder die Shopwährung das Problem sind. 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 ging durch, aber die Bestellung bleibt ohne Status: Die Erweiterung hat keinen Webhook, daher wird die Zahlung nur während der Kasse bestätigt. Das passiert, wenn PayPal während der Erfassung nicht geantwortet hat oder der Bestellstatus nicht gesetzt werden konnte. Schalten Sie das Debug log ein und sehen Sie im Feld Log nach, prüfen Sie die Zahlung in Ihrem PayPal-Konto oder lassen Sie den Kunden es erneut versuchen: Ein neuer Versuch belastet nie doppelt und setzt den Status anhand der gespeicherten Zahlung.

PayPal konnte nicht geladen werden: Das PayPal-Skript wurde im Browser nicht geladen, zum Beispiel weil eine Browser-Erweiterung www.paypal.com blockiert oder wegen eines Netzwerkproblems.

PayPal ist momentan nicht verfügbar: Die Zugangsdaten sind falsch oder gehören zum anderen Modus. Kopieren Sie Client-ID und Secret der richtigen App erneut.

Ihre PayPal-Genehmigung konnte keiner Kasse zugeordnet werden: Die PayPal-Bestellung wurde nicht in dieser Kasse erstellt, zum Beispiel nachdem die Sitzung abgelaufen ist. Der Kunde klickt erneut auf die PayPal-Schaltfläche.

Ihre Sitzung ist abgelaufen. Bitte aktualisieren Sie die Seite und versuchen Sie es erneut: Die Kassenseite war zu lange geöffnet. Der Kunde lädt die Seite neu.

Diese Zahlung wird bereits verarbeitet: Derselbe Warenkorb wurde zweimal im selben Moment abgesendet. Der Kunde wartet einen Moment und prüft die E-Mail, bevor er es erneut versucht.

Die Bestellung ist nach der Zahlung im Status Prüfung oder ausstehend: Lesen Sie die Notizen im Reiter VibeFox PayPal Gateway. Die Zahlung wurde autorisiert (erfassen Sie sie mit Capture PayPal payment), die Erfassung ist bei PayPal PENDING (verwenden Sie später Check PayPal payment status), oder der bezahlte Betrag bzw. die Währung stimmte nicht mit der Bestellung überein (erfüllen Sie die Bestellung oder erstatten Sie den bezahlten Betrag).

Erfassung einer Autorisierung schlägt fehl: Die Autorisierung ist möglicherweise älter als 29 Tage oder bereits storniert. Der Reiter und die Notizen zeigen den PayPal-Fehler.

Keine Schaltflächen im Reiter: Der Reiter nennt den Grund: Ihre Benutzergruppe hat kein Recht, die Erweiterung zu ändern, die Zahlung ist vollständig erstattet, oder die Client-ID und das Secret der Umgebung, in der die Zahlung erfolgte, sind nicht eingerichtet.

Erstattung schlägt fehl: Die Bestellung hat keine PayPal-Erfassung (nur eine Autorisierung), der Betrag übersteigt den noch erstattbaren Rest, oder die Zugangsdaten der Umgebung, in der die Zahlung erfolgte, fehlen. Der Reiter nennt, welches zutrifft.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox PayPal 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 Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Die zwischengespeicherten PayPal-Zugriffstoken werden immer entfernt. Ist Delete data on uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Sandbox-Modus, Zugangsdaten, Zahlungsaktion, Protokollierung) und das Protokoll entfernt. Ist es ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die PayPal-Transaktionen und Erstattungen bleiben immer erhalten, sodass früher bezahlte Bestellungen nach einer Neuinstallation noch erstattet, erfasst oder storniert werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

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