VibeFox Tranzila 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: ILS, USD, EUR oder GBP. Für andere Kundenwährungen wird die Zahlungsart an der Kasse ausgeblendet.

Tranzila-Terminal: Sie benötigen den Terminalnamen. Das Terminal-Passwort (TranzilaPW) wird für den Handshake und für Erstattungen über die Bestellseite benötigt. Einige Terminals benötigen für Erstattungen zusätzlich ein separates Kreditpasswort (CreditPass). Terminalname und Passwörter stellt Tranzila bereit: Sie finden sie in Ihren Terminal-Einstellungen oder erfragen sie beim Tranzila-Support. Für Tests stellt Tranzila ein separates Testterminal bereit; tragen Sie dessen Namen als Terminalnamen ein.

Echte Besucher-IP: Zahlungsbenachrichtigungen werden anhand der IP-Adresse des Tranzila-Servers geprüft. Wenn Ihr Shop hinter einem Proxy oder einem CDN wie Cloudflare läuft, muss der Webserver die echte Besucher-IP an PHP übergeben (REMOTE_ADDR).

VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel funktioniert für eine Domain.

Installation

Der Download ist eine einzige ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das OpenCart-3-Paket wcp_tranzila_payment_gateway-oc3-(version).ocmod.zip und das OpenCart-4-Paket wcp_tranzila_payment_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_tranzila_payment_gateway-oc3-(version).ocmod.zip. Die Erweiterung hat keine OCMOD-Änderungen, daher muss Extensions > Modifications nicht aktualisiert werden. Statt des Installers können Sie den Inhalt des Ordners upload dieses Pakets auch in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox Tranzila Payment 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 den Terminal name (supplier) ein sowie das Terminal password (TranzilaPW), falls Sie den Handshake oder Erstattungen nutzen.

5. Lassen Sie Notifications eingeschaltet und prüfen Sie Trusted IP: Dort müssen die IP-Adressen stehen, von denen Tranzila Benachrichtigungen sendet. Bestätigen Sie die Liste mit dem Tranzila-Support. Die Benachrichtigungs-URL wird bei jeder Zahlung mitgesendet, Sie müssen sie also nirgendwo kopieren.

6. Empfohlen: Aktivieren Sie den Handshake im Tranzila-Terminal, erlauben Sie dort die IP-Adresse Ihres Servers und schalten Sie danach Handshake in der Erweiterung ein.

7. Schalten Sie Enable/Disable ein, klicken Sie auf Save und testen Sie eine Zahlung mit dem Tranzila-Testterminal.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_tranzila_payment_gateway.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 entnimmt den Code der Erweiterung dem Dateinamen, und ein umbenanntes Paket funktioniert nicht.

2. Das Paket erscheint in der Liste der installierten Erweiterungen auf derselben Seite. Klicken Sie daneben auf Install (die grüne +-Schaltfläche).

3. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox Tranzila Payment 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 Einstellungen ein wie in den Schritten 3 bis 7 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich.

Eine neue Installation startet mit ausgeschalteter Zahlungsart.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Tranzila Payment Gateway > Edit. Die Abschnitte stehen links; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt Sie die Seite, wenn der Terminalname leer ist (die Zahlungsart wird dann an der Kasse ausgeblendet), wenn Benachrichtigungen deaktiviert sind oder Trusted IP leer ist (bezahlte Bestellungen werden dann zur manuellen Prüfung zurückgehalten), wenn der Handshake ohne Terminal-Passwort eingeschaltet ist (die Zahlungsseite kann dann nicht geöffnet werden) und wenn die Standardwährung des Shops nicht unterstützt wird. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen, kann sie aber nicht speichern.

Beim Speichern lehnt die Seite nie alles auf einmal ab. Ein leeres Title oder eines mit mehr als 128 Zeichen, ein ungültiger Terminalname, ein ungültiger Eintrag in Trusted IP, ein Zahlenfeld, das keine ganze Zahl ist, oder ein ungültiger Wert bei Sort Order, Total, Geo Zone oder einem Bestellstatus wird nicht gespeichert: Die Seite zeigt die Meldung in einem roten Block oberhalb der Einstellungen, und das Feld zeigt wieder den vorherigen Wert. Eine Zahl außerhalb des erlaubten Bereichs wird als nächstgelegener erlaubter Wert gespeichert, und die Seite teilt dies mit, zum Beispiel dass 5000 außerhalb von 400–1500 liegt und als 1500 gespeichert wurde. Alle übrigen Felder werden gespeichert.

Tranzila

Enable/Disable: Enable Tranzila Payment Gateway schaltet die Zahlungsart ein oder aus. Standard: off.

Title: der Name der Zahlungsart, den Kunden an der Kasse sehen, und der Titel der Zahlungsseite. Er wird auch als Zahlungsart in der Bestellung gespeichert, daher ist er ein Pflichtfeld und darf höchstens 128 Zeichen lang sein. Standard: Credit Card (Tranzila).

Description: der Text, den der Kunde im Schritt Confirm Order über der Bestätigungsschaltfläche sieht. Standard: Pay securely with your credit card on the Tranzila payment page.

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

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

Total: die Kassensumme in der Standardwährung des Shops, die eine Bestellung erreichen muss, bevor Tranzila angeboten wird. Lassen Sie das Feld leer, um Tranzila bei jeder Summe anzubieten.

Terminal

Terminal name (supplier): Ihr Tranzila-Terminalname, zum Beispiel myshop. Nur Buchstaben, Ziffern, „-“ und „_“. Solange er nicht eingetragen ist, wird die Zahlungsart an der Kasse nicht angezeigt. Für Tests tragen Sie den Namen Ihres Tranzila-Testterminals ein.

Terminal password (TranzilaPW): das API-Passwort des Terminals. Es wird für den Handshake und für Erstattungen über die Bestellseite benötigt.

Refund password (CreditPass): nur, wenn Ihr Terminal für Kredittransaktionen (Erstattungen) ein separates Passwort verlangt. Ansonsten leer lassen.

Gespeicherte Passwörter werden nie wieder 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 Passwort zu entfernen, setzen Sie unter dem Feld den Haken bei Clear saved password on save und klicken Sie auf Save.

Zahlungsseite

Payment page version: die Tranzila-Seite, die im iFrame angezeigt wird.

Payment page language: die Sprache der Tranzila-Seite: Site language, Hebräisch, Englisch, Russisch, Spanisch, Deutsch, Französisch oder Japanisch. Standard: Hebrew. Site language verwendet die Shop-Sprache des Kunden, wenn es eine dieser Sprachen ist, andernfalls Englisch.

iFrame width (px): 300 bis 1200. Standard: 600. Auf kleinen Bildschirmen ist der Rahmen nie breiter als die Seite.

iFrame height (px): 400 bis 1500. Standard: 650.

Max installments: die maximale Anzahl an Ratenzahlungen (Tashlumim), die der Kunde auf der Zahlungsseite wählen darf, bis zu 36. 0 oder 1 bedeutet keine Raten. Standard: 0. Das Terminal muss für Ratenzahlungen freigeschaltet sein.

Handshake: sperrt den Betrag mit einem Handshake-Token (empfohlen). Bevor die Zahlungsseite geöffnet wird, fordert der Shop bei Tranzila ein einmalig gültiges Token an, das an den Betrag gebunden ist, sodass der Betrag im Browser nicht geändert werden kann. Dafür sind das Terminal-Passwort, der im Tranzila-Terminal aktivierte Handshake und die dort freigegebene IP-Adresse Ihres Servers erforderlich. Standard: off.

Zahlungsbestätigung

Tranzila-Benachrichtigungen sind nicht signiert. Eine Bestellung erhält den Status „bezahlt“ nur, wenn die Benachrichtigung von einer Trusted IP stammt und ihr Zahlungsseiten-Token, ihre Bestellung, ihr Terminal, ihr Betrag und ihre Währung mit der Zahlungsseite übereinstimmen. Beim Handshake muss zusätzlich das Token übereinstimmen. Die Rückkehr des Kunden von der Zahlungsseite markiert eine Bestellung niemals als bezahlt.

Notifications: bestätigt Zahlungen automatisch über Tranzila-Benachrichtigungen (Benachrichtigungs-URL). Standard: on. Wenn Benachrichtigungen ausgeschaltet sind, setzt ein Kunde, der nach einer erfolgreichen Zahlungsseite zurückkommt, die Bestellung auf On hold status, und Sie bestätigen die Zahlung manuell, nachdem Sie das Tranzila-Terminal geprüft haben.

Notification URL: wird zur Information angezeigt. In OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_tranzila_payment_gateway/notify, in OpenCart 4 so: https://your-store/index.php?route=extension/wcp_tranzila_payment_gateway/payment/wcp_tranzila_payment_gateway.notify. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet. Die URL wird bei jeder Zahlung an Tranzila gesendet, Sie müssen sie also nicht im Tranzila-Terminal eintragen. Sie funktioniert auch, wenn der Shop im Wartungsmodus ist (in OpenCart 4 lässt eine Startaktion der Erweiterung Benachrichtigung und Rückkehr des Kunden durch).

Trusted IP: die IP-Adressen oder CIDR-Bereiche der Tranzila-Server, die Benachrichtigungen senden, durch Kommas getrennt. Standard: 80.244.170.7. Bestätigen Sie die aktuelle Liste mit dem Tranzila-Support. Benachrichtigungen von anderen Adressen werden abgelehnt. Ist das Feld leer, können Benachrichtigungen nicht überprüft werden: Eine gemeldete erfolgreiche Zahlung setzt die Bestellung auf On hold status zur manuellen Prüfung, und eine gemeldete Ablehnung ändert nichts.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält nur dann einen Status, wenn eine geprüfte Tranzila-Benachrichtigung vorliegt. OpenCart hat keinen Status für „On hold“, daher wird der hier gewählte Status verwendet, und eine Bestellnotiz erklärt den Grund. Jedes der folgenden Felder listet Ihre OpenCart-Bestellstatus auf.

Order status after payment: die Zahlung wurde durch eine geprüfte Benachrichtigung bestätigt (Betrag, Währung, Terminal und Token stimmen überein). Standard: Processing.

On hold status: die Zahlung benötigt Ihre Prüfung: Betrag, Währung oder Handshake-Token stimmen nicht überein, die Benachrichtigung konnte nicht überprüft werden (keine Trusted IP), oder Benachrichtigungen sind deaktiviert und der Kunde kam von einer erfolgreichen Zahlungsseite zurück. Standard: Pending. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

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

Cancelled order status: die Erweiterung setzt diesen Status nicht. Eine Bestellung mit diesem Status, die später bezahlt wird, wird mit einer Notiz wieder geöffnet, die Sie an die Prüfung des Lagerbestands erinnert. Standard: Canceled.

Payment error status: die Erweiterung setzt diesen Status nicht. Eine Bestellung mit diesem Status wird durch eine spätere genehmigte Tranzila-Zahlung bezahlt. Standard: Failed.

Erweitert

Debug log: protokolliert Ereignisse der Zahlungsseite, der Benachrichtigungen und der Erstattungen in tranzila_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs; in OpenCart 4 system/storage/logs). Die Datei lässt sich nicht über das Web öffnen; bei 5 MB wird sie nach tranzila_p_debug.old.log.php verschoben. Warnungen und Fehler werden immer protokolliert, auch wenn diese Option ausgeschaltet ist. Passwörter, Tokens und Kundendaten werden nie geschrieben. Standard: off.

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 eingeschaltet, entfernt das Deinstallieren der Erweiterung die Einstellungen und das Protokoll. Die Tranzila-Transaktionen und Erstattungen bleiben immer erhalten, weil ältere Bestellungen sie benötigen. Standard: off.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Die Passwörter werden nicht exportiert.

Import: fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Die gespeicherten Passwörter bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Credit Card (Tranzila)). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis After you confirm, you will enter your card details on the secure Tranzila payment page. The order is confirmed once Tranzila confirms the payment. OpenCart legt die Bestellung in diesem Schritt an, weiterhin ohne Status. Wenn der Kunde auf Confirm Order klickt, gelangt er zu einer Zahlungsseite Ihres Shops. Dort öffnet sich die Tranzila-Zahlungsseite in einem iFrame, mit der Bestellsumme in der Bestellwährung, den Rechnungsdaten und einer kurzen Liste der Produkte. Die Seite sagt Enter your card details on the secure Tranzila payment page below. If it does not load, click "Proceed to payment". Unter dem Rahmen befindet sich der Link Choose another payment method. Sind Ratenzahlungen erlaubt, wählt der Kunde die Anzahl auf der Tranzila-Seite. In OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose im Block der Zahlungsarten im Fenster Payment method options und klickt unten auf der Kasse auf Confirm Order.

Jede Anzeige der Zahlungsseite ist ein neuer Zahlungsversuch mit eigenem Token (und eigenem Handshake-Token). Ein Neuladen der Seite öffnet einen neuen Versuch für die Bestellung derselben Kundensitzung; ein in einem anderen Browser geöffneter Link zur Zahlungsseite führt zurück zur Kasse.

Nach einer erfolgreichen Zahlung leitet Tranzila den Kunden zurück, und das ganze Fenster geht weiter. Die Bestellung wird erst als bezahlt markiert, wenn Tranzila die Zahlung per Benachrichtigung bestätigt. Danach erhält die Bestellung ihren Status auf die übliche OpenCart-Art, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung. Wenn eine wartende Bestellung später bezahlt wird, erhält der Kunde die E-Mail über den neuen Bestellstatus. Ist die Benachrichtigung bereits eingegangen, sieht der Kunde die OpenCart-Erfolgsseite mit Your payment with Tranzila has been received. Ist die Bestellung zur Prüfung zurückgehalten, zeigt die Seite Your payment is being reviewed by the store. You will receive an e-mail once it is confirmed. Ist die Benachrichtigung noch nicht eingegangen, zeigt eine Seite Payment confirmation den Text Your payment is being confirmed by Tranzila. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. mit den Schaltflächen Check again und Back to checkout.

Wird die Zahlung abgelehnt oder abgebrochen, kehrt der Kunde mit der Meldung The payment was not completed. You have not been charged — please try again or choose another payment method. zur Kasse zurück. Meldet Tranzila einen Antwortcode, werden der Grund und der Code ergänzt, zum Beispiel dass die Karte abgelaufen ist. Der Warenkorb bleibt erhalten, und die Bestellung bleibt ohne Status. In OpenCart 4 wird diese Meldung oberhalb der Kasse angezeigt. OpenCart 3 legt jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird, OpenCart 4 aktualisiert die Bestellung der Kasse; ein Warenkorb, der bereits durch eine dieser Bestellungen bezahlt wurde, wird nicht erneut belastet. Eine Änderung des Warenkorbs, auch eine neue Menge, gilt als neuer Warenkorb, der eine eigene Zahlung benötigt.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Nach einer abgelehnten Zahlung bezahlt der Kunde dieselbe Bestellung erneut mit einem neuen Zahlungsversuch. Wurde diese Bestellung inzwischen geschlossen (zum Beispiel von Ihnen storniert) oder für einen Warenkorb bezahlt, der sich seitdem geändert hat, wird der Kunde mit This order can no longer be paid. Please confirm your order again. zurück zur Kasse geschickt, und die nächste Confirm Order-Aktion bezahlt eine neue Bestellung.

Kann die Zahlungsseite nicht geöffnet werden, zum Beispiel wenn der Handshake fehlschlägt, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung über dem Button, etwa Could not connect to Tranzila. Please try again in a moment. Der technische Grund wird ins Protokoll geschrieben.

Die Erweiterung unterstützt nur einmalige Kartenzahlungen auf der Tranzila-Seite. Sie hat keine gespeicherten Karten oder Tokens, keine Abonnements, keine getrennte Autorisierung und Erfassung (J5), keine eigenen Schaltflächen für Bit, Apple Pay oder Google Pay (was Ihre Tranzila-Zahlungsseite anbietet, wird im iFrame angezeigt) und keine Tranzila-Rechnungen.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (fehlende Bestellung): Der Kunde wurde zur Zahlungsseite geschickt und hat nicht bezahlt, die Zahlung wurde abgelehnt, oder die Tranzila-Benachrichtigung ist noch nicht eingegangen. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt. In OpenCart 4.1 kann eine solche Bestellung auch den Status Voided haben, den OpenCart setzt, wenn der Bestätigungsschritt erneut angezeigt wird; die Erweiterung zählt sie als Bestellung ohne Status.

Bestellstatus nach der Zahlung (Standard Processing): Die Zahlung wurde durch eine geprüfte Benachrichtigung bestätigt. Eine Notiz zeigt den Betrag, die Tranzila-Transaktion (Index), die Autorisierungsnummer und gegebenenfalls die Anzahl der Raten.

On hold status (Standard Pending): Die Zahlung wurde gemeldet, aber nicht automatisch akzeptiert: Betrag, Währung oder Handshake-Token stimmten nicht überein, die Benachrichtigung konnte nicht geprüft werden, weil Trusted IP leer ist, oder Benachrichtigungen sind aus und der Kunde kam von einer erfolgreichen Zahlungsseite zurück. Die Notiz erklärt den Grund. Prüfen Sie die Zahlung im Tranzila-Terminal und ändern Sie den Status manuell.

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

Geht eine Zahlung für eine Bestellung im Status „zurückgehalten“, „storniert“ oder „Zahlungsfehler“ ein, erhält die Bestellung den Order status after payment; eine stornierte Bestellung erhält zusätzlich eine Notiz, die Sie bittet, den Lagerbestand vor dem Versand zu prüfen. Geht eine zweite Zahlung für eine Bestellung ein, die bereits bezahlt oder erstattet ist, oder für eine andere Bestellung eines bereits bezahlten Warenkorbs, bleibt die Bestellung unverändert. Eine Notiz an der bezahlten Bestellung bittet Sie, sie zu prüfen und das Duplikat im Tranzila-Terminal zu erstatten. Wiederholte Benachrichtigungen zur selben Transaktion werden ignoriert.

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

Reiter VibeFox Tranzila Payment Gateway

Öffnen Sie unter Sales > Orders eine mit Tranzila bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox Tranzila Payment Gateway die Transaction (index), die Authorization, das Terminal, den Status, die Beträge Paid / refunded, die Anzahl der Installments, das Erstattungsformular, den Erstattungsverlauf, alle Payment pages of the cart mit ihrem Ergebnis und die Tranzila notes der Bestellung. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie im Reiter VibeFox Tranzila Payment Gateway den Amount ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via Tranzila. Bestätigen Sie die Abfrage Refund this amount via Tranzila? This cannot be undone. Vollständige und teilweise Erstattungen werden unterstützt. Sie benötigen das Recht, Bestellungen zu ändern (sale/order unter System > Users > User Groups). Die Erstattung erfolgt als Tranzila-Gutschrifttransaktion der ursprünglichen Zahlung über das Terminal, das die Zahlung eingezogen hat, in dem Betrag und der Währung, die Tranzila tatsächlich belastet hat. Nach einer Abweichung bei Betrag oder Währung können Sie daher bis zu dem Betrag erstatten, den der Kunde tatsächlich bezahlt hat, nicht die Bestellsumme.

Das Formular ist verfügbar, wenn das Terminal-Passwort gesetzt ist und die Bestellung eine bestätigte Tranzila-Transaktion hat. Andernfalls nennt der Reiter den Grund, zum Beispiel Refunds need the terminal password (TranzilaPW) in the gateway settings. Eine Bestellung, die auf einem anderen Terminal als dem aktuell eingestellten (zum Beispiel einem Testterminal) bezahlt wurde, kann nicht über die Bestellseite erstattet werden; erstatten Sie sie in diesem Tranzila-Terminal.

Akzeptiert Tranzila die Erstattung nicht, zeigt der Reiter den Fehler, zum Beispiel Tranzila declined the refund mit dem Code und seiner Bedeutung, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird mit der Tranzila-Gutschrifttransaktion dem Erstattungsverlauf und den Notizen hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf Refunded status, ohne den Kunden zu benachrichtigen und ohne Produkte in den Lagerbestand zurückzubuchen, wie bei einer manuellen Statusänderung. Eine teilweise Erstattung ändert den Status nicht.

Produktrücksendungen unter Sales > Returns zahlen über Tranzila kein Geld zurück. Im Tranzila-Terminal vorgenommene Erstattungen werden dem Shop nicht gemeldet. Aktualisieren Sie die Bestellung bei Bedarf manuell.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Tranzila Payment Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Tranzila Payment 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-tranzila 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 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 Tranzila 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 Admin-Bereich im selben Browser angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. In OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Admin-Anmeldung nicht, daher ist die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint im Admin-Dashboard eine Erinnerung. Mit × schließen Sie sie, um sie 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin über die Tranzila-Benachrichtigung und die Rückkehr in den Shop bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, Updates und Support erfordern aber 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 Eingabe des Schlüssels, danach einmal wöchentlich. Ein Cron-Job ist nicht nötig. Das Deinstallieren der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Tranzila erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, Terminal name (supplier) ausgefüllt ist und die Währung des Kunden ILS, USD, EUR oder GBP ist. Die Einstellungsseite zeigt eine Warnung, wenn der Terminalname fehlt oder die Standardwährung nicht unterstützt wird. Prüfen Sie außerdem, ob die Zahlungsadresse in der gewählten Geo Zone liegt und ob die Bestellung die unter Total eingestellte Summe erreicht.

Die Zahlung ist durchgegangen, aber die Bestellung bleibt ohne Status: Die Benachrichtigung ist nicht angekommen oder wurde abgelehnt. Prüfen Sie, ob Notifications eingeschaltet ist und ob Trusted IP die Adressen enthält, von denen Tranzila Benachrichtigungen sendet. Fehler werden immer ins Protokoll geschrieben; sehen Sie im Feld Log auf der Seite der Erweiterung nach. Die Meldung, dass eine IP nicht in der Trusted-IP-Liste steht, bedeutet, dass die Einstellung Trusted IP oder Ihre Proxy-Konfiguration korrigiert werden muss: Hinter einem Proxy oder CDN muss der Webserver die echte Besucher-IP an PHP übergeben. Für Entwickler, deren Shop hinter einem vertrauenswürdigen Reverse-Proxy läuft, löst die Erweiterung das OpenCart-Ereignis wcp_tranzila_payment_gateway/remote_ip aus, um die IP zu setzen.

Die Benachrichtigung antwortet Forbidden: Sie kam von einer IP-Adresse, die nicht in Trusted IP steht.

Die Benachrichtigung antwortet Bad request oder Not found: die Bestellung, das Zahlungsseiten-Token, das Terminal oder der Transaktionsindex in der Benachrichtigung passen zu keiner Zahlungsseite dieses Shops.

Die Benachrichtigung antwortet Accepted for manual review: Trusted IP ist leer, daher konnte die Benachrichtigung nicht überprüft werden. Eine erfolgreiche Zahlung setzt die Bestellung auf „zurückgehalten“. Tragen Sie Trusted IP ein, um Zahlungen automatisch zu bestätigen.

Die Benachrichtigung antwortet Busy, retry: Der Warenkorb wurde im selben Moment von einer anderen Anfrage verarbeitet, oder der Bestellstatus konnte nicht gesetzt werden. Das Protokoll zeigt den Grund. Prüfen Sie die Zahlung im Tranzila-Terminal.

Einige Bestellungen sind im Status „zurückgehalten“: Lesen Sie die Notizen im Reiter VibeFox Tranzila Payment Gateway. Betrag, Währung oder Handshake-Token stimmten nicht überein, oder die Benachrichtigung konnte nicht überprüft werden (Trusted IP leer oder Benachrichtigungen deaktiviert). Prüfen Sie die Zahlung im Tranzila-Terminal und ändern Sie den Status manuell.

Die Zahlungsseite öffnet sich bei eingeschaltetem Handshake nicht: Prüfen Sie den Terminalnamen und das Terminal-Passwort, ob der Handshake im Tranzila-Terminal aktiviert ist und ob die IP-Adresse Ihres Servers dort freigegeben ist. Das Protokoll zeigt den Grund.

Erstattungen schlagen fehl: Erstattungen benötigen das Terminal password (TranzilaPW). Einige Terminals verlangen zusätzlich ein separates Kreditpasswort; tragen Sie es unter Refund password (CreditPass) ein. Bestellungen, die über ein anderes Terminal bezahlt wurden, müssen in diesem Terminal erstattet werden. Ist die Antwort von Tranzila unerwartet, zeigt der Reiter, dass die Erstattung nicht bestätigt wurde: Prüfen Sie das Tranzila-Terminal, bevor Sie es erneut versuchen. Ohne das Recht, Bestellungen zu ändern, zeigt der Reiter You do not have permission to refund orders.

Andere Währungen: Die Erweiterung unterstützt nur ILS, USD, EUR und GBP.

Für Entwickler: Bevor die Zahlungsseite angezeigt wird, löst die Erweiterung das OpenCart-Ereignis wcp_tranzila_payment_gateway/payment_page_params mit den Feldern der Zahlungsseite und der Bestellung aus.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Tranzila Payment Gateway auf Uninstall (die rote −-Schaltfläche). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart entfernt immer seine 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 (in OpenCart 4 auch dessen Ereignisse und die Startaktion, die Benachrichtigung und Rückkehr des Kunden im Wartungsmodus durchlässt). Ist Delete data on uninstall eingeschaltet, werden die übrigen Einstellungen (Titel, Beschreibung, Terminal, Passwörter, Zahlungsseite, Zahlungsbestätigung, Protokollierung) und das Protokoll entfernt. Ist die Option ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die Tranzila-Transaktionen und Erstattungen bleiben immer erhalten, sodass vorher bezahlte Bestellungen nach einer Neuinstallation weiterhin erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Um auch die Dateien der Erweiterung zu entfernen, gehen Sie in OpenCart 4 nach der Deinstallation zu Extensions > Installer und klicken neben VibeFox Tranzila Payment 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.

Tranzila ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist nicht mit Tranzila verbunden und wird von Tranzila weder unterstützt noch empfohlen.