VibeFox Paytrail 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: EUR. Paytrail akzeptiert nur Euro. Bei einer Bestellung in einer anderen Währung wird die Zahlungsart in der Kasse ausgeblendet. Beträge werden in Cent übermittelt.

Internetzugang für Ihren Shop: Paytrail bestätigt jede Zahlung mit einem Server-zu-Server-Callback, daher sollte der Shop aus dem Internet erreichbar sein. Ohne Callbacks werden Bestellungen trotzdem bestätigt, wenn der Kunde von Paytrail in den Shop zurückkehrt.

Paytrail-Konto: Sie benötigen Ihre Merchant ID und Ihren geheimen Schlüssel, die im Paytrail Merchant Panel angezeigt werden (Konto- oder Integrationsdaten). Zum Testen ist kein Konto nötig: Der Testmodus verwendet das öffentliche Testkonto von Paytrail. Die Zahlungsarten selbst werden in Ihrem Paytrail-Konto aktiviert.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. 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_paytrail_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_paytrail_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_paytrail_gateway-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 Paytrail 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 Lizenzschlüssel).

4. Um die Erweiterung zuerst auszuprobieren, aktivieren Sie Test mode. Für echte Zahlungen deaktivieren Sie ihn und tragen Ihre Merchant ID und Ihren Secret key ein. In Paytrail muss keine Callback-URL konfiguriert werden.

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_paytrail_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 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 Paytrail Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel und die Paytrail-Einstellungen wie in den Schritten 3 bis 5 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Callback-URL ist unterschiedlich (siehe Bestellungen).

Bei einer neuen Installation ist die Zahlungsart zunächst deaktiviert und der Testmodus ausgeschaltet.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Paytrail Gateway > Edit. Die Abschnitte sind links aufgeführt; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen zeigt die Seite bei aktiviertem Testmodus Der Testmodus ist aktiv. Zahlungen verwenden das öffentliche Paytrail-Testkonto — es wird kein echtes Geld belastet. Im Live-Modus warnt sie, wenn Merchant ID oder geheimer Schlüssel fehlen oder wenn die Merchant ID das öffentliche Testkonto 375917 ist; in diesen Fällen wird Paytrail nicht in der Kasse angezeigt. Sie warnt außerdem, wenn die Standardwährung des Shops nicht EUR ist: Paytrail wird dann nur angezeigt, wenn der Kunde in EUR bezahlt. 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 und nicht länger als 128 Zeichen sein, Sort Order muss eine ganze Zahl sein (negative Zahlen sind erlaubt), Total muss eine Zahl von 0 oder größer sein, und die Geo Zone sowie die Bestellstatus müssen vorhanden sein; andernfalls wird nichts gespeichert. Eine Merchant ID, die andere Zeichen als Ziffern enthält, wird nicht gespeichert: Es erscheint der Fehler Die Paytrail-Merchant-ID darf nur Ziffern enthalten. Der bisherige Wert wurde beibehalten. und die übrigen Einstellungen werden gespeichert.

Paytrail

Der Abschnitt beginnt mit einem kurzen Hinweis zur Paytrail-Zahlungsseite und der Regel, dass die Bestellung erst dann einen Status erhält, wenn Paytrail die Zahlung bestätigt hat.

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

Title: der Titel, den Kunden in der Kasse sehen. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Standard: Paytrail. Pflichtfeld, höchstens 128 Zeichen.

Description: der Text, der dem Kunden im Schritt Confirm Order oberhalb der Bestätigungsschaltfläche neben dem Paytrail-Symbol angezeigt wird. Standard: Pay securely with Finnish online banking, card, mobile payment or invoice on the Paytrail payment page.

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

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

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

API-Zugangsdaten

Ihre Merchant ID und Ihr geheimer Schlüssel werden im Paytrail Merchant Panel angezeigt (Konto- oder Integrationsdaten). Der Abschnitt verlinkt auf Paytrail. Es werden nur Zahlungen in EUR unterstützt.

Test mode: verwendet für neue Zahlungen das öffentliche Testkonto von Paytrail (Merchant ID 375917) statt Ihrer eigenen Zugangsdaten. Es wird kein echtes Geld belastet, und es werden keine Schlüssel benötigt. Kunden sehen im Schritt Confirm Order die Meldung Testmodus: Es wird keine echte Zahlung vorgenommen. Der geheime Schlüssel des Testkontos ist öffentlich, daher könnte jeder eine im Testmodus getätigte Zahlung simulieren. Lassen Sie den Testmodus niemals in einem Live-Shop eingeschaltet. Standard: aus.

Merchant ID: Ihre Paytrail-Merchant-ID (nur Ziffern). Sie wird verwendet, wenn der Testmodus aus ist. Anders als der geheime Schlüssel wird sie nach dem Speichern auf der Seite angezeigt.

Secret key: Ihr geheimer Paytrail-Schlüssel. Er wird verwendet, wenn der Testmodus aus ist. Der gespeicherte Schlüssel wird nie wieder angezeigt. Das Feld bleibt leer und zeigt Gespeichert — leer lassen, um ihn zu behalten. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um den gespeicherten Schlüssel zu entfernen, aktivieren Sie unter dem Feld Clear saved secret key und klicken Sie auf Save.

Callbacks und Erstattungen verwenden immer die Zugangsdaten des Modus, in dem die Zahlung getätigt wurde. Ein Wechsel zwischen Test- und Live-Modus beeinträchtigt daher ältere Bestellungen nicht.

Bestellungen

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

Callback URL: zeigt die URL, unter der Paytrail jede Zahlung per Server-zu-Server-Verbindung bestätigt. Auf OpenCart 3 hat sie das Format https://your-store/index.php?route=extension/payment/wcp_paytrail_gateway/callback, auf OpenCart 4 https://your-store/index.php?route=extension/wcp_paytrail_gateway/payment/wcp_paytrail_gateway.callback. Sie wird bei jeder Zahlung mitgesendet, daher muss im Paytrail-Panel nichts konfiguriert werden; der Shop muss aber aus dem Internet erreichbar sein.

Order status after payment: der Status einer bezahlten Bestellung. Standard: Processing. Wählen Sie Complete, wenn jede bezahlte Bestellung sofort abgeschlossen werden soll.

Awaiting payment status: Paytrail meldet die Zahlung als ausstehend oder verzögert (eine Rechnung oder Ratenzahlung, die auf die Genehmigung des Anbieters wartet). Die Bestellung wird automatisch aktualisiert, sobald Paytrail die Zahlung bestätigt oder ablehnt. Standard: Pending.

Payment on hold status: die Zahlung benötigt Ihre Aufmerksamkeit (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 failed status: wird gesetzt, wenn eine ausstehende Paytrail-Zahlung fehlschlägt. Standard: Failed.

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

Erweitert

Debug log: protokolliert API-Anfragen und Callbacks in ptg_debug.log.php im Logordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden, und bei 5 MB wird sie nach ptg_debug.old.log.php verschoben. Personenbezogene Daten und Schlüssel werden nicht protokolliert. Fehler und Warnungen werden immer 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 sie aktiviert, entfernt das Deinstallieren der Erweiterung die Gateway-Einstellungen und das Protokoll. Das Deaktivieren der Erweiterung löscht nie etwas. Die Paytrail-Transaktionsdaten der Bestellungen bleiben immer erhalten, weil Erstattungen älterer Bestellungen sie benötigen. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Merchant ID und geheimer Schlüssel werden nicht exportiert.

Import: fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Die gespeicherte Merchant ID und der geheime Schlüssel bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Paytrail). Im Schritt Confirm Order sieht der Kunde das Paytrail-Symbol und Ihre Beschreibung. OpenCart erstellt die Bestellung in diesem Schritt, weiterhin ohne Status. Auf 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. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine Paytrail-Zahlung über den Bestellbetrag in Euro mit der Bestellnummer als Referenz und übermittelt die Bestellpositionen: Produkte mit ihren Optionen und Steuern, gekaufte Geschenkgutscheine, Versand und sonstige Gebühren. Gutscheine, Guthaben im Shop, Bonuspunkte und eingelöste Geschenkgutscheine werden auf die Positionen verteilt. Die Positionen ergeben immer den Zahlungsbetrag; eine Rundungsdifferenz wird einer Position zugeschlagen oder als Position Rounding übermittelt. Die Kontaktdaten des Kunden werden übermittelt, Rechnungs- und Lieferadressen nur, wenn sie vollständig sind. Die Sprache der Zahlungsseite ist Finnisch, Schwedisch oder Englisch, je nach Sprache des Kunden.

Der Kunde wird zur Paytrail-Zahlungsseite weitergeleitet, wählt eine Zahlungsart, die für Ihr Paytrail-Konto aktiviert ist, und bezahlt. Paytrail bestätigt die Zahlung zweimal: Es leitet den Kunden zurück in Ihren Shop und ruft die Callback-URL Server-zu-Server auf. Beide Bestätigungen werden nur mit einer gültigen Signatur akzeptiert, die mit den Zugangsdaten dieses Zahlungsversuchs erstellt wurde, und nur für einen Versuch, der für diese Bestellung angelegt wurde. Der bezahlte Betrag wird mit dem Bestellbetrag verglichen. Die Bestellung wird erst als bezahlt markiert, wenn Paytrail die Zahlung so bestätigt hat, und erhält dann ihren Status auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung. Die Erweiterung verarbeitet diese Paytrail-Status:

Nach einer erfolgreichen Zahlung sieht der Kunde die Erfolgsseite der OpenCart-Bestellung mit Ihre Paytrail-Zahlung wurde empfangen. Bei einer ausstehenden Zahlung zeigt die Seite Ihre Paytrail-Zahlung wartet auf die Bestätigung durch den Zahlungsanbieter. Die Bestellung wird automatisch aktualisiert — bitte zahlen Sie nicht erneut. Wenn der Callback die Zahlung genau in diesem Moment erfasst, bittet eine Seite Payment confirmation den Kunden, nicht erneut zu zahlen, und bietet Check again an.

Nach einer abgebrochenen oder fehlgeschlagenen Zahlung kehrt der Kunde zur Kasse zurück, mit Die Paytrail-Zahlung wurde abgebrochen oder ist fehlgeschlagen. Sie können es erneut versuchen oder eine andere Zahlungsart wählen. Ist die Zahlung noch nicht abgeschlossen, lautet die Meldung Die Paytrail-Zahlung wurde noch nicht abgeschlossen. Sie können es erneut versuchen oder eine andere Zahlungsart wählen. Der Warenkorb bleibt erhalten. Auf OpenCart 4 werden diese Meldungen oberhalb der Kassenseite angezeigt. Eine Rückkehr, die nicht geprüft werden kann, zeigt eine Seite Payment Error mit Payment verification failed. und verändert nichts.

Kann Paytrail die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung oberhalb der Schaltfläche, zum Beispiel Verbindung zu Paytrail nicht möglich. Bitte versuchen Sie es in Kürze erneut., Paytrail ist vorübergehend nicht verfügbar. Bitte wählen Sie eine andere Zahlungsart. (falsche Zugangsdaten) oder Paytrail konnte die Zahlung nicht starten. Bitte prüfen Sie Ihre Rechnungsangaben und versuchen Sie es erneut oder wählen Sie eine andere Zahlungsart. Der technische Grund wird im Protokoll festgehalten. Ein Gesamtbetrag außerhalb der Grenzen von Paytrail führt zu Dieser Bestellbetrag kann nicht mit Paytrail bezahlt werden. Bitte wählen Sie eine andere Zahlungsart.

OpenCart 3 erstellt jedes Mal eine neue Bestellung, wenn der Schritt Confirm Order angezeigt wird, OpenCart 4 aktualisiert die Bestellung der Kasse (ein neuer Versuch bezahlt dieselbe Bestellung). Wurde der Warenkorb bereits mit einer anderen Bestellung bezahlt, gelangt der Kunde direkt zur Erfolgsseite, und es wird keine neue Zahlung gestartet. Eine Paytrail-Zahlung kann nicht über die API storniert werden, daher bleibt eine ältere Zahlungsseite zahlbar. Bezahlt der Kunde sie trotzdem, wird die zweite Zahlung an der bezahlten Bestellung als zu erstattendes Duplikat vermerkt, und die andere Bestellung bleibt ohne Status. Eine Änderung des Warenkorbs, auch eine neue Menge, gilt als neuer Warenkorb, der eine eigene Zahlung benötigt.

Auf OpenCart 4 bleibt die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel von Ihnen storniert), wird der Kunde mit der Meldung Ihre vorherige Bestellung wurde storniert oder erstattet. Bitte bestätigen Sie die Bestellung erneut, um mit einer neuen Bestellung zu bezahlen. zur Kasse zurückgeschickt. War die Zahlung dieser Bestellung noch ausstehend und ist sie fehlgeschlagen, lautet die Meldung Die Paytrail-Zahlung wurde abgebrochen oder ist fehlgeschlagen. Sie können es erneut versuchen oder eine andere Zahlungsart wählen. Das nächste Confirm Order bezahlt eine neue Bestellung. War diese Bestellung bereits für einen früheren Warenkorb bezahlt und hat sich der Warenkorb seitdem geändert, wird der Kunde zur Kasse zurückgeführt, und das nächste Confirm Order bezahlt eine neue Bestellung des aktuellen Warenkorbs. Eine geschlossene Bestellung wird nie als bezahlt angezeigt.

Der Callback funktioniert auch, wenn der Shop im Wartungsmodus ist, weil OpenCart Anfragen von Zahlungserweiterungen durchlässt (auf OpenCart 4 fügt die Erweiterung dafür eine eigene Startaktion hinzu, die außerdem die Rückkehr des Kunden von Paytrail zulässt).

Der Kunde wählt die Zahlungsart auf der Paytrail-Seite, nicht in Ihrer Kasse. Die Erweiterung hat keine Kartentokenisierung und keine gespeicherten Karten, keine Abonnements, kein Shop-in-Shop, keine manuelle Rechnungsfreigabe und keine Abrechnungsberichte.

Bestellungen und Erstattungen

Bestellstatus

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

Order status after payment (Standard Processing): die Zahlung wurde bestätigt. Eine Notiz zeigt die Paytrail-Transaktion, die bei Paytrail verwendete Zahlungsart und den Betrag, bei Testzahlungen mit TEST mode — no real money.

Awaiting payment status (Standard Pending): die Zahlung ist beim Anbieter ausstehend (Rechnung oder verzögerte Zahlung). Die Bestellung wechselt in den bezahlten Status, wenn Paytrail die Zahlung bestätigt, oder in den fehlgeschlagenen Status, wenn sie fehlschlägt.

Payment on hold status (Standard Pending): der bezahlte Betrag weicht vom Bestellbetrag ab (der tatsächlich bezahlte Betrag wird vermerkt), die Zahlung ging ein, nachdem die Bestellung auf einen anderen Status gesetzt worden war, zum Beispiel storniert, oder eine Testzahlung ging ein, während die Erweiterung im Live-Modus lief (kein echtes Geld, nichts zu erstatten). Die Notiz erklärt den Grund. Prüfen Sie die Bestellung und bearbeiten Sie sie anschließend oder erstatten Sie die Zahlung.

Payment failed status (Standard Failed): eine ausstehende Paytrail-Zahlung ist fehlgeschlagen oder wurde abgebrochen.

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

Wiederholte oder parallele Callbacks werden nur einmal angewendet, ohne doppelte Notizen. Eine bezahlte, erstattete oder abgeschlossene Bestellung wird durch einen späteren Callback nie wieder geöffnet. Wird ein zweiter Versuch einer bereits bezahlten Bestellung oder eines bereits bezahlten Warenkorbs bezahlt, bleibt die Bestellung unverändert; eine Notiz Duplicate payment bittet Sie, die Zahlung im Paytrail Merchant Panel zu erstatten.

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

Registerkarte VibeFox Paytrail Gateway

Öffnen Sie unter Sales > Orders eine Bestellung, die mit Paytrail bezahlt wurde. Unten auf der Bestellseite, neben History und Additional, listet die Registerkarte VibeFox Paytrail Gateway die Zahlungsversuche der Bestellung auf (Datum, Paytrail-Transaktion und Stempel mit der Kennzeichnung Test für Testzahlungen, Betrag, Zahlungsart, Paytrail-Status und Ergebnis), die Beträge Paid / refunded, das Erstattungsformular, den Erstattungsverlauf und die Paytrail notes der Bestellung. Die Registerkarte wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie auf der Registerkarte VibeFox Paytrail Gateway den Amount ein (der noch nicht erstattete Betrag wird eingetragen), optional einen Grund für die Bestellnotiz, und klicken Sie auf Refund via Paytrail. Bestätigen Sie die Abfrage Diesen Betrag über Paytrail erstatten? Dies kann nicht rückgängig gemacht werden. Vollständige und teilweise Erstattungen werden unterstützt, jeweils nur als Betrag. Sie benötigen das Recht, die Erweiterung zu ändern (einzustellen unter System > Users > User Groups). Sie können bis zu dem Betrag erstatten, den Paytrail tatsächlich eingezogen hat; nach einer Betragsabweichung ist die Grenze daher das, was der Kunde bezahlt hat, und nicht der Bestellbetrag. Die Erstattung verwendet die Zugangsdaten des Modus, in dem die Zahlung getätigt wurde; für eine Live-Zahlung müssen daher die Live-Zugangsdaten eingetragen sein. Erstattungen sind verfügbar, sobald Paytrail die Zahlung bestätigt hat.

Unterstützt die Zahlungsart keine direkten Erstattungen, startet die Erweiterung automatisch eine Erstattung per E-Mail: Paytrail sendet dem Kunden eine E-Mail, in der er eine Bankverbindung eingeben kann. Dafür wird die E-Mail-Adresse des Kunden zur Bestellung benötigt. Die Notiz zeigt an, welche Art der Erstattung gestartet wurde.

Eine Erstattung kann sofort abgeschlossen werden oder später bearbeitet werden. Die spätere Bestätigung von Paytrail wird als Notiz ergänzt. Konnte Paytrail die Erstattung nicht abschließen, weist eine Notiz darauf hin, dass das Geld nicht an den Kunden zurückgegeben wurde, und die Erstattung zählt nicht mehr als erstattet; erstatten Sie dem Kunden auf einem anderen Weg. Lehnt Paytrail die Erstattung sofort ab, zeigt die Registerkarte den Fehler, und es wird keine Erstattung verbucht. 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, wie bei einer manuellen Statusänderung. Eine Teilerstattung ändert den Status nicht.

Produktrücksendungen unter Sales > Returns senden kein Geld über Paytrail zurück. Im Paytrail Merchant Panel vorgenommene Erstattungen werden nicht mit OpenCart synchronisiert.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Paytrail Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Paytrail Gateway > Edit, oberhalb der Einstellungen. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den maskierten Schlüssel, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig ist, und Ihre Domain) sowie die Schaltflächen Check now, 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-paytrail 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. 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 Paytrail 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 einrichten und testen können, bevor Sie einen Schlüssel kaufen. Auf OpenCart 4 ist diese Vorschau nicht verfügbar: Die Shop-Seite sieht die Admin-Anmeldung nicht, daher wird die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint auf dem Dashboard des Admin-Bereichs eine Erinnerung. Schließen Sie sie mit ×, um sie für 7 Tage auszublenden. Bestehende Bestellungen sind nicht betroffen: Bereits begonnene Zahlungen werden weiterhin durch die Callbacks und die Rückkehr des Kunden bestätigt, und Erstattungen funktionieren.

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

Fehlerbehebung

Paytrail erscheint nicht in der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und entweder Test mode aktiviert ist oder Merchant ID und Secret key ausgefüllt sind (und nicht das öffentliche Testkonto 375917 eingetragen ist). Prüfen Sie, dass der Kunde in EUR bezahlt, dass die Zahlungsadresse in der gewählten Geo Zone liegt und dass die Bestellung den in den Einstellungen festgelegten Total-Betrag erreicht. Die Einstellungsseite zeigt eine Warnung bei fehlenden Zugangsdaten und bei einer Shop-Währung, die nicht EUR ist.

Die Zahlung ist erfolgt, aber die Bestellung bleibt ohne Status: der Callback kann Ihren Shop nicht erreichen, und der Kunde ist nicht in den Shop zurückgekehrt. Die im Bereich Orders angezeigte Callback URL muss aus dem Internet erreichbar sein (keine Basisauthentifizierung oder Firewall im Weg).

Callback oder Rückkehr antwortet Payment verification failed.: die Signatur ist ungültig, oder die Zahlung gehört nicht zu einem Zahlungsversuch der Bestellung. Es wird nichts verändert. Prüfen Sie, dass der Secret key korrekt ist und zur Merchant ID gehört.

Der Callback antwortet Temporarily unavailable: die Bestellung wurde im selben Moment von einer anderen Anfrage bestätigt, oder der Bestellstatus konnte nicht gesetzt werden. Paytrail ruft erneut auf. Sehen Sie im Feld Log nach dem Grund.

Der Kunde sieht nach Confirm Order einen Fehler: sehen Sie im Feld Log auf der Seite der Erweiterung nach. Paytrail API error (401) bedeutet zum Beispiel falsche Zugangsdaten. Aktivieren Sie Debug log für weitere Details. This payment method is not available. Please reload the checkout page. bedeutet, dass die Zahlungsart in der Zwischenzeit deaktiviert wurde oder die Kasse nicht mehr zur Bestellung passt.

Die Merchant ID wird nicht gespeichert: sie darf nur Ziffern enthalten. Kopieren Sie sie erneut aus dem Paytrail Merchant Panel.

Die Bestellung ist im Status „On hold“: lesen Sie die Notizen auf der Registerkarte VibeFox Paytrail Gateway. Der Grund ist ein anderer bezahlter Betrag, eine Zahlung nach einer Statusänderung oder eine Testzahlung im Live-Modus.

Erstattung schlägt fehl: lesen Sie die Meldung. This order has no confirmed Paytrail payment. Refund it manually. bedeutet, dass keine bestätigte Paytrail-Zahlung zum Erstatten vorliegt. The live Paytrail credentials used for this payment are missing. Enter them in the Paytrail settings. bedeutet, dass die Zahlung im Live-Modus getätigt wurde und die Live-Zugangsdaten nicht eingetragen sind. Invalid refund amount: at most … bedeutet, dass der Betrag größer ist als der noch erstattbare Rest. This payment method supports only e-mail refunds, but the order has no billing e-mail. bedeutet, dass die Bestellung die E-Mail-Adresse des Kunden benötigt.

Für Entwickler: Bevor die Zahlungsanfrage signiert und gesendet wird, löst die Erweiterung das OpenCart-Ereignis ptg_payment_request mit der Anfrage und der Bestellung aus.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Paytrail Gateway auf Uninstall (die rote −-Schaltfläche). Lizenzschlüssel und 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ückkehren. Das OpenCart-Ereignis der Erweiterung wird ebenfalls entfernt (auf OpenCart 4 werden seine Ereignisse und seine Startaktion entfernt, über die der Callback und die Rückkehr des Kunden auch im Wartungsmodus durchgelassen werden). Ist Delete data on uninstall aktiviert, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Testmodus, Merchant ID, geheimer Schlüssel, Protokollierung) und das Protokoll entfernt. Ist die Option deaktiviert, bleiben sie für eine spätere Neuinstallation erhalten. Die Paytrail-Transaktionen und -Erstattungen bleiben immer erhalten, sodass zuvor bezahlte Bestellungen nach einer Neuinstallation noch erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

Paytrail ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung steht in keiner Verbindung zu Paytrail und wird von Paytrail nicht unterstützt.