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

Braintree-Konto: Sie benötigen die Merchant ID, den Public Key und den Private Key Ihres Braintree-Kontos. Sie finden sie im Braintree Control Panel (Sandbox: sandbox.braintreegateway.com, Live: www.braintreegateway.com) unter dem Zahnradsymbol, API, API Keys. Sandbox- und Live-Konten haben unterschiedliche Schlüssel. 3-D Secure muss für Ihr Braintree-Händlerkonto aktiviert sein, sofern Sie 3-D Secure nicht auf Disabled setzen. Ein Webhook ist nicht erforderlich: Kartenzahlungen werden sofort bestätigt.

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_braintree_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_braintree_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_braintree_gateway-oc3-(version).ocmod.zip. Die Erweiterung enthält keine OCMOD-Änderungen, 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, wählen Sie den Typ Payments, suchen Sie VibeFox Braintree 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 im Lizenzblock oben auf der Seite in License key ein und klicken Sie auf Activate (siehe Abschnitt Lizenzschlüssel).

4. Kopieren Sie Merchant ID, Public Key und Private Key aus dem Braintree Control Panel in die Felder für Sandbox oder Live.

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Lassen Sie Sandbox mode eingeschaltet und führen Sie eine Testbestellung mit einer Sandbox-Testkarte von Braintree durch, zum Beispiel 4111 1111 1111 1111. Geben Sie danach die Live-Zugangsdaten ein und schalten Sie 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_braintree_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, wählen Sie den Typ Payments, suchen Sie VibeFox Braintree 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 Braintree-Zugangsdaten ein und testen Sie die Zahlung wie in den Schritten 3 bis 5 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich.

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

Konfiguration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Payments > VibeFox Braintree Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Ist die Zahlungsart aktiviert, aber die Merchant ID, der Public Key oder der Private Key der gewählten Umgebung fehlt, warnt die Seite, dass die Zahlungsart an der Kasse ausgeblendet ist, bis diese Angaben ausgefüllt sind. Solange der Sandbox-Modus eingeschaltet ist, zeigt die Seite Sandbox mode is on: test payments, no real money. an. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern muss Title 1 bis 128 Zeichen lang sein, Sort Order muss eine ganze Zahl sein und Total eine Zahl von 0 oder mehr. Enthält ein Feld einen Fehler, wird nichts gespeichert und die Seite nennt das betreffende Feld.

Braintree

Enable/Disable: schaltet Kartenzahlungen über Braintree ein oder aus. Die Zahlungsart wird an der Kasse ausgeblendet, bis Merchant ID, Public Key und Private Key der gewählten Umgebung ausgefüllt sind. Standard: aus.

Title: Der Name der Zahlungsart, den Kunden an der Kasse sehen. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Standard: Credit / debit card. Pflichtfeld, bis zu 128 Zeichen.

Description: Der Text, den der Kunde im Schritt Confirm Order oberhalb des Kartenformulars sieht. Standard: Pay securely with your credit or debit card via Braintree.

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

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

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

API-Zugangsdaten

Melden Sie sich im Braintree Control Panel an (Sandbox oder Live, verlinkt in diesem Abschnitt), klicken Sie auf das Zahnradsymbol und dann auf API und API Keys. Dort sind der Public und der Private Key aufgelistet; die Merchant ID steht auf derselben Seite. Die Seite zeigt nur die Zugangsfelder der gewählten Umgebung; beide Sätze bleiben gespeichert.

Sandbox mode: Nutzt die Braintree-Sandbox (Testzahlungen, kein echtes Geld). Standard: eingeschaltet. Schalten Sie den Modus aus, um mit den Live-Zugangsdaten echte Zahlungen anzunehmen. Erstattungen, Erfassungen und Stornierungen verwenden immer die Umgebung, in der die Bestellung bezahlt wurde. Ist der Modus eingeschaltet, sehen Kunden im Schritt Confirm Order den Hinweis SANDBOX / TEST MODE — no real money is charged.

Sandbox Merchant ID und Live Merchant ID: die Merchant ID des Sandbox- bzw. Live-Kontos.

Sandbox Public Key und Live Public Key: der Public Key des jeweiligen Kontos.

Sandbox Private Key und Live Private Key: der Private Key des jeweiligen Kontos, genau so gespeichert, wie er eingegeben wurde. Gespeicherte Private Keys werden nie erneut angezeigt. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. an. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um einen gespeicherten Schlüssel zu entfernen, aktivieren Sie unter dem Feld Clear the saved key on save und klicken Sie auf Save.

Sandbox merchant account ID(s) und Live merchant account ID(s): optional. Braintree belastet in der Währung des Händlerkontos. Lassen Sie das Feld leer, um Ihr Standard-Händlerkonto zu verwenden, geben Sie eine ID (zum Beispiel mystore_EUR) oder eine ID je Währung ein: EUR=mystore_EUR, USD=mystore_USD. Stimmt die Belastungswährung nicht mit der Bestellwährung überein, wird die Transaktion automatisch storniert und der Kunde nicht belastet.

Payment

Transaction type: wie die Karte belastet wird.

3-D Secure: 3-D Secure 2 (Starke Kundenauthentifizierung, SCA) ist für die meisten Kartenzahlungen im EWR und im Vereinigten Königreich verpflichtend. Es muss außerdem für Ihr Braintree-Konto aktiviert sein (wenden Sie sich an den Braintree-Support, wenn Zahlungen mit einem 3-D-Secure-Konfigurationsfehler fehlschlagen).

Das Ergebnis von 3-D Secure wird serverseitig geprüft, nicht nur im Browser, bevor die Karte belastet wird.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Sie erhält erst einen Status, nachdem Braintree die Kartenzahlung akzeptiert hat. Eine abgelehnte Karte lässt die Bestellung ohne Status, und der Kunde bleibt im Bestätigungsschritt. Jedes der folgenden Felder listet Ihre OpenCart-Bestellstatus auf.

Order Status After Payment: Eine Verkaufszahlung wurde erfasst oder eine Autorisierung auf dem Bestell-Tab erfasst. Standard: In Bearbeitung.

Authorized Status: Nur Autorisierung: Der Betrag ist reserviert, noch nicht bezahlt. Standard: Zahlung ausstehend, da OpenCart keinen Status Wartend kennt; die Bestellnotiz und der Bestell-Tab erklären dies. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

On Hold (Review) Status: Braintree hat einen unerwarteten Transaktionsstatus zurückgegeben, oder der belastete Betrag oder die Währung stimmten nicht überein und die automatische Stornierung ist fehlgeschlagen. Eine Notiz erklärt, was zu prüfen ist. Standard: Zahlung ausstehend.

Voided Status: Die Autorisierung wurde im Bestell-Tab storniert und der gesperrte Betrag freigegeben. Standard: Storniert.

Refunded Status: Die Zahlung ist vollständig erstattet oder vor der Abrechnung als vollständige Erstattung storniert. Teilerstattungen fügen nur eine Notiz hinzu. Standard: Erstattet.

Erweitert

Debug log: Protokolliert zusätzlich API-Aufrufe und Zahlungsschritte in wc_btg_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 aus ist. Das Protokoll enthält nie API-Schlüssel oder Karten- oder Kundendaten. Standard: aus.

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

Delete data on uninstall: Ist die Option eingeschaltet, entfernt das Deinstallieren der Erweiterung die Einstellungen des Gateways und das Protokoll. Braintree-Transaktionen und Erstattungen bleiben immer erhalten, sodass vorher bezahlte Bestellungen nach einer Neuinstallation weiterhin erstattet, erfasst oder storniert werden können. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Private Keys werden nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Gespeicherte Private Keys bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Credit / debit card). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und das Kartenformular von Braintree, das von Braintree in der Sprache des Shops geladen wird. OpenCart legt die Bestellung in diesem Schritt an, noch ohne Status. Wenn der Kunde auf Confirm Order klickt, prüft das Formular die Karte; ist 3-D Secure aktiv, führt der Kunde die Verifizierung seiner Bank durch. Der Bestellbetrag, die E-Mail-Adresse und die Rechnungsadresse werden an das Formular übergeben. Nur ein Einmal-Token erreicht Ihren Shop. In OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose im Block der Zahlungsart, im Fenster Payment method options. Das Kartenformular erscheint dann im Bestätigungsblock am unteren Rand der Kassenseite, oberhalb der Schaltfläche Confirm Order. Fragt der Shop keine Zahlungsadresse ab (der Standard von OpenCart 4), erhält die 3-D-Secure-Prüfung stattdessen die Lieferadresse.

Anschließend belastet die Erweiterung das Token über die Braintree-API mit dem Bestellbetrag in der Bestellwährung; als Bestell-ID wird in Braintree die OpenCart-Bestellnummer verwendet. Der belastete Betrag und die Währung werden mit der Bestellung abgeglichen. Die Bestellung erhält ihren Status erst, wenn Braintree die Zahlung akzeptiert, auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung. Der Warenkorb wird geleert, und der Kunde sieht die OpenCart-Erfolgsseite der Bestellung.

Schlägt die Zahlung fehl, bleibt die Bestellung ohne Status, der Bestellung wird eine Notiz mit dem Grund hinzugefügt, und der Kunde bleibt im Schritt Confirm Order mit einer Meldung, zum Beispiel Your card was declined. Please use another card or contact your bank., 3-D Secure authentication failed. Please try again or use another card. oder The card security code or billing address could not be verified. Please check your details and try again. Der Kunde kann die Karte erneut eingeben und sofort einen weiteren Versuch starten. Stimmt die belastete Währung oder der Betrag nicht mit der Bestellung überein, wird die Transaktion storniert und der Kunde sieht This payment could not be processed in the currency of your order. Your card has not been charged. Please choose another payment method or contact us.

Eine Bestellung wird niemals zweimal belastet. Ein zweites Absenden während die Zahlung läuft, zeigt This order is already being paid. Please wait a moment and check your e-mail before trying again. Eine erneute Bestätigung einer bezahlten Bestellung führt direkt zur Erfolgsseite; bei einer autorisierten Zahlung wird A payment for this order has already been received and is awaiting review. angezeigt. Wurde die Karte belastet, OpenCart konnte aber den Bestellstatus nicht setzen, sieht der Kunde Your payment was received, but the order could not be completed automatically. Please contact us — do not pay again. Der nächste Versuch mit demselben Warenkorb setzt den Status dieser Bestellung anhand der gespeicherten Transaktion, ohne erneut zu belasten. OpenCart 3 legt jedes Mal, wenn der Schritt Confirm Order angezeigt wird, eine neue Bestellung an; ein Warenkorb kann also mehrere Bestellungen haben (OpenCart 4 behält an der Kasse eine einzige Bestellung bei und aktualisiert sie, sodass nach einer abgelehnten Karte dieselbe Bestellung bezahlt wird): sobald eine davon bezahlt ist, wird eine andere Bestellung desselben Warenkorbs nicht belastet, und der Kunde sieht This cart has already been paid with order #…. Please check your order history — do not pay again.

OpenCart 4 behält die Bestellung an der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen vom Shop geschlossen (zum Beispiel abgebrochen, storniert oder erstattet), oder ist sie bereits bezahlt und der Warenkorb hat sich seither geändert (andere Produkte oder Mengen), schickt Confirm Order den Kunden zurück zur Kasse, wodurch eine neue Bestellung des Warenkorbs mit eigener Zahlung entsteht. Derselbe Warenkorb, zweimal abgeschickt, führt weiterhin zur Erfolgsseite, ohne zweite Belastung.

Die Erweiterung nimmt nur Kartenzahlungen an. Sie unterstützt keine gespeicherten Karten, keine Abonnements oder wiederkehrenden Zahlungen, kein PayPal, Venmo, Apple Pay, Google Pay oder lokale Zahlungsarten und keine Braintree-Webhooks.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (fehlende Bestellung): Die Zahlung wurde nicht getätigt oder abgelehnt. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Order Status After Payment (Standard Processing): Die Karte wurde belastet (Sale) oder eine Autorisierung wurde erfasst. Eine Notiz zeigt den Betrag, die Braintree-Transaktions-ID und das Ergebnis von 3-D Secure.

Authorized Status (Standard Pending): Die Mittel sind nur autorisiert (Authorize only). Eine Notiz fordert Sie auf, die Zahlung vor dem Versand auf der Bestellseite zu erfassen.

On Hold (Review) Status (Standard Pending): Braintree hat einen unerwarteten Transaktionsstatus zurückgegeben, oder eine Belastung mit falscher Währung oder falschem Betrag konnte nicht automatisch storniert werden. Die Notiz erklärt, was im Braintree Control Panel zu prüfen ist.

Voided Status (Standard Canceled): Eine Autorisierung wurde storniert.

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

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

Tab VibeFox Braintree Gateway

Öffnen Sie unter Sales > Orders eine mit Braintree bezahlte Bestellung. Am unteren Rand der Bestellseite, neben History und Additional, zeigt der Tab VibeFox Braintree Gateway die Transaction ID (verlinkt mit der Transaktion im Braintree Control Panel der jeweiligen Umgebung), bei Sandbox-Zahlungen mit dem Hinweis Sandbox, den Transaktions-Status, den Amount und das Händlerkonto, das Ergebnis von 3-D Secure, die Beträge Charged / refunded, die Schaltflächen für Erfassung, Stornierung und Erstattung, den Erstattungsverlauf und die Braintree notes der Bestellung. Der Tab wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben; die Schaltflächen benötigen das Recht, sie zu ändern (festgelegt unter System > Users > User Groups).

Erfassung und Stornierung

Bei einer autorisierten Zahlung klicken Sie auf Capture Braintree payment, um den Bestellbetrag zu belasten, oder auf Void Braintree authorization, um den gesperrten Betrag freizugeben und die Bestellung zu stornieren. Die Erfassung setzt die Bestellung auf Order Status After Payment; die Stornierung setzt sie auf Voided Status. Schlägt die Aktion fehl, wird der Fehler im Tab angezeigt und den Bestellnotizen hinzugefügt.

Erstattungen

Geben Sie im Tab VibeFox Braintree Gateway den Amount ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via Braintree. Bestätigen Sie die Abfrage Diesen Betrag über Braintree erstatten? Dies kann nicht rückgängig gemacht werden. Vollständige und teilweise Erstattungen werden unterstützt, sowohl für eine erfasste Zahlung als auch für eine Zahlung in Prüfung. Erstattungen erfolgen in dem Betrag und in der Währung, die Braintree belastet hat. Braintree erstattet nur abgerechnete Transaktionen, in der Regel innerhalb von 24 Stunden. Vor der Abrechnung wird eine vollständige Erstattung als Stornierung ausgeführt; eine Teilerstattung schlägt dann mit der Meldung fehl, auf die Abrechnung zu warten. Die Erstattung wird an die Umgebung (Sandbox oder Live) der Zahlung gesendet, daher müssen die Zugangsdaten dieser Umgebung hinterlegt sein. Akzeptiert Braintree die Erstattung nicht, zeigt der Tab den Fehler an und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird dem Erstattungsverlauf und den Notizen hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf Refunded Status; eine Teilerstattung ändert den Status nicht. Statusänderungen aus dem Tab benachrichtigen den Kunden nicht und buchen Produkte nicht in den Bestand zurück, wie eine manuelle Statusänderung.

Produktrücksendungen unter Sales > Returns erstatten kein Geld über Braintree. Chargebacks, abgelehnte Abrechnungen und Erstattungen, die im Braintree Control Panel vorgenommen werden, werden nicht mit OpenCart synchronisiert.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Braintree Gateway ist der erste Block auf Extensions > Extensions > Payments > VibeFox Braintree 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 Schlüssel maskiert, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig ist, und Ihre Domain) sowie die Schaltflächen Check now zum erneuten Prüfen des Status, 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-braintree 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 Schlüssel nicht gefunden, Dieser Schlüssel gehört zu einem anderen Produkt, Domainlimit erreicht oder Lizenz abgelaufen am 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 Braintree Kunden an der Kasse nicht angezeigt. Wird dennoch 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, gekennzeichnet mit (unlicensed — visible to admins only), damit Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. Bei OpenCart 4 steht diese Vorschau nicht zur Verfügung: 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 eine Erinnerung auf dem Dashboard im Admin. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen bleiben unberührt: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erfassungen, Stornierungen und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, Updates und Support benötigen jedoch eine Verlängerung. Der Status wird beim Öffnen des Dashboard im Admin oder der Seite Edit automatisch erneut geprüft: 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 immer der Lizenzschlüssel und der Lizenzstatus entfernt.

Fehlerbehebung

Braintree erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die gewählte Umgebung eine Merchant ID, einen Public Key und einen Private Key hat. Die Einstellungsseite zeigt eine Warnung, wenn ein Schlüssel fehlt. Prüfen Sie außerdem, ob die Rechnungsadresse in der gewählten Geo Zone liegt und die Bestellung den in den Einstellungen festgelegten Total erreicht.

Die Karte wurde belastet, aber die Bestellung bleibt ohne Status: Kartenzahlungen werden sofort bestätigt, ohne Webhook. Sehen Sie sich die Notizen der Bestellung und das Feld Log auf der Erweiterungsseite an. Wenn eine Notiz besagt, dass die Antwort von Braintree verloren ging, prüfen Sie im Braintree Control Panel, ob es eine Transaktion mit dieser Bestellnummer gibt, bevor Sie eine weitere Zahlung akzeptieren. Konnte der Status nach der Belastung nicht gesetzt werden, setzt der nächste Zahlungsversuch mit demselben Warenkorb ihn, ohne erneut zu belasten.

Das Kartenformular zeigt Could not initialize payment form: Die Schlüssel der gewählten Umgebung sind falsch, oder die Händlerkonto-ID existiert in diesem Konto nicht. Prüfen Sie die Schlüssel und die Händlerkonto-IDs und laden Sie die Seite neu.

Der Kunde sieht Your session has expired. Please refresh the page and try again.: Die Kassensitzung hat sich geändert, während das Formular geöffnet war. Der Kunde lädt die Kassenseite neu.

3-D Secure schlägt bei jeder Zahlung fehl: 3-D Secure muss für Ihr Braintree-Händlerkonto aktiviert sein. Wenden Sie sich an den Braintree-Support oder setzen Sie 3-D Secure auf Disabled (nicht empfohlen im EWR und im Vereinigten Königreich, wo SCA verpflichtend ist).

Dem Kunden wird mitgeteilt, dass die Zahlung in der Währung der Bestellung nicht verarbeitet werden konnte: Braintree hat in der Währung des Händlerkontos belastet. Geben Sie die Händlerkonto-ID für die Bestellwährung im Feld Händlerkonto der aktuellen Umgebung ein.

Der Kunde sieht The order total must be greater than zero to pay by card.: Der Bestellbetrag ist null, zum Beispiel nach einem Gutschein. Solche Bestellungen können nicht per Karte bezahlt werden.

Eine Teilerstattung schlägt direkt nach der Zahlung fehl: Braintree kann nur abgerechnete Transaktionen erstatten, in der Regel innerhalb von 24 Stunden. Erstatten Sie den vollen Betrag, um die Transaktion jetzt zu stornieren, oder führen Sie die Teilerstattung nach der Abrechnung durch.

Keine Schaltflächen im Tab oder eine Meldung zur Umgebung: Ihre Benutzergruppe hat kein Recht, die Erweiterung zu ändern, oder die Zahlung wurde in der Sandbox- bzw. Live-Umgebung getätigt, und deren Zugangsdaten sind nicht hinterlegt. Geben Sie sie ein und versuchen Sie es erneut.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Braintree Gateway auf Uninstall (die rote −-Schaltfläche). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart entfernt außerdem immer die eigenen Einstellungen der Erweiterung: Enable/Disable, Sort Order, Geo Zone, Total und die Bestellstatus des Abschnitts Orders, die bei einer erneuten Installation auf ihre Standardwerte zurückgesetzt werden. Ist Delete data on uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Sandbox-Modus, Zugangsdaten, Händlerkonten, Transaktionstyp, 3-D Secure, Debug-Protokoll) und das Protokoll entfernt. Ist die Option ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die Braintree-Transaktionen und Erstattungen bleiben immer erhalten, sodass vorher bezahlte Bestellungen nach einer Neuinstallation weiterhin erstattet, erfasst oder storniert 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 Braintree Gateway auf Uninstall (der orangefarbene −-Button) und danach auf Delete (der rote Papierkorb-Button), um das hochgeladene Paket zu entfernen.

Braintree ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung steht in keiner Verbindung zu Braintree und wird von Braintree weder unterstützt noch empfohlen.