VibeFox PayPlug 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 und Beträge: Euro (EUR), von 0,99 bis 20.000,00 pro Zahlung, die Standardwerte von PayPlug. Der Euro muss unter System > Localisation > Currencies aktiviert sein und vom Kunden ausgewählt werden. Bei einer anderen Kassenwährung oder außerhalb dieser Grenzen wird die Zahlungsart ausgeblendet.

PayPlug-Konto: Sie benötigen die geheimen Schlüssel Ihres PayPlug-Kontos: den Testschlüssel (sk_test_...) und/oder den Live-Schlüssel (sk_live_...). Weitere Schlüssel sind nicht nötig, und in PayPlug muss keine Benachrichtigung eingerichtet werden. Ihr Shop muss aus dem Internet erreichbar sein, um Benachrichtigungen zu empfangen; andernfalls werden Bestellungen bestätigt, wenn der Kunde von PayPlug zurückkehrt.

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

Installation

Die Download-Datei ist ein einziges ZIP-Archiv mit den Paketen für beide OpenCart-Versionen. Entpacken Sie es auf Ihrem Computer. Es enthält README.txt, das Paket für OpenCart 3 wcp_payplug_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_payplug_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_payplug_gateway-oc3-(version).ocmod.zip. Die Erweiterung enthält 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 PayPlug 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 Schaltfläche mit dem Stift), um die Einstellungsseite zu öffnen. Tragen Sie Ihren VibeFox-Lizenzschlüssel unter 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 PayPlug-Portal ein (siehe Konfiguration).

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Testen Sie eine Zahlung mit aktiviertem Test Mode und schalten Sie ihn danach 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_payplug_gateway.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 in der Liste der installierten Erweiterungen auf derselben Seite. 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 PayPlug Gateway, klicken Sie auf Install (die grüne Schaltfläche +) und dann auf Edit (die Schaltfläche mit dem Stift).

4. Tragen Sie den Lizenzschlüssel und die geheimen PayPlug-Schlüssel ein, wie in den Schritten 3 bis 5 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Notification URL ist anders (siehe Benachrichtigungen).

Eine neue Installation startet mit deaktivierter Zahlungsart und eingeschaltetem Testmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox PayPlug Gateway > Edit. Die Abschnitte stehen links; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Über den Einstellungen warnt die Seite, wenn die Zahlungsart aktiviert ist, aber der geheime Schlüssel des aktuellen Modus leer ist, und wenn die Standardwährung des Shops nicht EUR ist. In beiden Fällen wird die Zahlungsart in der Kasse ausgeblendet (bei einer anderen Standardwährung, solange diese Währung gewählt ist). Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern muss Title 1 bis 128 Zeichen lang sein, Sort Order muss eine ganze Zahl sein, Total muss eine Zahl von 0 oder mehr sein und die Bestellstatus müssen vorhanden sein; andernfalls wird nichts gespeichert und die Seite listet die Fehler auf. Ein geheimer Schlüssel mit falschem Format wird nicht gespeichert, die übrigen Einstellungen aber schon: Die Seite zeigt Settings saved, except the secret key shown in red. und zum Beispiel Test Secret Key must start with "sk_test_". The previous value was kept.

Checkout

Enable/Disable: Enable PayPlug Gateway schaltet die Zahlungsart ein oder aus. Standard: aus.

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

Description: der Text, den der Kunde im Schritt Confirm Order über dem Bestätigungsbutton sieht. Standard: Pay securely by card via PayPlug.

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

Geo Zone: bietet PayPlug nur für Rechnungsadressen in der gewählten Geozone an. Standard: All zones. Geozonen richten Sie unter System > Localisation > Geo Zones ein.

Total: der Kassenbetrag in der Standardwährung des Shops, den eine Bestellung erreichen muss, damit PayPlug angeboten wird. Lassen Sie das Feld leer, um PayPlug bei jedem Betrag anzubieten. PayPlug selbst akzeptiert 0,99 bis 20.000,00 EUR pro Zahlung.

API-Schlüssel

Ihre geheimen Schlüssel finden Sie im PayPlug-Portal unter Developers > API keys. Der Abschnitt enthält einen Link zum Portal.

Test Mode: verwendet den geheimen Testschlüssel für neue Zahlungen. Es werden keine echten Zahlungen verarbeitet. Zahlungen, die im anderen Modus getätigt wurden, verwenden für Statusprüfungen und Erstattungen weiterhin den Schlüssel ihres eigenen Modus. Standard: an. Ist er aktiv, sieht der Kunde im Schritt Confirm Order den Hinweis Test mode: no real payment will be made.

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

Live Secret Key: Ihr geheimer Livschlüssel von PayPlug. Er beginnt mit sk_live_.

Gespeicherte Schlüssel werden nie erneut 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 einen gespeicherten Schlüssel zu entfernen, setzen Sie unter dem Feld den Haken bei Clear the saved key on save und klicken Sie auf Save.

Benachrichtigungen

Notification URL: die Adresse, die die Erweiterung bei jeder Zahlung an PayPlug sendet. In OpenCart 3 sieht sie so aus: https://your-store/index.php?route=extension/payment/wcp_payplug_gateway/webhook, in OpenCart 4 so: https://your-store/index.php?route=extension/wcp_payplug_gateway/payment/wcp_payplug_gateway.webhook. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet. Im PayPlug-Portal muss nichts eingetragen werden. Jede Benachrichtigung wird geprüft, indem die Zahlung über die PayPlug-API erneut abgefragt wird, sodass Zahlungen auch dann bestätigt werden, wenn der Kunde nicht in den Shop zurückkehrt. Die URL muss aus dem Internet erreichbar sein; andernfalls werden Bestellungen nur bestätigt, wenn der Kunde von PayPlug zurückkehrt.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält erst dann einen Status, wenn PayPlug die Zahlung gemeldet hat, durch die Benachrichtigung oder die Rückkehr des Kunden; die Zahlung wird immer über PayPlug erneut abgefragt. Jedes Feld unten listet Ihre OpenCart-Bestellstatus auf.

Order Status After Payment: der Status nach einer erfolgreichen Zahlung, zum Beispiel Processing oder Complete. Standard: Processing.

PayPlug Payment On Hold 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.

Payment Error Status: die autorisierte Zahlung einer Bestellung in Bearbeitung ist fehlgeschlagen oder wurde storniert. Standard: Failed.

Refunded Status: wird gesetzt, nachdem die Zahlung auf der Bestellseite vollständig erstattet wurde. Standard: Refunded.

Erweitert

Logging: protokolliert API-Aufrufe und Benachrichtigungen in ppg_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über den Browser geöffnet werden. Fehler und Warnungen werden immer protokolliert. Geheime Schlüssel, Kartendaten 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 die Option aktiv, werden beim Deinstallieren der Erweiterung ihre Einstellungen und ihr Protokoll gelöscht. Die PayPlug-Zahlungs- und Erstattungsdatensätze der Bestellungen 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. Gespeicherte geheime Schlüssel bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig PayPlug). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will be redirected to the secure PayPlug payment page to pay by card.; im Testmodus zusätzlich Test mode: no real payment will be made. OpenCart legt die Bestellung in diesem Schritt an, noch ohne Status. In 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. Klickt der Kunde auf Confirm Order, erstellt die Erweiterung eine PayPlug-Zahlung über den Bestellbetrag in Cent und leitet den Kunden zur PayPlug-Zahlungsseite weiter. Rechnungs- und Lieferadresse, E-Mail-Adresse und Sprache der Bestellung werden an PayPlug übergeben. Dort bezahlt der Kunde mit Karte.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn PayPlug die Zahlung bestätigt: Die Erweiterung liest die Zahlung über die PayPlug-API aus, sobald die Benachrichtigung eintrifft und wenn der Kunde zurückkehrt. 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 von OpenCart mit Your payment with PayPlug has been received. Ist die Bestellung in Bearbeitung, lautet der Text auf der Seite We are confirming your payment with PayPlug. The order will be updated automatically — please do not pay again. Befindet sich die Bestellung im Zahlungsfehler-Status, zeigt die Seite Your PayPlug payment was not completed. Please contact us about this order. Konnte PayPlug bei der Rückkehr des Kunden nicht abgefragt werden, zeigt eine Seite Payment confirmation denselben Hinweis „wir bestätigen“ sowie eine Schaltfläche Check again; die Benachrichtigung setzt den Bestellstatus, sobald sie eintrifft.

Bricht der Kunde auf der PayPlug-Seite ab, wird die Zahlungsseite bei PayPlug geschlossen, sodass sie nicht versehentlich später bezahlt werden kann. Der Kunde kehrt zur Kasse zurück und sieht eine Meldung: You cancelled the PayPlug payment. You can try again or choose another payment method., The PayPlug payment session has expired. Please try again or choose another payment method., The PayPlug payment failed. Please try again or choose another payment method. oder, falls die Zahlung offen geblieben ist, Your PayPlug payment was not completed. You can try again or choose another payment method. Der Warenkorb bleibt erhalten. In OpenCart 4 werden diese Meldungen oberhalb der Kassenseite angezeigt.

OpenCart 3 legt jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird, und OpenCart 4 aktualisiert die Bestellung der Kasse (ein neuer Versuch ist eine neue PayPlug-Zahlung für dieselbe Bestellung). Deshalb prüft die Erweiterung zuerst die früheren Versuche desselben Warenkorbs. Wurde einer davon inzwischen bezahlt, wird diese Zahlung ohne eine neue verwendet und der Kunde gelangt zur Erfolgsseite. Ist der Versuch dieser Bestellung für denselben Betrag noch offen, wird dieselbe Zahlungsseite erneut verwendet. Andernfalls wird die alte Seite bei PayPlug geschlossen und eine neue Zahlung erstellt. Eine verspätete Zahlung über eine geschlossene Seite wird trotzdem erfasst. Eine Änderung des Warenkorbs, auch eine neue Menge, gilt als neuer Warenkorb, der eine eigene Zahlung braucht.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel haben Sie sie storniert oder ihre autorisierte Zahlung ist fehlgeschlagen), kehrt der Kunde mit der Meldung Your previous order was cancelled or refunded. Please confirm the order again to pay with a new order. zur Kasse zurück. Der nächste Confirm Order bezahlt eine neue Bestellung. War diese Bestellung für einen früheren Warenkorb bereits bezahlt und hat sich der Warenkorb seitdem geändert, wird der Kunde zur Kasse zurückgebracht, und der nächste Confirm Order bezahlt eine neue Bestellung des aktuellen Warenkorbs. Eine geschlossene Bestellung wird nie als bezahlt angezeigt.

Kann PayPlug die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung, zum Beispiel PayPlug could not accept your billing details (postcode). Please check them and try again. oder The payment provider could not be reached. Please try again in a moment. Der technische Grund wird im Protokoll festgehalten.

Die Benachrichtigung funktioniert auch, während der Shop im Wartungsmodus ist, weil OpenCart Anfragen von Zahlungserweiterungen durchlässt (in OpenCart 4 fügt die Erweiterung dafür eine eigene Startaktion hinzu, die auch die Rückkehr des Kunden von PayPlug durchlässt).

Zahlungen werden sofort eingezogen. Die Erweiterung bietet keine Oney-Ratenzahlungen, keine gespeicherten Karten mit einem Klick, kein eingebettetes Zahlungsformular, keine Abonnements und keine verzögerte Erfassung.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (fehlende Bestellung): Der Kunde wurde zu PayPlug weitergeleitet und hat nicht bezahlt, oder PayPlug hat die Zahlung noch nicht bestätigt. Unter Sales > Orders werden solche Bestellungen nur angezeigt, wenn der Filter Order Status auf Missing Orders gesetzt ist. Schlägt die Zahlung fehl, wird der Versuch geschlossen und der Kunde kann erneut bezahlen.

Order Status After Payment (Standard Processing): Die Zahlung ist bestätigt. Eine Notiz zeigt die PayPlug-Zahlung und deren Modus.

PayPlug Payment On Hold Status (Standard Pending): Der bezahlte Betrag oder die Währung weicht von der Bestellung ab (Notiz amount/currency mismatch); oder eine Testzahlung wurde getätigt, während der Shop im Livebetrieb war, sodass kein Geld eingegangen ist; oder die Zahlung kam, nachdem die Bestellung einen anderen Status erhalten hatte, zum Beispiel weil sie storniert wurde; oder eine Zahlung ist autorisiert, aber nicht erfasst (erfassen Sie sie im PayPlug-Portal; die Bestellung wird als bezahlt markiert, sobald PayPlug sie als bezahlt meldet). Die Notiz erklärt, was zu prüfen ist.

Payment Error Status (Standard Failed): Eine autorisierte Zahlung einer Bestellung in Bearbeitung ist fehlgeschlagen oder wurde storniert. OpenCart benachrichtigt den Kunden über diese Änderung.

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

Wird eine weitere Bestellung eines bereits bezahlten Warenkorbs ebenfalls bezahlt, bleibt diese Bestellung ohne Status, und die bezahlte Bestellung wird nicht verändert. Eine Notiz an der bezahlten Bestellung fordert Sie auf, die doppelte Zahlung im PayPlug-Portal zu erstatten. Eine bezahlte oder erstattete Bestellung wird durch eine spätere Benachrichtigung nie wieder geöffnet.

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

Reiter VibeFox PayPlug Gateway

Öffnen Sie unter Sales > Orders eine mit PayPlug bezahlte Bestellung. Am unteren Rand der Bestellseite zeigt der Reiter VibeFox PayPlug Gateway neben History und Additional die PayPlug payment ID mit der Kennzeichnung Test mode bei Testzahlungen, den Zahlungs-Status, die Beträge Paid / refunded, das Erstattungsformular, den Erstattungsverlauf (mit dem Modus jeder Erstattung) und die PayPlug notes der Bestellung. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie im Reiter VibeFox PayPlug Gateway den Amount ein (der noch nicht erstattete Betrag ist bereits eingetragen), optional einen Reason (optional), und klicken Sie auf Refund via PayPlug. Bestätigen Sie die Abfrage Refund this amount through PayPlug? This cannot be undone. Vollständige und teilweise Erstattungen werden unterstützt. Sie benötigen das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups). Erstattungen sind bis zu dem Betrag möglich, den PayPlug tatsächlich eingezogen hat; nach einer Betragsabweichung können Sie also den Betrag erstatten, den der Kunde bezahlt hat, nicht den Bestellbetrag. Die Erstattung geht an die Zahlung, mit der die Bestellung tatsächlich bezahlt wurde, und verwendet den geheimen Schlüssel des Modus (Test oder Live), in dem sie erfolgt; dieser Schlüssel muss daher eingerichtet sein. Lehnt PayPlug die Erstattung ab, zeigt der Reiter den Fehler an und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird mit der PayPlug-Erstattungs-ID und dem Grund dem Erstattungsverlauf und den Notizen hinzugefügt. 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, ähnlich wie eine manuelle Statusänderung. Eine Teilerstattung ändert den Status nicht. Erstattungen sind verfügbar, sobald PayPlug die Zahlung als bezahlt gemeldet hat.

Produktrücksendungen unter Sales > Returns erstatten kein Geld über PayPlug.

Im PayPlug-Portal vorgenommene Erstattungen gelangen per Benachrichtigung in den Shop und werden einmal in den Notizen vermerkt. Sie erscheinen im Erstattungsverlauf, zählen aber nicht als Erstattungen der Erweiterung und ändern den Bestellstatus nicht. Bei Bedarf erfassen Sie sie manuell.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox PayPlug Gateway ist der erste Block auf Extensions > Extensions > Payments > VibeFox PayPlug Gateway > Edit, oberhalb der Einstellungen. Tragen Sie den Schlüssel unter 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 zum erneuten Prüfen des Status, Change key zur Eingabe eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: opencart-payment-payplug 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. Kann der Lizenzserver nicht erreicht werden, arbeitet die Erweiterung mit dem zuletzt bekannten Status weiter.

Ein Schlüssel gilt 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 PayPlug 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 vor dem Kauf eines Schlüssels einrichten und testen können. Unter OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Admin-Anmeldung nicht, daher ist die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint ein Hinweis auf dem Dashboard des Admin-Bereichs. Schließen Sie ihn mit ×, um ihn 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, Updates und Support benötigen aber eine Verlängerung. Der Status wird beim Öffnen des Dashboard des Admin-Bereichs oder der Seite Edit automatisch erneut geprüft: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Das Deinstallieren der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

PayPlug erscheint nicht in der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, der aktuelle Modus einen geheimen Schlüssel hat (Test Secret Key im Testmodus, Live Secret Key im Livebetrieb), die Kassenwährung EUR ist und der Bestellbetrag zwischen 0,99 und 20.000,00 EUR liegt. Prüfen Sie außerdem, ob die Rechnungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht. Entwickler können Währungen und Grenzen über die OpenCart-Ereignisse ppg_supported_currencies und ppg_amount_limits (Werte in Cent) sowie die Zahlungsanfrage über ppg_payment_data anpassen.

Die Zahlung ist erfolgt, aber die Bestellung bleibt ohne Status: Die Benachrichtigung hat Ihren Shop nicht erreicht, und der Kunde ist nicht zurückgekehrt. Prüfen Sie, ob Ihr Shop unter der in den Einstellungen angezeigten Notification URL aus dem Internet erreichbar ist, zum Beispiel ob keine Firewall oder Passwortschutz sie blockiert. Aktivieren Sie Logging und prüfen Sie im Feld Log abgelehnte Benachrichtigungen.

Die Benachrichtigung antwortet Verification failed.: Die Zahlung konnte nicht über die PayPlug-API gelesen werden, zum Beispiel weil PayPlug nicht geantwortet hat oder der geheime Schlüssel des Modus der Zahlung nicht eingerichtet ist. Die Bestellung wird nicht verändert, und PayPlug sendet die Benachrichtigung erneut.

Die Benachrichtigung antwortet Temporarily unavailable.: Der Warenkorb wurde im selben Moment von einer anderen Anfrage aktualisiert, zum Beispiel durch die Rückkehr des Kunden, oder der Bestellstatus konnte nicht gesetzt werden. PayPlug sendet die Benachrichtigung erneut. Das Protokoll zeigt den Grund.

Die Benachrichtigung antwortet Unknown payment. oder Payment does not belong to the order.: Die Zahlung wurde nicht von diesem Shop oder nicht für diese Bestellung erstellt, zum Beispiel eine Zahlung eines anderen Shops auf demselben PayPlug-Konto. Sie wird ignoriert.

Die Benachrichtigungs-URL zeigt im Browser Method not allowed.: Das ist normal. Die URL akzeptiert nur Anfragen von PayPlug.

Der Kunde sieht nach Confirm Order einen Fehler: Aktivieren Sie Logging und prüfen Sie das Feld Log. Ein falscher Schlüssel führt zu This payment method is temporarily unavailable. Please choose another payment method.; andere Meldungen nennen das Rechnungsfeld, das PayPlug abgelehnt hat.

Der Kunde kehrt zurück und sieht Payment verification failed.: Der Rücksprung-Link passt zu keinem Zahlungsversuch der Bestellung, zum Beispiel weil er in einem anderen Browser geöffnet wurde. Prüfen Sie die Zahlung im PayPlug-Portal; die Benachrichtigung setzt den Bestellstatus trotzdem.

Bestellung ist nach der Zahlung in Bearbeitung: Lesen Sie die Notizen im Reiter VibeFox PayPlug Gateway (siehe Bestellstatus) und bearbeiten Sie dann die Bestellung oder erstatten Sie die Zahlung.

Kein Erstattungsformular im Reiter: Der Reiter nennt den Grund: Die Zahlung ist noch nicht bezahlt, sie ist vollständig erstattet, Ihre Benutzergruppe darf die Erweiterung nicht ändern, oder der geheime Schlüssel des Modus der Zahlung ist nicht konfiguriert.

Erstattung schlägt mit Unexpected response from PayPlug. fehl: PayPlug hat ohne gültige Erstattung geantwortet. Es wurde nichts erfasst. Prüfen Sie die Erstattung im PayPlug-Portal, bevor Sie es erneut versuchen.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox PayPlug 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 im Bereich Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Ereignis der Erweiterung wird entfernt (in OpenCart 4 auch dessen Ereignisse und die Startaktion, die Benachrichtigung und Rückkehr des Kunden im Wartungsmodus durchlässt). Ist Delete Data on Uninstall aktiv, werden die übrigen Einstellungen (Titel, Beschreibung, Testmodus, geheime Schlüssel, Logging) und das Protokoll gelöscht. Ist die Option aus, bleiben sie für eine spätere Neuinstallation erhalten. Die PayPlug-Zahlungs- und Erstattungsdatensätze bleiben immer erhalten, sodass früher bezahlte Bestellungen nach einer Neuinstallation erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Unter OpenCart 4 entfernen Sie nach der Deinstallation, um auch die Dateien der Erweiterung zu löschen, unter Extensions > Installer mit der Schaltfläche Uninstall (die orange −) neben VibeFox PayPlug Gateway in der Liste der installierten Erweiterungen und danach mit Delete (die rote Papierkorb-Schaltfläche) das hochgeladene Paket.

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