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

Datatrans-Konto: Sie benötigen die Händler-ID, das API-Passwort für die Server-zu-Server-Kommunikation und, empfohlen, den HMAC-SHA256-Signierschlüssel für Webhooks. Die Sandbox-Zugangsdaten stammen aus dem Datatrans-Sandbox-Web-Admin (admin.sandbox.datatrans.com), die Produktionszugangsdaten aus dem Produktions-Web-Admin (admin.datatrans.com). Sandbox und Produktion sind getrennte Datatrans-Konten mit unterschiedlichen Händler-IDs und Schlüsseln.

Erreichbarer Shop: Datatrans sendet Webhooks von seinen eigenen Servern, daher muss Ihr Shop aus dem Internet erreichbar sein.

VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel funktioniert für eine 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_datatrans_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_datatrans_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_datatrans_gateway-oc3-(version).ocmod.zip. Die Erweiterung enthält keine OCMOD-Modifikationen, 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 Datatrans Gateway und klicken Sie auf Install (die grüne +-Schaltfläche). Ihr Admin-Benutzer benötigt das Recht, die Liste der Zahlungserweiterungen zu bearbeiten.

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 die Sandbox-Zugangsdaten aus dem Datatrans-Sandbox-Web-Admin ein (siehe Konfiguration).

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Führen Sie eine Testzahlung im Sandbox-Modus durch. Wenn alles funktioniert, geben Sie die Produktionszugangsdaten ein und schalten Sie Sandbox mode aus.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_datatrans_gateway.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 Datatrans 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 Datatrans-Zugangsdaten ein und testen Sie die Zahlung wie in den Schritten 3 bis 5 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Webhook-URL ist anders (siehe Konfiguration).

Bei einer neuen Installation ist die Zahlungsart zunächst deaktiviert und der Sandbox-Modus eingeschaltet. Die Webhook-URL wird mit jeder Transaktion an Datatrans gesendet, daher müssen Sie sie nicht einrichten.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Datatrans Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Ist die Zahlungsart aktiviert, die aktuelle Umgebung aber ohne Händler-ID oder API-Passwort, zeigt die Seite Datatrans is hidden at checkout until these settings are filled in: mit den fehlenden Feldern. Solange der Sandbox-Modus eingeschaltet ist, zeigt die Seite Sandbox mode is on: payments go to the Datatrans sandbox, no real money is charged. Ohne das Recht, die Erweiterung zu bearbeiten, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern darf Title nicht leer sein und nicht länger als 128 Zeichen, Sort Order muss eine ganze Zahl sein, Total eine Zahl von 0 oder mehr, und die Geozone sowie die Bestellstatus müssen existieren. Andernfalls wird nichts gespeichert, und die Seite zeigt den Fehler. Ein Signierschlüssel, der keine hexadezimale Zeichenfolge ist, wird nicht gespeichert: Der bisherige Wert bleibt erhalten, die übrigen Einstellungen werden gespeichert, und die Seite zeigt eine Warnung mit dem Namen des Feldes.

Datatrans

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

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

Description: der Text, den der Kunde im Schritt Confirm Order über der Bestätigungsschaltfläche sieht. Standard: Pay securely via Datatrans.

Sandbox mode: verwendet die Datatrans-Sandbox: Testzahlungen, kein echtes Geld. Der Schalter wechselt sowohl die Datatrans-Server als auch die Zugangsdaten für neue Zahlungen. Standard: ein. Schalten Sie ihn aus, um echte Zahlungen anzunehmen. Solange er eingeschaltet ist, sehen Kunden im Schritt Confirm Order den Hinweis Sandbox mode: no real payment is taken. Erstattungen und Erfassungen verwenden immer die Umgebung, in der die Zahlung erfolgte, unabhängig von diesem Schalter.

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

Geo Zone: Datatrans nur für Rechnungsadressen in der gewählten Geozone anbieten. 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, bevor Datatrans angeboten wird. Lassen Sie das Feld leer, um Datatrans bei jedem Betrag anzubieten.

Sandbox-Zugangsdaten

Kopieren Sie sie aus dem Datatrans-Sandbox-Web-Admin (admin.sandbox.datatrans.com, die Seite verlinkt dorthin). Der Signierschlüssel befindet sich dort in den Sicherheitseinstellungen.

Sandbox merchant ID: die Händler-ID Ihres Sandbox-Kontos.

Sandbox API password: das API-Passwort für die Server-zu-Server-Kommunikation des Sandbox-Kontos.

Sandbox HMAC sign key: der hexadezimale Schlüssel, mit dem der Header Datatrans-Signature von Webhooks geprüft wird. Ohne ihn wird jeder Webhook über die Status-API von Datatrans erneut geprüft.

Produktionszugangsdaten

Kopieren Sie sie aus dem Datatrans-Produktions-Web-Admin (admin.datatrans.com).

Production merchant ID: die Händler-ID Ihres Produktionskontos.

Production API password: das API-Passwort für die Server-zu-Server-Kommunikation des Produktionskontos.

Production HMAC sign key: der hexadezimale Schlüssel, mit dem der Header Datatrans-Signature von Produktions-Webhooks geprüft wird. Ohne ihn wird jeder Webhook über die Status-API von Datatrans erneut geprüft.

Gespeicherte Passwörter und Signierschlüssel werden nicht 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 Wert zu entfernen, setzen Sie unter dem Feld den Haken bei Clear the saved value on save und klicken Sie auf Save.

Webhook-URL

Der Abschnitt zeigt die Webhook-URL Ihres Shops. Bei OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_datatrans_gateway/webhook, bei OpenCart 4 so: https://your-store/index.php?route=extension/wcp_datatrans_gateway/payment/wcp_datatrans_gateway.webhook. Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet. Die Erweiterung sendet diese URL mit jeder Transaktion an Datatrans, daher müssen Sie sie nirgends eingeben. Sie können sie auch in den Webhook-Einstellungen des Datatrans-Web-Admins eintragen, um Aktualisierungen zu Erfassungen und Stornierungen zu erhalten, die dort vorgenommen werden. Kopieren Sie sie genau so, wie die Einstellungen sie anzeigen. Im Datatrans-Web-Admin vorgenommene Erstattungen werden nicht in der Bestellung übernommen.

Der Webhook meldet den Status der Transaktion. Die Erweiterung reagiert auf diese Status:

Mit einem HMAC-Signierschlüssel wird jeder Webhook anhand seines Headers Datatrans-Signature mit dem Signierschlüssel der Umgebung geprüft, in der die Zahlung erfolgte. Webhooks ohne gültige Signatur werden abgelehnt. Ohne Signierschlüssel vertraut die Erweiterung dem Inhalt des Webhooks nicht und prüft jeden Webhook über die Status-API von Datatrans. Ohne Webhook erhält eine Bestellung ihren Status nur, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

Zahlungsabwicklung

Auto settle: erfasst (begleicht) Zahlungen sofort. Ist die Option deaktiviert, werden Zahlungen nur autorisiert: Die Bestellung wird zurückgestellt, und Sie erfassen sie später mit Capture Datatrans payment im Reiter der Bestellung oder geben sie mit Cancel Datatrans authorization frei. Standard: ein.

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält erst dann einen Status, wenn Datatrans die Zahlung bestätigt hat. Eine fehlgeschlagene oder abgebrochene Zahlung lässt die Bestellung ohne Status, und der Warenkorb bleibt erhalten. Jedes der folgenden Felder listet Ihre Bestellstatus in OpenCart auf.

Order status after payment: der Status der Bestellung, sobald die Zahlung beglichen ist und Betrag und Währung übereinstimmen. Standard: Processing.

Datatrans payment on hold: nur autorisierte Zahlungen (Auto settle aus), Abweichungen bei Betrag oder Währung und Zahlungen, die eintreffen, nachdem die Bestellung storniert wurde. 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.

Authorization canceled: wird gesetzt, wenn die Autorisierung mit Cancel Datatrans authorization oder im Datatrans-Web-Admin freigegeben wird. Standard: Canceled.

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

Erweitert

Logging: schreibt Zahlungsereignisse und API-Aufrufe in datatrans_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 datatrans_p_debug.old.log.php verschoben. Fehler werden immer protokolliert, auch wenn dieser Schalter aus ist. Keine Schlüssel, Kartendaten oder Kundendaten werden geschrieben. Standard: aus.

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

Delete data on uninstall: Wenn eingeschaltet, werden beim Deinstallieren der Erweiterung die Moduleinstellungen und das Protokoll entfernt. Die Datatrans-Zahlungsdatensätze der Bestellungen (Transaktionen, Erstattungen) bleiben erhalten. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Passwörter und Signierschlüssel werden nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Gespeicherte Passwörter und Signierschlüssel bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Datatrans). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will be redirected to the Datatrans payment page to complete the payment securely. OpenCart legt die Bestellung in diesem Schritt an, weiterhin ohne Status. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine Datatrans-Transaktion für den Bestellbetrag in der Bestellwährung, mit der OpenCart-Bestellnummer als Referenz, und leitet den Kunden zur Datatrans-Zahlungsseite weiter. Die Seite öffnet sich auf Deutsch, Englisch, Französisch oder Italienisch, wenn die Shopsprache eine davon ist. Dort bezahlt der Kunde mit einer beliebigen Methode, die in Ihrem Datatrans-Konto aktiviert ist. Bei OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose des Zahlungsartblocks im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, nachdem Datatrans die Zahlung bestätigt hat: entweder über den Webhook oder über eine serverseitige Anfrage an die Status-API von Datatrans, wenn der Kunde zurückkehrt. Die Rücksprungadresse enthält ein zufälliges Token des Zahlungsversuchs, und der Adresse selbst wird nie vertraut. Anschließend 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 mit Your payment with Datatrans has been received. Bei einer nur autorisierten Zahlung zeigt die Seite Your payment with Datatrans has been authorized. The amount will be charged when your order is processed. Hat Datatrans die Zahlung noch nicht bestätigt, zeigt eine Seite Payment confirmation den Hinweis Your payment is being confirmed by Datatrans. You will receive an e-mail as soon as it is confirmed. Please do not pay again. mit den Schaltflächen Check again und Back to checkout; der Webhook setzt den Bestellstatus, sobald er eintrifft. Bei OpenCart 4 sendet der Browser die Shop-Sitzung nicht mit, wenn Datatrans 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.

Bricht der Kunde auf der Datatrans-Seite ab, kehrt er zur Kasse zurück mit The payment was canceled. You can try again or choose another payment method. Ist die Zahlung fehlgeschlagen, lautet die Meldung The payment was not completed. Please try again or choose another payment method. Bei OpenCart 4 werden diese Meldungen oberhalb der Kassenseite angezeigt. Der Warenkorb bleibt erhalten. OpenCart 3 legt jedes Mal eine neue Bestellung an, 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 Datatrans-Transaktion derselben Bestellung. Bevor eine neue Zahlung startet, werden die offenen Datatrans-Transaktionen früherer Bestellungen desselben Warenkorbs geprüft: Eine bezahlte oder autorisierte wird bestätigt, statt eine neue Zahlung zu starten, eine offene wird bei Datatrans storniert. Ein Warenkorb wird nur einmal bezahlt: Ist eine andere Bestellung desselben Warenkorbs bereits bezahlt oder autorisiert, wird keine neue Zahlung gestartet, und der Kunde gelangt zur Erfolgsseite. Trifft noch eine Zahlung für eine andere Bestellung eines bereits bezahlten Warenkorbs ein, bleibt diese Bestellung ohne Status, und die bezahlte Bestellung erhält eine Notiz, dass Sie das Duplikat in Datatrans prüfen und erstatten sollten.

Bei OpenCart 4 bleibt die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel storniert, auch nachdem Sie eine Autorisierung freigegeben haben, oder erstattet), schickt Confirm Order oder die Rückkehr von Datatrans den Kunden mit Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. zurück zur Kasse, und der nächste Klick auf Confirm Order bezahlt eine neue Bestellung des Warenkorbs. Ist die Bestellung bereits bezahlt und hat sich der Warenkorb seitdem geändert (andere Produkte oder Mengen), wird der Kunde zur Kasse zurückgeschickt; der geänderte Warenkorb erhält eine neue Bestellung mit eigener Zahlung, derselbe Warenkorb geht ohne neue Zahlung zur Erfolgsseite.

Kann Datatrans die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit The payment could not be started. Please try again or choose another payment method. Der technische Grund wird in das Protokoll geschrieben.

Der Webhook funktioniert 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 den Webhook und die Rückkehr des Kunden durchlässt.

Die Erweiterung unterstützt einmalige Zahlungen auf der Zahlungsseite von Datatrans. Sie unterstützt keine gespeicherten Karten oder Aliase, keine Abonnements, kein Lightbox und keine Secure Fields auf Ihrer Website, keine Auswahl der Zahlungsarten in den Einstellungen und keine Teilerfassung einer Autorisierung.

Bestellungen und Erstattungen

Bestellstatus

No status (missing order): Der Kunde wurde zu Datatrans weitergeleitet und hat nicht bezahlt, die Zahlung ist fehlgeschlagen oder wurde abgebrochen, oder Datatrans hat sie noch nicht bestätigt. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Order status after payment (default Processing): Die Zahlung wurde beglichen. Eine Notiz zeigt den Betrag, die Zahlungsart, die Datatrans-Transaktions-ID, die Umgebung und wie sie bestätigt wurde (Webhook oder Rücksprung).

Datatrans payment on hold after an authorization (default Pending): Auto settle ist aus, und die Zahlung ist nur autorisiert. Erfassen oder stornieren Sie sie im Reiter der Bestellung.

Datatrans payment on hold after payment: Datatrans hat einen anderen Betrag oder eine andere Währung als den Bestellbetrag gemeldet, oder die Zahlung ist eingetroffen, nachdem die Bestellung storniert worden war. Die Notiz erklärt es. Prüfen Sie die Transaktion im Datatrans-Web-Admin und erfüllen Sie dann die Bestellung oder erstatten Sie die Zahlung.

Authorization canceled (default Canceled): Die Autorisierung wurde freigegeben, im Reiter der Bestellung oder im Datatrans-Web-Admin.

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

Trifft eine zweite Zahlung für eine Bestellung ein, die bereits bezahlt oder autorisiert ist, bleibt die Bestellung unverändert. Eine Notiz bittet Sie, das Duplikat in Datatrans zu prüfen und zu erstatten. Eine fehlgeschlagene oder abgebrochene Transaktion stuft eine bezahlte Bestellung nie herab. Eine Zahlung für eine bereits erstattete Bestellung fügt nur eine Notiz hinzu.

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

Reiter VibeFox Datatrans Gateway

Öffnen Sie unter Sales > Orders eine mit Datatrans bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox Datatrans Gateway die Transaction ID mit einem Hinweis Sandbox bei Sandbox-Zahlungen, den Datatrans-Status, die Payment method, den Amount, die Beträge Paid / refunded, die Schaltflächen zum Erfassen und Stornieren bzw. das Erstattungsformular, den Erstattungsverlauf und die Datatrans notes der Bestellung. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben. Ihre Aktionen erfordern das Recht, die Erweiterung zu bearbeiten (festgelegt unter System > Users > User Groups).

Erfassen und Stornieren

Bei einer nur autorisierten Zahlung zeigt der Reiter Capture Datatrans payment und Cancel Datatrans authorization. Die Erfassung begleicht die Zahlung für den aktuellen Bestellbetrag, der nicht höher sein darf als der autorisierte Betrag; danach wechselt die Bestellung auf Order status after payment. Die Stornierung gibt die Autorisierung frei und setzt die Bestellung auf Authorization canceled. Beides wird an die Umgebung der Zahlung gesendet. Lehnt Datatrans ab, zeigt der Reiter den Fehler, und eine Notiz wird hinzugefügt.

Erstattungen

Geben Sie im Reiter den Amount ein (der noch nicht erstattete Betrag wird vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via Datatrans. Bestätigen Sie die Frage Refund this amount through Datatrans? This cannot be undone. Voll- und Teilerstattungen werden unterstützt, und zwar bis zu dem Betrag, den Datatrans tatsächlich belastet hat, abzüglich früherer Erstattungen. Die Erstattung wird an die Umgebung der Zahlung gesendet, daher müssen Händler-ID und API-Passwort dieser Umgebung gesetzt sein. Eine wiederholte Erstattung wird nicht doppelt gutgeschrieben. Lehnt Datatrans die Erstattung ab, zeigt der Reiter den Fehler, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird mit der Datatrans-Transaktions-ID der Erstattung dem Erstattungsverlauf und den Notizen hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf Refunded, ohne den Kunden zu benachrichtigen und ohne Produkte in den Bestand zurückzubuchen, wie bei einer manuellen Statusänderung. Eine Teilerstattung ändert den Status nicht.

Erstattungen sind verfügbar, sobald Datatrans die Zahlung beglichen hat. Eine nur autorisierte Zahlung wird stattdessen erfasst oder storniert, und eine Autorisierung mit abweichendem Betrag kann erst erstattet werden, wenn sie beglichen ist.

Produktrücksendungen unter Sales > Returns senden kein Geld über Datatrans zurück. Im Datatrans-Web-Admin vorgenommene Erstattungen werden nicht in OpenCart erfasst.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Datatrans Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Datatrans 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-datatrans 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 Shopadresse 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 Shopadresse 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 Datatrans Kunden an 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 selben Browser im Admin angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert mit (unlicensed — visible to admins only), sodass Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. Bei OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Anmeldung im Admin-Bereich nicht, daher ist die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint auf dem Admin-Dashboard 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 Erstattungen funktionieren.

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 der Eingabe des Schlüssels, danach einmal wöchentlich. Ein Cron-Job ist nicht erforderlich. Das Deinstallieren der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Datatrans wird an der Kasse nicht angezeigt: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die aktuelle Umgebung ihre Händler-ID und ihr API-Passwort hat: die Sandbox-Felder im Sandbox-Modus, sonst die Produktionsfelder. Die Einstellungsseite listet fehlende Felder auf. Prüfen Sie außerdem, ob die Rechnungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den eingestellten Total erreicht.

Die Zahlung wurde durchgeführt, die Bestellung bleibt aber ohne Status: Datatrans konnte die Webhook-URL nicht erreichen, und der Kunde ist nicht in den Shop zurückgekehrt. Prüfen Sie, ob der Shop aus dem Internet erreichbar ist und keine Firewall Anfragen an die Webhook-URL blockiert. Prüfen Sie, ob der Signierschlüssel in den Einstellungen zur Umgebung der Zahlung gehört. Sehen Sie sich das Feld Log auf der Seite der Erweiterung an.

Der Webhook antwortet Invalid signature: Der HMAC-Signierschlüssel in den Einstellungen stimmt nicht mit dem im Datatrans-Web-Admin überein oder gehört zur anderen Umgebung. Kopieren Sie den Schlüssel erneut.

Der Webhook antwortet Not configured oder Verification failed: Der Webhook musste über die Status-API von Datatrans geprüft werden, aber die Zugangsdaten dieser Umgebung fehlen, oder Datatrans hat nicht geantwortet. Datatrans wiederholt den Webhook.

Der Webhook antwortet Busy, retry: Die Bestellung wurde im selben Moment von einer anderen Anfrage bestätigt, oder der Bestellstatus konnte nicht gesetzt werden. Datatrans wiederholt den Webhook. Das Protokoll zeigt den Grund.

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

Der HMAC-Signierschlüssel wird nicht gespeichert: Der Schlüssel muss eine hexadezimale Zeichenfolge sein. Kopieren Sie ihn erneut aus dem Datatrans-Web-Admin.

Der Kunde sieht Datatrans payments are not configured yet: Die Händler-ID oder das API-Passwort der aktuellen Umgebung fehlt.

Der Kunde sieht The payment could not be started: Sehen Sie sich das Feld Log an. Eine falsche Händler-ID oder ein falsches API-Passwort oder Zugangsdaten der falschen Umgebung sind die üblichen Ursachen.

Der Kunde sieht We could not verify the payment: Die Rücksprungadresse passte zu keinem Zahlungsversuch der Bestellung. Wurde Geld belastet, setzt der Webhook den Bestellstatus trotzdem.

Die Bestellung hat nach der Zahlung den Status On Hold: Lesen Sie die Datatrans notes im Reiter der Bestellung (siehe Bestellstatus) und erfüllen Sie dann die Bestellung oder erstatten Sie die Zahlung.

Die Erfassung wird abgelehnt: Der Bestellbetrag ist höher als der autorisierte Betrag. Datatrans kann nicht mehr begleichen, als autorisiert wurde.

Keine Erfassungsschaltflächen oder kein Erstattungsformular im Reiter: Der Reiter nennt den Grund: Die Zahlung ist noch nicht beglichen, sie ist vollständig erstattet, Ihre Benutzergruppe hat kein Recht, die Erweiterung zu bearbeiten, oder die Zugangsdaten der Zahlungsumgebung fehlen.

Erstattung oder Erfassung schlägt mit einer Meldung über fehlende Zugangsdaten fehl: Die Zahlung wurde in der anderen Umgebung getätigt, und deren Händler-ID oder API-Passwort ist nicht gesetzt. Geben Sie sie ein und versuchen Sie es erneut.

Für Entwickler: Bevor die Datatrans-Transaktion erstellt wird, löst die Erweiterung das OpenCart-Ereignis datatrans_p_init_request mit dem Request-Body und der Bestellung aus.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Datatrans 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 vier Bestellstatus des Abschnitts Payment processing, 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 Datatrans im Wartungsmodus durchlässt). Ist Delete data on uninstall eingeschaltet, werden die übrigen Moduleinstellungen (Titel, Beschreibung, Sandbox-Modus, Zugangsdaten, Auto settle, Protokollierung) und das Protokoll entfernt. Ist es ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die Datatrans-Transaktionen und -Erstattungen bleiben immer erhalten, sodass vorher bezahlte Bestellungen auch nach einer Neuinstallation erstattet oder erfasst werden können. 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 Datatrans Gateway auf Uninstall (die orangefarbene −-Schaltfläche) und danach auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

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