VibeFox DPO 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 mit der Erweiterung SimpleXML.

DPO-Pay-Konto: Sie benötigen den Company Token und die Service Type ID Ihres DPO-Händlerkontos. DPO stellt sie bei der Eröffnung Ihres Kontos aus; beziehen Sie sie von Ihrem DPO-Kundenbetreuer oder über dpogroup.com. DPO kann Ihnen auch ein Testkonto mit eigenem Token und eigenem Service Type bereitstellen. Es gibt keinen separaten Testserver: DPO verwendet dieselbe API-Adresse für Test- und Live-Konten, und das Konto wird über das Token bestimmt.

Währung: Die Bestellwährung muss von Ihrem DPO-Konto unterstützt werden. DPO akzeptiert höchstens 2 Nachkommastellen, daher können Bestellsummen mit 3 Nachkommastellen (zum Beispiel KWD 12.345) nicht bezahlt werden.

Server-Cron: ein Cron-Job, der die Re-Check-URL der Erweiterung alle 15 Minuten aufruft (siehe Konfiguration).

VibeFox-Lizenzschlüssel: erhältlich 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_dpo_pay-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_dpo_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_dpo_pay-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 DPO 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 Lizenzschlüssel).

4. Geben Sie den Test- und/oder Live-Company-Token und den Service Type ein (siehe Konfiguration).

5. Senden Sie die im Abschnitt Payment notifications angezeigte Push-Benachrichtigungs-URL an den DPO-Support und bitten Sie darum, sie für Ihr Konto einzurichten. Tragen Sie die Cron-URL in die Cron-Jobs Ihres Servers ein.

6. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Platzieren Sie eine Testbestellung im Testmodus und schalten Sie danach Test mode 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_dpo_pay.ocmod.zip aus. 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 DPO Pay Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und danach auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel und die DPO-Zugangsdaten ein, richten Sie die Push-Benachrichtigungs-URL und den Cron ein und testen Sie die Zahlung wie in den Schritten 3 bis 6 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Push-Benachrichtigungs-URL und die Cron-URL sind anders (siehe Zahlungsbenachrichtigungen).

Eine neue Installation startet mit deaktivierter Zahlungsmethode und aktiviertem Testmodus. Bei der Installation erstellt die Erweiterung ihre Transaktionstabelle und das geheime Token der Cron-URL.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox DPO Pay Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Ist die Zahlungsmethode aktiviert, aber der Company Token oder der Service Type des gewählten Modus leer, warnt Sie die Seite, dass die Zahlungsmethode an der Kasse ausgeblendet wird; beim Speichern erscheint dieselbe Warnung. Solange der Testmodus aktiv ist, zeigt die Seite Der Testmodus ist aktiviert: Zahlungen werden mit den Zugangsdaten des Testkontos erstellt. 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 (höchstens 128 Zeichen), Sort Order muss eine ganze Zahl sein und Total eine Zahl von 0 oder mehr; andernfalls wird nichts gespeichert.

DPO Pay

Enable/Disable: Enable DPO Pay schaltet die Zahlungsmethode ein oder aus. Standard: aus.

Title: der Name der Zahlungsmethode, den Kunden an der Kasse sehen. Er wird auch als Name der Zahlungsmethode in der Bestellung gespeichert. Standard: DPO Pay. Pflichtfeld.

Description: der Text, den Kunden im Schritt Confirm Order oberhalb der Bestätigungsschaltfläche sehen. Standard: Bezahlen Sie sicher per Karte oder Mobile Money auf der Zahlungsseite von DPO Pay.

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

Geo Zone: bietet DPO Pay nur für Zahlungsadressen in der ausgewählten Geo Zone an. Standard: All zones. Geo Zones werden unter System > Localisation > Geo Zones eingerichtet.

Total: der Warenkorbbetrag in der Standardwährung des Shops, den eine Bestellung erreichen muss, bevor DPO Pay angeboten wird. Lassen Sie das Feld leer, um DPO Pay für jeden Betrag anzubieten.

API-Zugangsdaten

DPO stellt einen Company Token und eine Service Type ID für Ihr Händlerkonto sowie getrennte Daten für ein Testkonto aus. Beziehen Sie diese von Ihrem DPO-Kundenbetreuer oder über dpogroup.com (der Abschnitt verlinkt dorthin).

Test mode: Ist die Option aktiv, werden neue Zahlungen mit dem Test-Company-Token und dem Test-Service-Type erstellt. Standard: aktiv. Schalten Sie sie aus, um echte Zahlungen mit den Live-Zugangsdaten anzunehmen. Solange sie aktiv ist, sehen Kunden im Schritt Confirm Order Testmodus: Zahlungen werden mit dem Testkonto erstellt. Statusabfragen und Stornierungen bestehender Zahlungen verwenden immer das Konto, mit dem die Zahlung erstellt wurde.

Test Company Token: der Company Token Ihres DPO-Testkontos.

Test Service Type: die numerische Service Type ID Ihres DPO-Testkontos.

Live Company Token: der Company Token Ihres DPO-Händlerkontos für den Live-Betrieb.

Live Service Type: die numerische Service Type ID Ihres DPO-Händlerkontos für den Live-Betrieb.

Gespeicherte Company Tokens werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Gespeichert: leer lassen, um es zu behalten. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um ein gespeichertes Token zu entfernen, setzen Sie unter dem Feld den Haken bei Clear the saved Company Token on save und klicken Sie auf Save. Ein Service Type muss eine Zahl sein. Jeder andere Wert wird nicht gespeichert: Die Seite zeigt eine Warnung und behält den vorherigen Wert bei; die übrigen Einstellungen werden gespeichert.

Zahlungsbenachrichtigungen

Push notification URL: Die Push-Benachrichtigung informiert Ihren Shop sofort, dass eine Zahlung erfolgt ist, auch wenn der Kunde nach der Zahlung den Browser schließt. Die URL wird nicht im Dashboard eingestellt: Bitten Sie den DPO-Support, diese URL für Ihr Konto festzulegen. Sie hat bei OpenCart 3 das Format https://your-store/index.php?route=extension/payment/wcp_dpo_pay/notify, bei OpenCart 4 https://your-store/index.php?route=extension/wcp_dpo_pay/payment/wcp_dpo_pay.notify und wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet. Kopieren Sie sie genau so, wie die Seite sie anzeigt. Sie muss aus dem Internet erreichbar sein, ohne Firewall oder Basisauthentifizierung davor.

DPO-Push-Benachrichtigungen enthalten keine Signatur, daher wird ihr Inhalt nie als vertrauenswürdig behandelt. Die Erweiterung nutzt sie nur, um die Zahlung über ihr Transaktionstoken zu finden, und prüft das Ergebnis anschließend bei DPO selbst. Ein Token, das Ihr Shop nicht erstellt hat, wird ohne Anfrage an DPO abgelehnt.

Geplante Statusprüfung (Cron): rufen Sie diese URL alle 15 Minuten von einem Server-Cron-Job auf, zum Beispiel mit curl. Unbestätigte Zahlungen werden 15 Minuten nach der Weiterleitung und erneut nach Ablauf der Zahlungsfrist bei DPO geprüft. Die URL enthält ein geheimes Token; halten Sie sie daher privat. Bei OpenCart 4 sieht sie etwa so aus: https://your-store/index.php?route=extension/wcp_dpo_pay/payment/wcp_dpo_pay.cron&token= und das Token. Ohne die Push-URL und den Cron erhält eine Bestellung ihren Status nur, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

Bestellungen

OpenCart erstellt die Bestellung im Schritt Confirm Order ohne Status (eine fehlende Bestellung). Die Bestellung erhält erst dann einen Status, wenn DPO die Zahlung bestätigt hat. Jedes Feld unten listet Ihre OpenCart-Bestellstatus auf.

Successful payment status: der Bestellstatus nach einer geprüften erfolgreichen Zahlung. Standard: In Bearbeitung. Wählen Sie Abgeschlossen, wenn jede bezahlte Bestellung abgeschlossen werden soll, oder Ihren eigenen Prüfstatus für die manuelle Freigabe jeder Bestellung.

DPO payment on hold status: der Status für eine Zahlung, die Ihre Prüfung benötigt: Abweichung von Betrag oder Währung, eine nur autorisierte Zahlung, eine über- oder unterbezahlte Transaktion oder eine Zahlung, die nach dem Abbruch durch den Kunden einging. Eine Notiz im Bestellverlauf erklärt den Grund. Standard: Ausstehend, weil 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: Wenn Sie eine unbezahlte DPO-Pay-Bestellung auf diesen Status setzen, wird ihre offene DPO-Zahlung auch bei DPO storniert. Standard: Storniert.

Erweitert

Logging: schreibt API-Aufrufe und Benachrichtigungen in dpo_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden, und bei 5 MB wird sie nach dpo_p_debug.old.log.php verschoben. Fehler werden immer protokolliert. Token werden maskiert, Kundendaten werden nicht protokolliert. Standard: aus.

Log: zeigt die Größe und die neuesten Einträge des Logs. Klicken Sie auf Clear log, um es zu leeren.

Delete data: Ist die Option aktiv, entfernt das Deinstallieren der Erweiterung die Gateway-Einstellungen und das Log. Die DPO-Daten, die für Bestellungen gespeichert sind, bleiben immer erhalten. Ohne diese Option werden beim Deinstallieren nie Daten gelöscht. Standard: aus.

Import / Export

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

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

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsmethode (standardmäßig DPO Pay). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis Sie werden zur sicheren Zahlungsseite von DPO Pay weitergeleitet. OpenCart erstellt die Bestellung in diesem Schritt, noch ohne Status. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine DPO-Transaktion für den Bestellbetrag in der Bestellwährung, mit der Bestellnummer und dem Namen Ihres Shops als Beschreibung, und leitet den Kunden zur Zahlungsseite von DPO weiter. Name, E-Mail-Adresse, Telefonnummer und Zahlungsadresse des Kunden werden übergeben, um die Seite vorauszufüllen. Dort bezahlt der Kunde mit einer beliebigen Methode, die in Ihrem DPO-Konto aktiviert ist. Der Zahlungslink ist 5 Stunden gültig. Bei OpenCart 4 wählt der Kunde die Zahlungsmethode mit der Schaltfläche Choose des Zahlungsmethodenblocks im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order. Fordert der Shop keine Zahlungsadresse an (Standard bei OpenCart 4), wird stattdessen die Lieferadresse übergeben.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn DPO sie bestätigt: Die Erweiterung fragt das Ergebnis der Transaktion bei DPO ab, wenn der Kunde zurückkehrt, wenn eine Push-Benachrichtigung eintrifft und bei den geplanten Prüfungen. 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. Bei OpenCart 4 sendet der Browser die Shop-Sitzung nicht mit, wenn DPO den Kunden zurückschickt. Daher zeigt die Erweiterung zuerst eine kurze Seite, die dieselbe Rückkehradresse erneut von Ihrem Shop aus öffnet: Der Kunde behält Warenkorb und Anmeldung.

Wird die Zahlung nicht bestätigt, kehrt der Kunde mit einer der folgenden Meldungen zur Kasse zurück (bei OpenCart 4 oberhalb der Kassenseite). Der Warenkorb bleibt erhalten.

Klickt der Kunde auf der DPO-Seite auf die Schaltfläche, um zum Shop zurückzukehren, wird zuerst die Transaktion geprüft. Wurde sie bezahlt, sieht der Kunde die Erfolgsseite. Andernfalls wird sie bei DPO storniert, und der Kunde kehrt mit dem Warenkorb zur Kasse zurück.

OpenCart 3 erstellt jedes Mal eine neue Bestellung, wenn der Schritt Confirm Order angezeigt wird; OpenCart 4 behält eine Bestellung für die Kasse und aktualisiert sie, und ein neuer Versuch ist eine neue DPO-Transaktion derselben Bestellung. Vor einer neuen Zahlung werden die offenen DPO-Transaktionen der Bestellung und der früheren Bestellungen desselben Warenkorbs geprüft. Wurde eine bezahlt, wird diese Zahlung bestätigt, und der Kunde gelangt zur Erfolgsseite, ohne ein zweites Mal belastet zu werden. Wird eine noch verarbeitet, sieht der Kunde Ihre vorherige Zahlung für diese Bestellung wird von DPO noch verarbeitet. Bitte warten Sie einige Minuten, bevor Sie es erneut versuchen. Andernfalls werden die alten Transaktionen bei DPO storniert und eine neue wird erstellt.

Bei OpenCart 4 bleibt die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen geschlossen (zum Beispiel storniert oder erstattet), schickt Confirm Order oder die Rückkehr von DPO den Kunden zurück zur Kasse: mit The payment was declined or cancelled. Please try again or choose another payment method., wenn die Bestellung keine Zahlung hatte, oder mit Your previous order was closed by the store. Please confirm the order again: the cart will be paid with a new order., wenn sie eine hatte. Ist die Bestellung bereits bezahlt und hat sich der Warenkorb seitdem geändert (andere Produkte oder Mengen), lautet die Meldung Your previous order is already paid. Please confirm the order again: the cart will be paid with a new order. In allen diesen Fällen bezahlt der nächste Klick auf Confirm Order eine neue Bestellung des Warenkorbs.

Kann DPO die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung oberhalb der Schaltfläche, die anhand des DPO-Fehlercodes ausgewählt wird, zum Beispiel DPO Pay unterstützt die Währung dieser Bestellung nicht. Bitte wählen Sie eine andere Zahlungsmethode. oder Der Betrag überschreitet das von DPO Pay zugelassene Limit. Bitte wählen Sie eine andere Zahlungsmethode oder kontaktieren Sie uns. Andere Fehler zeigen DPO Pay ist vorübergehend nicht verfügbar. Bitte versuchen Sie es erneut oder wählen Sie eine andere Zahlungsmethode. Der technische Grund wird im Log festgehalten.

Die Push-Benachrichtigung und die Cron-URL funktionieren auch, während der Shop im Wartungsmodus ist: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und bei OpenCart 4 fügt die Erweiterung eine Startaktion hinzu, die die Push-Benachrichtigung, die Cron-URL und die Rückkehr des Kunden durchlässt. Bereits gestartete Zahlungen werden bestätigt, auch wenn Sie die Zahlungsmethode ausschalten.

Die Erweiterung verarbeitet nur einmalige Zahlungen auf der Seite von DPO. Sie bietet keine Erstattungen aus dem Shop, keine gespeicherten Karten, keine Abonnements oder wiederkehrenden Zahlungen, keine Kartenfelder auf Ihrer Website und keine Erfassung nur autorisierter Zahlungen.

Bestellungen

Bestellstatus

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

Successful payment status (Standard In Bearbeitung): Die Zahlung wurde geprüft. Eine Notiz im Bestellverlauf zeigt den Betrag, die Währung, den Autorisierungscode und den Anfang des DPO-Transaktionstokens.

DPO payment on hold status (Standard Ausstehend): DPO hat eine Zahlung bestätigt, aber Betrag oder Währung weichen von der Bestellung ab, die Zahlung ist nur autorisiert und nicht erfasst, die Transaktion ist über- oder unterbezahlt, oder der Kunde hatte die Zahlung abgebrochen oder die Bestellung war bereits storniert. Die Notiz erklärt den Grund. Prüfen Sie die Transaktion im DPO-Portal. Erfassen oder stornieren Sie eine nur autorisierte Zahlung im DPO-Portal und aktualisieren Sie dann den Bestellstatus.

Cancelled order status (Standard Storniert): Wenn Sie eine unbezahlte Bestellung der Erweiterung auf diesen Status setzen (zum Beispiel eine, die für eine nur autorisierte Zahlung angehalten wird), wird ihre offene DPO-Transaktion auch bei DPO storniert.

Eine spätere abgelehnte Antwort verändert nie eine Bestellung, und Ergebnisse älterer Transaktionen lassen den aktuellen Versuch nie fehlschlagen. Bestätigt DPO eine zweite erfolgreiche Zahlung für eine bereits bezahlte Bestellung, bleibt die Bestellung unverändert und erhält eine Notiz über eine mögliche Doppelzahlung, damit Sie sie im DPO-Portal erstatten können. Dieselbe Art von Notiz wird der bezahlten Bestellung hinzugefügt, wenn derselbe Warenkorb (gleiche Kundensitzung und gleicher Warenkorbinhalt) mit einer anderen Bestellung erneut bezahlt wurde, zum Beispiel in einem zweiten Browser-Tab; diese andere Bestellung erhält keinen Status. Eine Bestellung, die Sie in einen anderen Status versetzt haben (zum Beispiel erstattet), wird nie wieder geöffnet; eine späte Zahlung fügt nur eine Notiz hinzu.

Notizen sind Einträge im History der Bestellung, die der Kunde nicht sieht. Die Erweiterung hat keine Registerkarte auf der Bestellseite.

Erstattungen

Erstattungen aus dem Shop sind in dieser Version nicht verfügbar. Erstatten Sie die Zahlung im DPO-Händlerportal und ändern Sie danach den Bestellstatus in OpenCart.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox DPO Pay Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox DPO 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 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-dpo 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 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 DPO Pay Kunden an der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde Diese Zahlungsmethode ist nicht verfügbar. Bitte wählen Sie eine andere. Ein Admin-Benutzer, der im Admin-Bereich im selben Browser angemeldet ist, sieht die Zahlungsmethode im Shop weiterhin, markiert als (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 Anmeldung im Admin-Bereich nicht, daher ist die Zahlungsmethode 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.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, Aktualisierungen und Support benötigen aber 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 pro Woche. Ein Cron-Job ist nicht nötig. Das Deinstallieren der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

DPO Pay erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und der Company Token sowie der Service Type des gewählten Modus gesetzt sind: die Testfelder im Testmodus, sonst die Live-Felder. Die Einstellungsseite zeigt eine Warnung, wenn sie fehlen. Prüfen Sie außerdem, ob die Zahlungsadresse in der ausgewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht.

Die Zahlung ist durchgegangen, aber die Bestellung bleibt ohne Status: Die Push-Benachrichtigungs-URL ist für Ihr DPO-Konto vermutlich nicht eingerichtet, und der Kunde ist nicht in den Shop zurückgekehrt. Bitten Sie den DPO-Support, die in den Einstellungen angezeigte URL festzulegen, und prüfen Sie, ob der Cron die Re-Check-URL alle 15 Minuten aufruft. Aktivieren Sie Logging und sehen Sie im Feld Log auf der Seite der Erweiterung nach.

Push-Benachrichtigung antwortet Unknown transaction: Das Transaktionstoken gehört nicht zu einer DPO-Pay-Zahlung dieses Shops, zum Beispiel weil die Benachrichtigung von einem anderen Shop auf demselben DPO-Konto stammt.

Push-Benachrichtigung antwortet Verification failed: DPO konnte zur Prüfung der Zahlung nicht erreicht werden, die Bestellung wurde gleichzeitig von einer anderen Anfrage verarbeitet, oder der Bestellstatus konnte nicht gesetzt werden. DPO wiederholt die Benachrichtigung, und die geplante Prüfung bestätigt die Bestellung ebenfalls. Der Grund steht im Log.

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

Die Cron-URL antwortet Forbidden: Das Token in der URL ist falsch. Kopieren Sie die URL erneut von der Einstellungsseite. Ein funktionierender Aufruf antwortet OK checked= und der Anzahl der geprüften Zahlungen.

Der Service Type wird nicht gespeichert: Er muss die numerische Service Type ID von DPO sein.

Der Kunde sieht This payment method is not available. Please reload the checkout page.: Die Kassensitzung passt nicht mehr zur Bestellung, oder die Zahlungsmethode wurde zwischenzeitlich ausgeschaltet. Der Kunde lädt die Kasse neu.

Der Kunde sieht DPO Pay is temporarily unavailable: DPO hat die Erstellung der Transaktion abgelehnt, zum Beispiel wegen eines falschen Company Tokens oder Service Types oder eines Tokens des anderen Modus. Der DPO-Ergebniscode steht im Log.

Der Kunde sieht, dass DPO höchstens 2 Nachkommastellen akzeptiert: Die Bestellsumme hat 3 Nachkommastellen. DPO kann solche Beträge nicht abbuchen.

Der Kunde sieht This order has already been paid with DPO Pay: DPO hat eine zweite Zahlung für dieselbe Bestellung abgelehnt. Prüfen Sie die Zahlung im DPO-Portal und die Bestellung in OpenCart.

Die Bestellung ist nach der Zahlung im Prüfstatus: Lesen Sie die Notiz im History der Bestellung (siehe Bestellstatus) und prüfen Sie dann die Transaktion im DPO-Portal.

Für Entwickler: Die Erweiterung löst die OpenCart-Ereignisse wcp_dpo_pay_customer_data (die an DPO gesendeten Kundendaten) und wcp_dpo_pay_payment_time_limit (die Zahlungsfrist in Stunden) aus.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox DPO 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 des Abschnitts Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Ereignis der Erweiterung wird entfernt (bei OpenCart 4 zusätzlich dessen Ereignisse und die Startaktion, die DPO und den Cron im Wartungsmodus durchlässt). Ist Delete data aktiv, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Testmodus, Company Tokens, Service Types, Protokollierung) und das Log entfernt, und eine Neuinstallation erstellt eine neue Cron-URL. Ist die Option aus, bleiben sie für eine spätere Neuinstallation erhalten. Die DPO-Daten, die für Bestellungen gespeichert sind, bleiben immer erhalten, sodass späte Benachrichtigungen und Prüfungen alter Zahlungen auch nach einer Neuinstallation weiterhin funktionieren. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

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