VibeFox Tpay 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. Für die JWS-Signaturprüfung der Benachrichtigungen werden die OpenSSL-Erweiterung und ausgehendes HTTPS zu secure.tpay.com benötigt.

Währung: nur Polnischer Złoty (PLN). Tpay rechnet in PLN ab, und die Open API von Tpay hat kein Währungsfeld. Fügen Sie PLN unter System > Localisation > Currencies hinzu, falls Ihr Shop es nicht hat: Tpay wird nur angezeigt, wenn der Kunde in PLN bezahlt.

Internetzugang zu Ihrem Shop: Tpay sendet Zahlungsbenachrichtigungen an Ihren Shop, daher muss die Benachrichtigungsadresse aus dem Internet erreichbar sein (nicht durch eine Firewall oder HTTP-Authentifizierung blockiert).

Tpay-Konto: Sie benötigen folgende Werte aus dem Tpay-Händlerportal: die Merchant ID (Ihre Tpay-Konto-ID), die Open-API-Schlüssel Client ID und Client secret (Integration, API) sowie den Sicherheitscode (Settings, Notifications). Sandbox-Schlüssel stammen aus einem separaten Tpay-Sandbox-Konto.

VibeFox-Lizenzschlüssel: Erwerb 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_tpay_payment-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_tpay_payment.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_tpay_payment-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 aus diesem Paket in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox Tpay Payment 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 License key).

4. Geben Sie die Sandbox-Schlüssel und die Produktionsschlüssel ein (siehe Configuration). Außer dem Sicherheitscode muss im Tpay-Portal nichts eingestellt werden: Die Benachrichtigungsadresse wird mit jeder Transaktion übertragen.

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Testen Sie eine Zahlung im Sandbox-Modus und schalten Sie danach Sandbox 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_tpay_payment.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 (der grüne +-Button).

3. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox Tpay Payment, klicken Sie auf Install (der grüne +-Button) und danach auf Edit (der Stift-Button).

4. Geben Sie den Lizenzschlüssel und die Tpay-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 Benachrichtigungs-URL ist anders (siehe Zahlungsbenachrichtigungen).

Eine Neuinstallation startet mit deaktivierter Zahlungsart und eingeschaltetem Sandbox-Modus.

Configuration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Payments > VibeFox Tpay Payment > Edit. Die Abschnitte stehen links; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen zeigt die Seite Sandbox mode is on: payments go to the Tpay sandbox and no real money is charged., solange der Sandbox-Modus eingeschaltet ist. Sie warnt, wenn die Schlüssel des aktuellen Modus unvollständig sind (Tpay wird dann an der Kasse nicht angezeigt), wenn die Standardwährung des Shops nicht PLN ist (Tpay wird dann nur angezeigt, wenn der Kunde in PLN bezahlt), und wenn die PHP-Erweiterung OpenSSL fehlt, während die JWS-Prüfung eingeschaltet ist (Zahlungen würden dann nicht bestätigt). 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 mehr als 128 Zeichen haben, Sort Order muss eine ganze Zahl sein (negative Werte sind erlaubt), Total muss eine Zahl von 0 oder mehr sein, und die Bestellstatus müssen existieren; andernfalls wird nichts gespeichert. Fehlende Schlüssel verhindern das Speichern nicht. Leerzeichen, die zusammen mit der Merchant ID oder der Client ID eingefügt werden, werden entfernt, und geheime Werte werden getrimmt.

Tpay

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

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

Description: der Text, den der Kunde im Schritt Confirm Order über der Bestätigungsschaltfläche sieht. Standard: Pay with BLIK, online bank transfer or card on the secure Tpay page.

Sandbox mode: verwendet die Tpay-Sandbox (Testzahlungen, kein echtes Geld) mit den Sandbox-Schlüsseln und openapi.sandbox.tpay.com. Schalten Sie ihn aus, um echte Zahlungen mit den Produktionsschlüsseln anzunehmen. Erstattungen gehen immer an die Umgebung, in der die Bestellung bezahlt wurde. Standard: an.

Sort Order: die Position von Tpay unter den Zahlungsarten an der Kasse. Lassen Sie das Feld leer oder geben Sie eine ganze Zahl ein (negative Werte sind erlaubt).

Geo Zone: Tpay nur für Rechnungsadressen in der gewählten Geo-Zone anbieten. Standard: All zones. Geo-Zonen richten Sie unter System > Localisation > Geo Zones ein.

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

Produktionsschlüssel

Wo Sie sie finden: im Tpay-Händlerportal (der Abschnitt verlinkt darauf) unter Integration, API (Open-API-Schlüssel: Client ID und Secret); die Merchant ID ist Ihre Tpay-Konto-ID; der Sicherheitscode steht unter Settings, Notifications.

Merchant ID: Ihre Tpay-Konto-ID (Ziffern). Tpay sendet sie mit jeder Benachrichtigung.

Client ID: die Open-API-Client-ID.

Client secret: das Open-API-Client-Secret.

Security code: wird zur Prüfung der MD5-Prüfsumme der Tpay-Benachrichtigungen verwendet.

Sandbox-Schlüssel

Die Sandbox ist ein separates Tpay-Testkonto mit eigenen Schlüsseln (der Abschnitt verlinkt auf die Tpay-API-Dokumentation). Sie wird nur verwendet, solange Sandbox mode eingeschaltet ist.

Sandbox Merchant ID: die Merchant ID des Sandbox-Kontos.

Sandbox Client ID: die Open-API-Client-ID des Sandbox-Kontos.

Sandbox Client secret: das Open-API-Client-Secret des Sandbox-Kontos.

Sandbox Security code: der Sicherheitscode für Benachrichtigungen des Sandbox-Kontos.

Gespeicherte Geheimnisse (Client secret und Security code beider Umgebungen) 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 ein gespeichertes Geheimnis zu entfernen, aktivieren Sie unter dem Feld Clear the saved value und klicken Sie auf Save.

Zahlungsbenachrichtigungen

Notification URL: Tpay bestätigt Zahlungen an die hier angezeigte Adresse. In OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_tpay_payment/notify, in OpenCart 4 so: https://your-store/index.php?route=extension/wcp_tpay_payment/payment/wcp_tpay_payment.notify. Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet. Die Adresse wird automatisch mit jeder Transaktion übertragen; im Tpay-Portal muss außer dem Sicherheitscode nichts eingestellt werden. Eine Bestellung erhält ihren Status erst nach einer Benachrichtigung mit gültiger Prüfsumme und Signatur und einem übereinstimmenden Betrag (oder einer übereinstimmenden Statusprüfung, wenn der Kunde zurückkehrt). Tpay wiederholt eine Benachrichtigung, bis Ihr Shop sie annimmt. Der Wartungsmodus blockiert die Adresse nicht (in OpenCart 4 fügt die Erweiterung eine Startaktion für die Benachrichtigungen und die Rückkehr des Kunden hinzu).

JWS signature: prüft zusätzlich die X-JWS-Signature der Benachrichtigungen mit dem Zertifikat von Tpay (empfohlen). Erfordert die OpenSSL-Erweiterung von PHP und ausgehendes HTTPS zu secure.tpay.com. Die Zertifikate werden einen Tag lang zwischengespeichert. Die MD5-Prüfsumme wird immer geprüft. Standard: an.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält erst dann einen Status, wenn Tpay die Zahlung bestätigt hat (über Benachrichtigung oder Statusprüfung). Die folgenden Felder enthalten Ihre Bestellstatus aus OpenCart.

Paid Order Status: der Status nach einer bestätigten Zahlung. Standard: In Bearbeitung.

On Hold (Review) Status: die Zahlung muss von Ihnen geprüft werden (siehe Bestellstatus). Standard: Ausstehend, da OpenCart keinen Status „In Prüfung“ hat. Sie können einen eigenen Status unter System > Localisation > Order Statuses anlegen und hier auswählen.

Cancelled Order Status: die Erweiterung setzt diesen Status nie. Eine Zahlung für eine Bestellung in diesem Status setzt die Bestellung in die Prüfung, statt sie stillschweigend wieder zu öffnen. Standard: Storniert.

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

Erweitert

Debug log: protokolliert Zahlungsereignisse: nur technische Ereignisse (keine Schlüssel, keine Kundendaten) in wc_tp_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 in eine alte Kopie verschoben. Standard: aus. Solange der Schalter aus ist, wird nichts geschrieben, auch keine Fehler; aktivieren Sie ihn daher, bevor Sie nach der Ursache eines Problems suchen.

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: Wenn aktiviert, entfernt die Deinstallation der Erweiterung die Gateway-Einstellungen und das Protokoll. Bestellungen und ihre Tpay-Zahlungsdaten bleiben immer erhalten. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Client secrets und Security codes werden nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Die gespeicherten Client secrets und Security codes bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Tpay). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will be redirected to the secure Tpay page to complete the payment. Im Sandbox-Modus wird außerdem Sandbox mode - no real money is charged. angezeigt. OpenCart legt die Bestellung in diesem Schritt an, noch ohne Status. Bei OpenCart 4 wählt der Kunde die Zahlungsart mit dem Button 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 Tpay-Transaktion für den Bestellbetrag in PLN mit der Beschreibung Order # und der Bestellnummer, übergibt Name, E-Mail-Adresse, Rechnungsadresse und Telefonnummer des Kunden und leitet den Kunden zur Tpay-Zahlungsseite weiter. Die Seite wird auf Polnisch, Englisch oder Ukrainisch angezeigt, je nach Sprache der Bestellung (andere Sprachen erhalten Englisch). Dort wählt der Kunde BLIK, eine Banküberweisung, eine Karte oder eine andere Methode, die in Ihrem Tpay-Konto aktiviert ist, und zahlt.

Die Bestellung wird erst als bezahlt markiert, wenn Tpay die Zahlung bestätigt. Tpay sendet eine Benachrichtigung an Ihren Shop; die Erweiterung prüft die MD5-Prüfsumme mit dem Sicherheitscode, der Merchant ID und (sofern eingeschaltet) der JWS-Signatur, und zwar mit den Schlüsseln der Umgebung, in der die Zahlung gestartet wurde, und danach den Betrag: Er muss dem für diesen Zahlungsversuch angeforderten Betrag und dem Bestellbetrag entsprechen, und der bezahlte Betrag darf nicht niedriger sein. Benachrichtigungen ohne gültige Prüfsumme oder Signatur werden abgelehnt. Die Bestellung erhält ihren Status dann auf die übliche OpenCart-Weise mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Rückkehr allein markiert nichts als bezahlt. Ist die Benachrichtigung noch nicht eingetroffen, fragt die Erweiterung über die Tpay-API den Status der Transaktion ab (höchstens alle 10 Sekunden) und wendet dieselben Prüfungen an. Sobald die Zahlung bestätigt ist, sieht der Kunde die Erfolgsseite der OpenCart-Bestellung. Solange sie nicht bestätigt ist, zeigt eine Seite Payment confirmation den Text Tpay has not confirmed your payment yet. If you have paid, refresh this page in a moment. If the payment did not go through, you can try again: mit einer Schaltfläche Refresh und einer Schaltfläche Pay again, die zurück zur Kasse führt. Die Benachrichtigung setzt den Bestellstatus, sobald sie eintrifft. Ist die Bestellung in die Prüfung gegangen, zeigt die Erfolgsseite außerdem Your payment is being verified. We will contact you as soon as it is confirmed.

Meldet Tpay, dass die Zahlung fehlgeschlagen ist, kehrt der Kunde zur Kasse zurück und sieht Tpay reports that the payment did not go through. Please try again or choose another payment method. Schlägt die Zahlung auf der Tpay-Seite fehl, schickt Tpay den Kunden zurück zur Kassenseite. Der Warenkorb bleibt in beiden Fällen erhalten.

In OpenCart 3 wird jedes Mal, wenn der Schritt Confirm Order angezeigt wird, eine neue Bestellung angelegt. OpenCart 4 behält eine Bestellung für die Kasse und aktualisiert sie, daher startet Pay again einen neuen Versuch derselben Bestellung. Jeder Zahlungsversuch hat seine eigene Referenz. Wenn der Kunde erneut bezahlt, werden die früheren unbezahlten Tpay-Transaktionen der Bestellung und anderer Bestellungen desselben Warenkorbs bei Tpay storniert; eine Zahlung, die über einen früheren Link bereits abgeschlossen wurde, wird weiterhin akzeptiert. Ist eine andere Bestellung desselben Warenkorbs bereits bezahlt, gelangt der Kunde zur Erfolgsseite statt zu einer neuen Zahlung.

In OpenCart 4, wenn die Bestellung der Kasse inzwischen vom Shop geschlossen wurde oder schon bezahlt ist, der Warenkorb sich aber seitdem geändert hat, auch durch eine neue Menge, wird der Kunde mit Your previous order is already closed or paid. Please confirm the order again: the cart will be paid with a new order. zurück zur Kasse geschickt. Für eine Bestellung, die der Shop vor jeder Zahlung storniert hat, lautet die Meldung Order #… was cancelled by the store before the payment was completed. No Tpay payment was received for it. Please place a new order or contact us. Der nächste Klick auf Confirm Order bezahlt eine neue Bestellung. In OpenCart 4 werden diese Meldungen, die Meldung über die fehlgeschlagene Zahlung und We could not match this payment to an order. If you were charged, please contact us. oberhalb der Kassenseite angezeigt.

Kann Tpay die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit The Tpay payment could not be started. Please try again or choose another payment method., und der Grund wird im Protokoll festgehalten (wenn Debug log eingeschaltet ist). Weitere Meldungen: Tpay accepts payments in Polish złoty (PLN) only. Please choose another payment method. und The order total must be greater than zero.

Die Erweiterung arbeitet nur in PLN. Es gibt im Shop keine Auswahl einer Bank oder eines BLIK-Codes (der Kunde wählt dies auf der Tpay-Seite), keine gespeicherten Karten, keine Abonnements, keine Apple-Pay- oder Google-Pay-Schaltflächen im Shop und keine Ratenrechner.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (fehlende Bestellung): Der Kunde wurde zu Tpay weitergeleitet und hat nicht bezahlt, oder Tpay hat die Zahlung noch nicht bestätigt. Eine fehlgeschlagene Zahlung lässt die Bestellung ebenfalls ohne Status. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Paid Order Status (default Processing): Tpay hat die Zahlung bestätigt. Eine Notiz zeigt den Titel der Tpay-Transaktion (TR-...), den bezahlten Betrag, ob die Bestätigung per Benachrichtigung oder per Statusprüfung erfolgte, die Umgebung und eventuelle Überzahlungen.

On Hold (Review) Status (default Pending): Eine Zahlung ist eingegangen, aber die Bestellwährung ist nicht PLN, der Betrag wich vom angeforderten Betrag oder vom Bestellbetrag ab (zum Beispiel wurde die Bestellung nach Beginn der Zahlung geändert), es wurde nur ein Teilbetrag bezahlt, oder die Zahlung traf für eine Bestellung im Cancelled Order Status ein. Die Notiz erklärt dies. Prüfen Sie die Zahlung im Tpay-Portal und erfüllen oder erstatten Sie die Bestellung. Bezahlt der Kunde danach über einen anderen Versuch den richtigen Betrag, wechselt die Bestellung in den Paid Order Status.

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

Meldet Tpay eine weitere Zahlung für eine Bestellung, die bereits bezahlt oder erstattet ist, bleibt die Bestellung unverändert; eine Notiz bittet Sie, die zusätzliche Zahlung bei Bedarf im Tpay-Portal zu erstatten. Eine Zahlung für eine andere Bestellung eines bereits bezahlten Warenkorbs lässt diese Bestellung ohne Status und wird auf der bezahlten Bestellung vermerkt. Eine fehlgeschlagene Zahlung für eine Bestellung, die bereits einen Status hat, ein Chargeback und ein unbekannter Tpay-Status fügen nur eine Notiz hinzu.

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

Tab VibeFox Tpay Payment

Öffnen Sie unter Sales > Orders eine mit Tpay bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Tab VibeFox Tpay Payment den Titel der Tpay transaction und die Transaction ID, die Zahlungsreferenz (CRC), die Environment (eine Kennzeichnung Sandbox bei Sandbox-Zahlungen), den Status der Zahlung und wie sie bestätigt wurde, den bezahlten Betrag, Order total / refunded, Refundable (paid through Tpay), wenn dieser vom Bestellbetrag abweicht, das Erstattungsformular, den Erstattungsverlauf, die Payment attempts der Bestellung (mit link cancelled bei stornierten Links) und die Payment notes. Der Tab wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie im Tab den Amount ein (der noch nicht erstattete Betrag ist bereits eingetragen), optional einen Reason (optional, kept in the note), und klicken Sie auf Refund via Tpay. Bestätigen Sie die Abfrage Refund this amount through Tpay? This cannot be undone. Vollständige und teilweise Erstattungen werden für Bestellungen mit einer über Tpay eingegangenen Zahlung unterstützt, einschließlich Bestellungen in der Prüfung. Sie benötigen das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups). Sie können bis zu dem Betrag erstatten, den die zahlende Tpay-Transaktion eingenommen hat, höchstens jedoch den Bestellbetrag. Die Erstattung wird an die Umgebung (Sandbox oder Produktion) gesendet, in der die Bestellung bezahlt wurde; die Schlüssel dieser Umgebung müssen daher eingerichtet sein. Eine Erstattung gilt erst als erledigt, wenn Tpay sie bestätigt; eine von Tpay abgelehnte oder nicht bestätigte Erstattung wird als Fehler angezeigt und nicht erfasst. Eine erfolgreiche Erstattung wird mit dem von Ihnen eingegebenen Grund in den Erstattungsverlauf und die Notizen eingetragen (der Grund wird nicht an Tpay gesendet). Die Erstattung des gesamten erstattungsfähigen Betrags setzt die Bestellung auf den Refunded Status, ohne den Kunden zu benachrichtigen und ohne Produkte in den Bestand zurückzubuchen, wie eine manuelle Statusänderung. Eine Teilerstattung ändert den Status nicht.

Produktrücksendungen unter Sales > Returns zahlen über Tpay kein Geld zurück. Im Tpay-Händlerportal vorgenommene Erstattungen werden nicht automatisch in OpenCart übernommen.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Tpay Payment ist der erste Block unter Extensions > Extensions > Payments > VibeFox Tpay Payment > 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 zur erneuten Statusprüfung, 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-tpay und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit dem Recht Modify für die Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen der Admin-Sprache (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt der Block den Grund, zum Beispiel Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Nachdem sich die Shop-Adresse geändert hat oder 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 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 Tpay 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), damit Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. In OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Admin-Anmeldung nicht, daher wird ohne aktiven Schlüssel die Zahlungsart für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint ein Hinweis auf dem Dashboard des Admins. 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, aber Updates und Support erfordern eine Verlängerung. Der Status wird beim Öffnen des Dashboard oder der Seite Edit im Admin automatisch erneut geprüft: einmal täglich in den ersten 14 Tagen nach der Eingabe des Schlüssels, danach einmal wöchentlich. Ein Cron-Job ist nicht nötig. Die Deinstallation der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Tpay erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und alle vier Schlüssel des aktuellen Modus eingegeben sind (Merchant ID, Client ID, Client secret, Security code). Prüfen Sie, ob der Kunde in PLN bezahlt, ob die Rechnungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht. Die Einstellungsseite zeigt eine Warnung bei fehlenden Schlüsseln und bei einer Shop-Währung ungleich PLN.

Die Zahlung ging durch, aber die Bestellung bleibt ohne Status: Tpay konnte die Benachrichtigung nicht zustellen oder sie wurde abgelehnt. Aktivieren Sie Debug log und sehen Sie im Feld Log auf der Erweiterungsseite nach. Häufige Ursachen sind ein falscher Sicherheitscode oder eine falsche Merchant ID für die Umgebung der Zahlung, eine blockierte Benachrichtigungsadresse (Firewall, HTTP-Authentifizierung) oder ein Server ohne OpenSSL oder ohne ausgehendes HTTPS für die JWS-Prüfung. Die Bestellung erhält ihren Status auch, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

Notification answered FALSE - invalid checksum: Die Merchant ID oder der Sicherheitscode in den Einstellungen passt nicht zum Tpay-Konto (Sandbox oder Produktion) der Zahlung.

Notification answered FALSE - invalid JWS signature: Die Signatur konnte nicht geprüft werden, zum Beispiel weil OpenSSL fehlt oder das Zertifikat von Tpay nicht heruntergeladen werden kann. Beheben Sie den Server oder schalten Sie bei Bedarf JWS signature aus; die MD5-Prüfsumme wird weiterhin geprüft.

Notification answered FALSE - busy, retry later or FALSE - order could not be updated: Der Warenkorb wurde im selben Moment von einer anderen Anfrage verarbeitet, oder der Bestellstatus konnte nicht gesetzt werden. Tpay wiederholt die Benachrichtigung automatisch. Aktivieren Sie Debug log, um den Grund zu sehen.

Die Benachrichtigungs-URL zeigt FALSE - POST only in the browser: Das ist normal. Die URL akzeptiert nur Benachrichtigungen von Tpay.

Die Bestellung ist im Prüfstatus: Lesen Sie die Notizen im Tab VibeFox Tpay Payment (siehe Bestellstatus), prüfen Sie die Zahlung im Tpay-Portal und erfüllen Sie dann die Bestellung oder erstatten Sie die Zahlung.

Der Kunde sah The Tpay payment could not be started: Die Schlüssel des aktuellen Modus sind falsch, oder Tpay hat die Anfrage abgelehnt. Aktivieren Sie Debug log; das Protokoll zeigt den Tpay-Fehler.

Der Kunde sah This payment method is not available: Die Checkout-Sitzung passt nicht mehr zur Bestellung, oder die Zahlungsart wurde in der Zwischenzeit deaktiviert oder hat ihre Schlüssel verloren. Der Kunde lädt die Kasse neu.

Der Kunde sah We could not match this payment to an order: Der Rücksprung-Link gehörte nicht zur Bestellung. Wurde der Kunde belastet, setzt die Benachrichtigung dennoch den Bestellstatus; prüfen Sie das Tpay-Portal.

Erstattung schlägt fehl: Meldet die Meldung, dass Schlüssel fehlen, geben Sie die Schlüssel der Umgebung ein, in der die Bestellung bezahlt wurde. Meldet sie, dass der Betrag zu hoch ist, kann höchstens der angezeigte Betrag erstattet werden. Hat Tpay die Erstattung nicht bestätigt, prüfen Sie die Transaktion im Tpay-Händlerportal, bevor Sie es erneut versuchen. Zeigt der Tab Tpay transaction ID not found., hat die Bestellung keine bestätigte Tpay-Zahlung, die erstattet werden könnte.

Für Entwickler: Vor dem Erstellen der Tpay-Transaktion löst die Erweiterung das OpenCart-Ereignis wc_tp_transaction_data mit den Transaktionsdaten, der Bestellung und der Umgebung aus.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Tpay Payment 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. Das OpenCart-Ereignis der Erweiterung (in OpenCart 4 seine Ereignisse und seine Startaktion) sowie die zwischengespeicherten Tpay-Zugriffstoken und Zertifikate werden immer entfernt. Ist Delete data on uninstall aktiviert, werden auch die übrigen Gateway-Einstellungen (Titel, Beschreibung, Sandbox-Modus, Schlüssel, JWS-Signatur, Schalter des Debug-Protokolls) und das Protokoll entfernt. Ist es deaktiviert, bleiben sie für eine spätere Neuinstallation erhalten. Die Tpay-Transaktionen und Erstattungen bleiben immer erhalten, sodass früher bezahlte Bestellungen auch nach einer Neuinstallation erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Bei OpenCart 4 entfernen Sie außerdem die Dateien der Erweiterung: Gehen Sie nach der Deinstallation zu Extensions > Installer, klicken Sie in der Liste der installierten Erweiterungen neben VibeFox Tpay Payment auf Uninstall (der orangefarbene −-Button) und danach auf Delete (der rote Papierkorb-Button), um das hochgeladene Paket zu entfernen.

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