VibeFox Transbank 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: Chilenischer Peso (CLP). Fügen Sie ihn unter System > Localisation > Currencies hinzu, falls Ihr Shop ihn nicht hat, mit 0 Dezimalstellen: Webpay Plus berechnet nur ganze Pesos. Bei Bestellungen in einer anderen Währung wird die Zahlungsart nicht angezeigt.

Transbank-Konto: für Live-Zahlungen benötigen Sie eine Standard-Webpay-Plus-Händlerkennung (sofortige Erfassung) mit ihrem Live-Commerce Code und ihrem API Key Secret. Transbank stellt Ihnen den Commerce Code bereit, sobald Ihre Anbindung genehmigt ist, und das API Key Secret nach dem Validierungsprozess der Integration (siehe die Entwicklerdokumentation von Transbank). Für Tests sind keine Zugangsdaten nötig. Commerce Codes für Webpay Plus Mall, Oneclick und verzögerte Erfassung werden nicht unterstützt.

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_transbank_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_transbank_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_transbank_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 Transbank 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. Aktivieren Sie Enable / Disable und klicken Sie auf Save. Testen Sie eine Zahlung in CLP mit eingeschaltetem Integration (test) mode und den Testkarten aus der Entwicklerdokumentation von Transbank.

5. Um live zu gehen, geben Sie Ihren Production Commerce Code und Ihr Production API Key Secret ein, schalten Sie Integration (test) mode aus 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_transbank_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 Transbank 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 Einstellungen ein wie in den Schritten 3 bis 5 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Rücksprung-URL ist anders (siehe Rücksprung-URL).

Bei Transbank müssen keine Rücksprung-URL und kein Webhook eingerichtet werden. Die Erweiterung sendet ihre Rücksprung-URL bei jeder Transaktion mit. Eine neue Installation startet mit deaktivierter Zahlungsart und eingeschaltetem Integrationsmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Transbank 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 die Produktion ausgewählt ist, aber der Live-Commerce Code oder der API Key fehlt oder ungültig ist (Webpay wird dann an der Kasse ausgeblendet), wenn die Standardwährung des Shops nicht CLP ist (die Zahlungsart wird dann für andere Währungen ausgeblendet) und wenn CLP Dezimalstellen hat (Summen werden auf ganze Pesos gerundet). Solange der Integrationsmodus eingeschaltet ist, zeigt die Seite an, dass Zahlungen an die Integrationsumgebung von Transbank mit dem öffentlichen Test-Commerce-Code gehen und dass kein echtes Geld abgebucht wird. 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, 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 und die Seite zeigt den Fehler an.

Transbank Webpay Plus

Enable / Disable: Enable Transbank Webpay Plus payments schaltet die Zahlungsart ein oder aus. Standard: off.

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

Description: der Text, den der Kunde im Schritt Confirm Order über der Bestätigungsschaltfläche sieht. Standard: Pay with credit, debit or prepaid card via Webpay.

Sort Order: die Position von Webpay 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 Webpay 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 Webpay angeboten wird. Lassen Sie das Feld leer, um Webpay bei jeder Summe anzubieten.

Umgebung und Zugangsdaten

Der Abschnittstext verlinkt auf die Entwicklerdokumentation von Transbank und erklärt, wann Transbank Ihnen die Live-Zugangsdaten bereitstellt.

Integration (test) mode: Zahlungen gehen an die Integrationsumgebung von Transbank mit ihrem öffentlichen Test-Commerce-Code (597055555532), der automatisch verwendet wird. Die unten stehenden Live-Zugangsdaten werden nicht verwendet, und es wird kein echtes Geld abgebucht. Standard: on. Schalten Sie ihn aus, um live zu gehen. Solange er eingeschaltet ist, sehen Kunden TEST MODE — Integrationsumgebung. Keine echten Abbuchungen. im Schritt Confirm Order.

Production Commerce Code: Ihr Live-Commerce-Code (Tbk-Api-Key-Id): 12 Ziffern, beginnend mit 5970. Wenn Ihrer 8 Ziffern hat, geben Sie ihn unverändert ein; das Präfix 5970 wird beim Speichern ergänzt. Leerzeichen und andere Zeichen werden entfernt. Die öffentlichen Test-Commerce-Codes von Transbank funktionieren nicht im Live-Betrieb: Mit einem davon bleibt Webpay an der Kasse ausgeblendet.

Production API Key Secret: das Tbk-Api-Key-Secret Ihres Live-Commerce. Halten Sie es geheim. Leerzeichen werden beim Speichern entfernt. Ein gespeicherter Schlüssel wird 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 den gespeicherten Schlüssel zu entfernen, setzen Sie den Haken bei Clear saved API key und klicken Sie auf Save.

Integration (test) mode legt fest, wohin neue Zahlungen gehen. Jede Zahlung merkt sich ihre Umgebung: Die Bestätigung und die Erstattungen einer Zahlung gehen immer an die Umgebung (Integration oder Live) und mit den Zugangsdaten, mit denen sie erstellt wurde, auch wenn Sie den Modus später umstellen.

Rücksprung-URL

Return from Webpay: die Adresse, an die Transbank den Kunden zurückschickt, zur Information angezeigt. Bei OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_transbank_gateway/back, bei OpenCart 4 so: https://your-store/index.php?route=extension/wcp_transbank_gateway/payment/wcp_transbank_gateway.back. Bei Transbank muss nichts eingerichtet werden: Die Erweiterung sendet diese URL bei jeder Transaktion mit (Transbank hat kein Webhook: Die Zahlung wird bestätigt, wenn der Kunde zurückkehrt). Sie muss aus dem Internet erreichbar sein; der Wartungsmodus blockiert sie nicht (bei OpenCart 4 fügt die Erweiterung dafür eine Startaktion hinzu).

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält erst dann einen Status, wenn der Shop die Transaktion bei Transbank bestätigt hat (Commit), sobald der Kunde von Webpay zurückkehrt. Jedes der folgenden Felder listet Ihre OpenCart-Bestellstatus auf.

Order Status After Payment: der Status, der nach einer genehmigten und geprüften Webpay-Zahlung gesetzt wird. Standard: Processing.

Transbank Payment On Hold Status: Transbank hat eine Zahlung autorisiert, die nicht zur Bestellung passt (Betrag, Buy Order, Session-ID): Die Bestellung wird zur manuellen Prüfung zurückgehalten, und eine Notiz erklärt den Grund. Standard: Pending, weil OpenCart keinen Status On hold hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

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

Erweitert

Debug log: protokolliert API-Anfragen und Rückmeldungen in wc_tbk_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei lässt sich nicht über das Web öffnen. Fehler werden immer protokolliert, auch wenn diese Option ausgeschaltet ist. Es werden keine Kartendaten, API-Schlüssel oder vollständigen Tokens protokolliert. 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 Gateway-Einstellungen und das Protokoll. Bestell- und Zahlungsdaten bleiben immer erhalten. Standard: off.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Das API Key Secret wird nicht exportiert.

Import: fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Der gespeicherte API-Schlüssel bleibt erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Webpay Plus). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will be redirected to Webpay (Transbank) to complete the payment. OpenCart legt die Bestellung in diesem Schritt an, weiterhin ohne Status. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine Transbank-Transaktion über die Bestellsumme in ganzen Pesos (eine Summe mit Dezimalstellen wird auf den nächsten Peso gerundet), und der Kunde gelangt direkt zum Webpay-Formular, wo er mit Kredit-, Debit- oder Prepaid-Karte bezahlt. 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.

Wenn der Kunde zurückkehrt, bestätigt die Erweiterung (Commit) die Transaktion serverseitig bei Transbank. Die Bestellung wird erst als bezahlt markiert, nachdem Transbank die Zahlung bestätigt hat: Die Antwort muss genehmigt sein, und Betrag, Buy Order und Session müssen mit dem übereinstimmen, was der Shop für diesen Versuch gesendet hat. Danach erhält die Bestellung ihren Status auf die übliche OpenCart-Art, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung mit Your Webpay payment has been received. Bei einer Bestellung in Prüfung zeigt die Seite Your Webpay payment was received and is being reviewed by the store.

Schlägt der Bestätigungsaufruf fehl, zum Beispiel durch eine Zeitüberschreitung (Timeout), fragt die Erweiterung bei Transbank den Status der Transaktion ab. Lässt sich der Status immer noch nicht ermitteln, bleibt die Bestellung ohne Status, und der Kunde kehrt zur Kasse zurück mit We could not confirm your Webpay payment with Transbank. Please try again in a moment; if your card was charged, contact us before paying again. Bestätigt gerade eine andere Anfrage denselben Warenkorb oder hat Transbank die Zahlung genehmigt, der Bestellstatus konnte aber noch nicht gesetzt werden, sieht der Kunde eine Seite Payment confirmation mit Your Webpay payment is being confirmed. Please do not pay again — check again in a moment. und den Schaltflächen Check again und Back to checkout. Der Status wird dann aus der gespeicherten Antwort gesetzt, ohne eine zweite Bestätigung.

Bricht der Kunde bei Webpay ab, oder läuft das Webpay-Formular ab oder meldet einen Fehler, wird nichts abgebucht. Der Kunde kehrt mit einer Meldung zur Kasse zurück, zum Beispiel You cancelled the Webpay payment. Nothing was charged — you can try again or choose another payment method. Eine abgelehnte Karte zeigt Your Webpay payment was rejected and nothing was charged. Please try again or choose another payment method. Der Warenkorb bleibt erhalten, und jeder neue Versuch ist eine neue Webpay-Transaktion. Bei OpenCart 4 werden diese Meldungen oberhalb der Kassenseite angezeigt.

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, sodass der Kunde nach einer abgebrochenen oder abgelehnten Zahlung dieselbe Bestellung mit einer neuen Webpay-Transaktion bezahlt. Hat sich die Bestellung nach dem Start der Zahlung geändert (Währung oder Summe stimmen nicht mehr mit der Transaktion überein), wird die Transaktion nicht bestätigt, daher berechnet Transbank sie nicht, und der Kunde sieht Your order changed after the Webpay payment was started. The payment was not confirmed, so it was not charged — please pay again. Hat die Bestellung bereits einen Status oder ist eine andere Bestellung desselben Warenkorbs schon bezahlt, wird auch eine verspätete Rücksendung nicht bestätigt: Der Kunde gelangt zur Erfolgsseite der bezahlten Bestellung oder sieht This order can no longer be paid (it was cancelled or already paid). Your Webpay payment was not confirmed, so it was not charged.

Bei OpenCart 4 schickt das nächste Confirm Order den Kunden mit derselben Meldung zurück zur Kasse, wenn die Bestellung der Kasse einen Status ohne Webpay-Zahlung erhalten hat oder der Shop sie inzwischen geschlossen hat, und der Warenkorb wird mit einer neuen Bestellung bezahlt. Ist die Bestellung der Kasse bereits bezahlt, der Warenkorb seitdem aber geändert, einschließlich einer neuen Menge, wird der Kunde zur Kasse zurückgeschickt, und der neue Warenkorb wird mit einer neuen Bestellung bezahlt.

Kann Webpay die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung, zum Beispiel Could not connect to Webpay. Please try again in a moment. oder Webpay could not start the payment. Please try again or choose another payment method. Der technische Grund wird ins Protokoll geschrieben.

Transbank hat kein Zahlungs-Webhook: Das Ergebnis wird verarbeitet, wenn der Kunde von Webpay zurückkehrt. Schließt der Kunde den Browser bei Webpay und kehrt nie zurück, wird die Transaktion nicht bestätigt, und die Bestellung bleibt ohne Status; laut Transbank werden unbestätigte Transaktionen nicht abgerechnet. Die Erweiterung unterstützt kein Webpay Plus Mall, keine gespeicherten Oneclick-Karten, keine Abonnements, keine verzögerte Erfassung und keine Währungsumrechnung.

Bestellungen und Erstattungen

Bestellstatus

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

Order Status After Payment (Standard Processing): Transbank hat die Zahlung genehmigt. Eine Notiz zeigt den Autorisierungscode, die letzten vier Kartenziffern, die Buy Order, den Betrag, die Zahlungsart und die Anzahl der Raten.

Transbank Payment On Hold Status (Standard Pending): Transbank hat eine Zahlung autorisiert, die nicht zur Bestellung passt (Betrag, Buy Order oder Session). Die Notiz listet die Abweichungen auf. Prüfen Sie das Transbank-Portal und erfüllen Sie die Bestellung oder erstatten Sie die Zahlung.

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

Gibt Webpay eine Zahlung für eine Bestellung zurück, die bereits einen Status hat, oder für einen Warenkorb, den eine andere Bestellung schon bezahlt hat, wird die Zahlung nicht bestätigt, und eine Notiz bittet Sie, das Transbank-Portal zu prüfen, falls der Kunde von einer Abbuchung berichtet. Abbrüche, abgelaufene Formulare, Formularfehler und abgelehnte Karten werden ebenfalls vermerkt. Notizen sind Einträge im History der Bestellung, die der Kunde nicht sieht.

Reiter VibeFox Transbank Gateway

Öffnen Sie unter Sales > Orders eine mit Webpay bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox Transbank Gateway die Buy order und ihre Umgebung (ein Etikett Integration für Testzahlungen), den Status der Zahlung, den Authorization code, den Card / payment type mit der Anzahl der Raten, Charged / refunded, das Erstattungsformular, den Erstattungsverlauf, die Webpay attempts of the order und die Transbank notes. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie im Reiter den Amount in CLP ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via Transbank. Bestätigen Sie die Abfrage Refund this amount via Transbank? Vollständige und teilweise Erstattungen werden in ganzen Pesos unterstützt. Sie benötigen das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups). Ein Teilbetrag mit Dezimalstellen wird mit Webpay refunds are in whole Chilean pesos. Please enter an amount without decimals. abgelehnt. Ein verbleibender Rest einer Summe mit Dezimalstellen wird wie die Abbuchung gerundet. Erstattungen erfolgen bis zu dem Betrag, den Transbank abgebucht hat. Die Erstattung geht an die Umgebung, in der die Zahlung erfolgte; für eine Live-Zahlung müssen daher die Live-Zugangsdaten gespeichert sein.

Transbank antwortet mit einer Rückbuchung (REVERSED) oder einer Annullierung (NULLIFIED). Eine erfolgreiche Erstattung wird mit Betrag, Typ, Autorisierungscode und dem Restguthaben bei Transbank dem Erstattungsverlauf und den Notizen hinzugefügt. Eine vollständige Erstattung setzt den 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. Akzeptiert Transbank die Erstattung nicht, zeigt der Reiter den Fehler, und es wird keine Erstattung erfasst.

Produktrücksendungen unter Sales > Returns geben kein Geld über Transbank zurück. Im Transbank-Portal vorgenommene Erstattungen werden nicht in OpenCart übernommen.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Transbank Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Transbank 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-transbank 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 Webpay Plus 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. Bei OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Anmeldung im Admin nicht, daher wird ohne aktiven Schlüssel die Zahlungsart 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 bestätigt, wenn der Kunde von Webpay zurückkehrt, und Erstattungen von der Bestellseite 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

Webpay Plus erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable / Disable eingeschaltet ist, der Kunde in CLP bezahlt und bei ausgeschaltetem Integrationsmodus ein gültiger Production Commerce Code (12 Ziffern, beginnend mit 5970) sowie ein Production API Key Secret gespeichert sind. 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 Einstellungsseite zeigt eine Warnung bei fehlenden Zugangsdaten und bei einer Shop-Währung ungleich CLP.

Die Zahlung ist durchgegangen, aber die Bestellung bleibt ohne Status: Transbank hat kein Webhook, daher erhält die Bestellung ihren Status erst, wenn der Kunde von Webpay zurückkehrt. Hat der Kunde den Browser bei Webpay geschlossen, wurde die Transaktion nicht bestätigt und wird laut Transbank nicht abgerechnet. Schalten Sie Debug log ein, sehen Sie im Feld Log nach und prüfen Sie die Transaktion im Transbank-Portal.

Der Kunde sieht We could not confirm your Webpay payment with Transbank: Der Bestätigungsaufruf ist fehlgeschlagen, und der Status konnte nicht geprüft werden. Die Bestellung wurde nicht verändert, der Grund steht im Protokoll. Der Kunde kann es in einem Moment erneut versuchen. Zeigt das Transbank-Portal die Transaktion als autorisiert, sprechen Sie den Kunden an, bevor er erneut bezahlt.

Der Kunde sieht Your order changed after the Webpay payment was started: Die Bestellsumme oder die Währung wich von der Transaktion ab. Es wurde nichts abgebucht; der Kunde bezahlt erneut.

Der Kunde sieht einen Fehler nach Confirm Order: Schalten Sie Debug log ein und sehen Sie im Feld Log auf der Seite der Erweiterung nach. Webpay payments are not available at the moment bedeutet meist falsche Live-Zugangsdaten. Could not connect to Webpay bedeutet, dass Transbank nicht erreicht werden konnte. Transbank Webpay only supports payments in CLP (Chilean Peso) bedeutet, dass die Bestellung in einer anderen Währung ist. This payment method is not available. Please reload the checkout page. bedeutet, dass die Kassensitzung nicht mehr zur Bestellung passt: Der Kunde lädt die Kasse neu.

Summen und Erstattungen weichen um wenige Pesos ab: Die Währung CLP hat Dezimalstellen. Webpay berechnet ganze Pesos, daher werden Summen gerundet. Setzen Sie die Dezimalstellen von CLP unter System > Localisation > Currencies auf 0.

Bestellung nach der Zahlung im Prüfstatus: Lesen Sie die Notizen im Reiter VibeFox Transbank Gateway (siehe Bestellstatus) und erfüllen Sie danach die Bestellung oder erstatten Sie die Zahlung.

Erstattung schlägt fehl mit The production Commerce Code / API Key are missing: Die Zahlung wurde live getätigt, und die Live-Zugangsdaten sind nicht gespeichert. Geben Sie sie ein und versuchen Sie es erneut.

Erstattung schlägt fehl mit Transbank refused the refund oder Transbank did not approve the refund: Transbank hat sie nicht akzeptiert; die Meldung zeigt den Grund bzw. den Typ und den Antwortcode, den Transbank zurückgegeben hat. Es wurde nichts erstattet. Prüfen Sie die Transaktion im Transbank-Portal.

Erstattung schlägt fehl mit Another request is processing this order: Die Bestellung wurde im selben Moment erstattet oder bestätigt. Versuchen Sie es in einem Moment erneut.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Transbank 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 (bei OpenCart 4 seine Events und seine Startaktion, die die Rückkehr von Webpay im Wartungsmodus durchlässt). Ist Delete data on uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Integrationsmodus, Zugangsdaten, Schalter des Debug-Protokolls) und das Protokoll entfernt. Ist die Option ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die Webpay-Versuche und Erstattungen der Bestellungen bleiben immer erhalten, sodass vorher bezahlte Bestellungen nach einer Neuinstallation weiterhin erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

Transbank und Webpay sind Marken ihrer jeweiligen Inhaber. Diese Erweiterung ist nicht mit Transbank verbunden und wird von Transbank weder unterstützt noch empfohlen.