VibeFox Authorize.Net 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.

HTTPS: Ihre Kasse muss HTTPS verwenden. Accept.js startet nicht auf reinen HTTP-Seiten.

Authorize.Net-Konto: Sie benötigen die API Login ID, den Transaction Key und den Public Client Key Ihres Authorize.Net-Kontos sowie einen Signature Key, wenn Sie Webhooks verwenden. Live-Konten (account.authorize.net) und Sandbox-Konten (sandbox.authorize.net) haben unterschiedliche Zugangsdaten. Authorize.Net-Konten stehen Händlern in den USA, Kanada, dem Vereinigten Königreich, Europa, Australien und Neuseeland zur Verfügung.

Währung: Die Bestellwährung muss USD, CAD, CHF, DKK, EUR, GBP, NOK, PLN, SEK, AUD oder NZD sein, und Ihr Authorize.Net-Konto muss in dieser Währung abrechnen. Bei anderen Währungen wird die Zahlungsart in der Kasse ausgeblendet.

VibeFox-Lizenzschlüssel: Erhältlich auf vibefox.net. Ein Schlüssel funktioniert auf einer Domain.

Installation

Der Download ist eine ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das Paket für OpenCart 3 wcp_authorizenet_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_authorizenet_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_authorizenet_gateway-oc3-(version).ocmod.zip. Die Erweiterung enthält keine OCMOD-Modifikationen, daher muss Extensions > Modifications nicht aktualisiert werden. Statt über den Installer können Sie auch den Inhalt des Ordners upload aus dem Archiv in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox Authorize.Net Gateway und klicken Sie auf Install (der grüne +-Button). Ihr Admin-Benutzer benötigt das Recht, die Liste der Zahlungserweiterungen zu bearbeiten.

3. Klicken Sie auf Edit (der Stift-Button), um die Einstellungsseite zu öffnen. Fügen Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite in das Feld License key ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. Geben Sie die Zugangsdaten der Sandbox- und der Live-Konten ein (siehe Konfiguration). Optional richten Sie den Webhook ein.

5. Aktivieren Sie Enable/Disable, wählen Sie den Transaction type und klicken Sie auf Save. Testen Sie eine Zahlung im Sandbox-Modus mit der Karte 4111 1111 1111 1111, einem beliebigen zukünftigen Ablaufdatum und einer beliebigen CVV, und deaktivieren Sie danach Sandbox mode.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_authorizenet_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 (der grüne +-Button).

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

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

Eine neue Installation startet mit deaktivierter Zahlungsart und aktiviertem Sandbox-Modus.

Konfiguration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Payments > VibeFox Authorize.Net Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt die Seite, wenn der Shop kein HTTPS verwendet (Accept.js funktioniert nur auf HTTPS-Seiten), wenn die Standardwährung des Shops von Authorize.Net nicht unterstützt wird, wenn im aktuellen Modus keine API Login ID, kein Transaction Key oder kein Public Client Key hinterlegt ist (dann wird die Zahlungsart in der Kasse ausgeblendet) und wenn im aktuellen Modus kein Signature Key hinterlegt ist (dann sind Webhooks deaktiviert). Solange der Sandbox-Modus aktiv ist, zeigt sie Sandbox mode is on: test transactions, no real charges. an. Ohne das Recht, die Erweiterung zu bearbeiten, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern muss Title 1 bis 128 Zeichen lang sein, Transaction type muss einer der beiden Optionen entsprechen, Sort Order muss eine ganze Zahl sein, Total muss eine Zahl von 0 oder größer sein, und die Geo Zone sowie die Bestellstatus müssen vorhanden sein. Ist ein Feld fehlerhaft, wird nichts gespeichert und die Seite nennt das Feld.

Authorize.Net

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

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

Description: der Text, den der Kunde im Schritt Confirm Order über dem Kartenformular sieht. Standard: Pay securely with your credit card via Authorize.Net.

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

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

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

API credentials

Öffnen Sie im Authorize.Net Merchant Interface Account > Settings > Security Settings. Kopieren Sie unter API Credentials & Keys die API Login ID und erstellen Sie einen Transaction Key und einen Signature Key. Kopieren Sie unter Manage Public Client Key den Public Client Key. Sandbox und Live verwenden unterschiedliche Zugangsdaten. Der Abschnitt zeigt die Felder beider Modi, sodass Sie beide Sätze speichern können.

Sandbox mode: verwendet die Authorize.Net-Sandbox (Testtransaktionen, keine echten Belastungen). Er schaltet den API-Endpunkt, Accept.js und den Satz der Zugangsdaten für neue Zahlungen um. Standard: aktiviert. Deaktivieren Sie ihn, um echte Zahlungen anzunehmen. Solange er aktiv ist, sehen Kunden Sandbox mode: mit der Testkarte 4111 1111 1111 1111 über dem Kartenformular.

Sandbox API Login ID und Live API Login ID: die API Login ID des Sandbox- bzw. Live-Kontos.

Sandbox Transaction Key und Live Transaction Key: der Transaction Key dieses Kontos.

Sandbox Public Client Key und Live Public Client Key: der öffentliche Schlüssel, den Accept.js im Browser verwendet.

Sandbox Signature Key und Live Signature Key: nur für Webhooks erforderlich. Er prüft den Header X-ANET-Signature jeder Benachrichtigung.

Gespeicherte Transaction Keys und Signature Keys werden nie wieder 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, setzen Sie unter dem Feld den Haken bei Clear the saved value on save und klicken Sie auf Save.

Payment

Transaction type: legt fest, wie die Karte belastet wird. Eine Autorisierung läuft nach 30 Tagen ab.

Webhooks (recommended)

Ohne Webhooks müssen Bestellungen, die von der Fraud Detection Suite zurückgehalten werden, oder Bestellungen, die im Authorize.Net-Panel erfasst oder storniert werden, manuell aktualisiert werden. Gehen Sie im Merchant Interface zu Account > Settings > Business Settings > Webhooks und klicken Sie auf Add Endpoint, sowohl im Sandbox- als auch im Live-Konto. Verwenden Sie die URL, die in diesem Abschnitt unter Endpoint URL angezeigt wird. Auf OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_authorizenet_gateway/webhook, auf OpenCart 4 so: https://your-store/index.php?route=extension/wcp_authorizenet_gateway/payment/wcp_authorizenet_gateway.webhook. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet. Kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen. Wählen Sie diese Ereignisse aus (sie sind ebenfalls in diesem Abschnitt aufgeführt):

Tragen Sie den Signature Key jedes Kontos in Sandbox Signature Key bzw. Live Signature Key ein. Webhooks ohne gültige Signatur werden abgewiesen. Eine Benachrichtigung muss mit dem Schlüssel des Modus signiert sein, in dem die Zahlung erfolgt ist; eine Benachrichtigung des anderen Modus ändert nichts. Für jede Benachrichtigung fragt die Erweiterung vor einer Änderung der Bestellung bei Authorize.Net außerdem den aktuellen Status und Betrag der Transaktion ab, sodass wiederholte Benachrichtigungen nichts verändern. Der Webhook funktioniert auch, wenn der Shop im Wartungsmodus ist, weil OpenCart Anfragen von Zahlungserweiterungen durchlässt.

Orders

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Sie erhält erst dann einen Status, wenn Authorize.Net für die Karte geantwortet hat. Jedes der folgenden Felder listet Ihre Bestellstatus aus OpenCart auf.

Order Status After Payment: die Karte wurde belastet (Authorize and capture oder eine spätere Erfassung). Standard: Processing.

Authorized Status: Authorize only: die Mittel sind reserviert, aber noch nicht erfasst. Capture payment im Bestellreiter wird nur in diesem Status angeboten. Standard: Pending.

On Hold (Review) Status: zur Prüfung durch die Fraud Detection Suite zurückgehalten, oder der belastete bzw. erfasste Betrag weicht von der Bestellung ab. Eine Notiz erklärt den Grund. Standard: Pending, da OpenCart keinen Status On hold hat. Sie können eigene Status unter System > Localisation > Order Statuses anlegen und hier auswählen.

Canceled Status: in Authorize.Net ohne Zahlung abgelehnt, storniert oder abgelaufen (Webhook), oder die Autorisierung wurde im Bestellreiter storniert. Standard: Canceled.

Refunded Status: wird gesetzt, nachdem die Zahlung vollständig erstattet (oder eine bezahlte Transaktion storniert) wurde, im Bestellreiter. Standard: Refunded.

Advanced

Debug log: schreibt API-Anfragen und -Antworten in wc_ang_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei lässt sich nicht über den Webbrowser öffnen; bei 5 MB wird sie nach wc_ang_debug.old.log.php verschoben. Schlüssel, Kartentoken und personenbezogene Daten werden maskiert. Standard: aus. Fehler, etwa abgelehnte oder fehlgeschlagene Zahlungen, API-Fehler und fehlgeschlagene Erstattungen, werden immer protokolliert, auch wenn dies deaktiviert ist.

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

Delete data on uninstall: ist die Option aktiv, entfernt die Deinstallation der Erweiterung die Einstellungen und das Protokoll. Die Authorize.Net-Transaktionen und -Erstattungen bleiben immer erhalten, sodass vorher bezahlte Bestellungen nach einer Neuinstallation noch erfasst und erstattet werden können. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Transaction Keys und Signature Keys werden nicht exportiert.

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

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Credit Card). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und gibt die Kartennummer, das Ablaufdatum (MM/YY) und den Kartenprüfcode (CVV) im Formular oberhalb der Bestätigungsschaltfläche ein. OpenCart legt die Bestellung in diesem Schritt an, noch ohne Status. Accept.js wird nur mit diesem Formular von Authorize.Net geladen. Wenn der Kunde auf Confirm Order klickt, tauscht Accept.js die Kartendaten im Browser gegen ein Einmal-Token aus. Die Kartenfelder haben keine Formularnamen, daher werden Kartennummer und CVV nie an Ihren Server übertragen.

Die Erweiterung belastet das Token über die Authorize.Net-API mit dem Bestellbetrag in der Bestellwährung. Rechnungsadresse, E-Mail-Adresse und IP-Adresse werden mit der Transaktion zur Adressprüfung und für Betrugsfilter übermittelt, und die Bestellnummer wird als Rechnungsnummer gesendet. Die Bestellung wird erst als bezahlt markiert, wenn Authorize.Net dies bestätigt hat: Wird die Transaktion genehmigt, erhält die Bestellung ihren Status auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung; der Warenkorb wird geleert, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung mit Your card payment has been received. Bei Authorize only zeigt die Seite Your card payment has been authorized. The amount will be charged when your order is processed. Hält die Fraud Detection Suite die Transaktion zurück, zeigt sie Your payment is being reviewed. We will update your order as soon as the review is complete.

Wird die Karte abgelehnt, bleibt der Kunde im Schritt Confirm Order und sieht Payment failed: gefolgt vom Grund unter dem Formular, zum Beispiel eine abgelehnte Karte, ein falscher Kartenprüfcode oder eine abgelaufene Karte. Die Bestellung bleibt ohne Status, der Warenkorb bleibt erhalten, und der Kunde kann eine andere Karte eingeben. Konfigurations- und API-Fehler werden Kunden nicht angezeigt: Sie sehen eine allgemeine Meldung, die Details gehen ins Protokoll. Kann der Shop Authorize.Net nicht erreichen, sieht der Kunde Payment error: unable to connect to the payment gateway. Please try again. Sind die Kartenfelder leer, fordert das Formular mit Please enter the card number, expiry date and card code. dazu auf, sie auszufüllen.

Ein Doppelklick, ein zweiter Tab oder eine wiederholte Übermittlung belastet eine Bestellung nie doppelt. OpenCart 3 legt jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird, sodass ein Warenkorb mehrere Bestellungen haben kann (auf OpenCart 4 können eine frühere Bestellung oder ein zweiter Browser-Tab noch denselben Warenkorb haben): Sobald eine davon bezahlt ist, wird eine andere Bestellung desselben Warenkorbs nicht erneut belastet. Der Kunde sieht This cart has already been paid with order #…. Please check your order history — do not pay again. Ein zweiter Versuch, während der erste noch läuft, zeigt Your payment is already being processed. Please wait a moment and check your order history before trying again. Wurde eine Zahlung genehmigt, konnte aber der Bestellstatus nicht gesetzt werden, sieht der Kunde Your payment was received, but the order could not be completed automatically. Please contact us — do not pay again. Die Bestellung erhält dann beim nächsten Versuch oder über den Webhook ihren Status aus der genehmigten Zahlung, ohne dass die Karte erneut belastet wird.

Auf OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose im Block der Zahlungsart im Fenster Payment method options aus. Das Kartenformular erscheint dann im Bestätigungsblock am Ende der Kasse, oberhalb von Confirm Order. Die Rechnungsadresse ist auf OpenCart 4 optional: Fehlt sie, wird die Lieferadresse als Rechnungsadresse an Authorize.Net übermittelt. OpenCart 4 behält für die Kasse eine Bestellung und aktualisiert sie, sodass nach einer abgelehnten Karte dieselbe Bestellung bezahlt wird. Wurde diese Bestellung inzwischen geschlossen (etwa weil Sie sie storniert haben) oder ist sie bereits bezahlt und der Warenkorb enthält nun einen neuen Kauf, führt Confirm Order den Kunden zurück zur Kassenseite; das nächste Confirm Order bezahlt eine neue Bestellung. Oberhalb der Kassenseite sieht der Kunde Your previous order is closed (cancelled or refunded by the store). Please confirm the order again: the cart will be paid with a new order., wenn die Bestellung geschlossen wurde, oder Your previous order is already paid. Please confirm the order again: the cart will be paid with a new order., wenn sie für einen früheren Warenkorb bezahlt wurde. Eine Änderung des Warenkorbs, auch eine neue Menge, zählt als neuer Warenkorb, der eine eigene Zahlung benötigt.

Weicht der belastete Betrag vom Bestellbetrag ab, wird die Bestellung mit einer Notiz in den Status On Hold (Review) Status gesetzt, und die Zahlung wird mit dem tatsächlich belasteten Betrag erfasst.

Die Erweiterung unterstützt keine gespeicherten Karten oder Kundenprofile, keine Abonnements oder wiederkehrenden Zahlungen, kein eCheck/ACH, Apple Pay, Google Pay, PayPal oder 3-D Secure, keine Teilerfassung einer Autorisierung und keine automatische Währungsumrechnung.

Bestellungen und Erstattungen

Order statuses

No status (missing order): die Karte wurde abgelehnt oder die Zahlung ist fehlgeschlagen. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Order Status After Payment (default Processing): die Karte wurde belastet (Authorize and capture) oder eine Autorisierung wurde erfasst. Eine Notiz zeigt den Betrag, die Trans ID, den Autorisierungscode, den Kartentyp und die letzten vier Ziffern.

Authorized Status (default Pending): die Mittel sind nur autorisiert (Authorize only). Erfassen Sie sie vor der Abwicklung.

On Hold (Review) Status (default Pending): die Fraud Detection Suite hat die Transaktion zur Prüfung zurückgehalten, der belastete Betrag stimmt nicht mit dem Bestellbetrag überein, oder eine per Webhook gemeldete Erfassung stimmt nicht mit dem Bestellbetrag überein. Die Notiz erklärt es. Genehmigen oder lehnen Sie eine zurückgehaltene Transaktion im Authorize.Net-Panel ab; mit Webhooks wird die Bestellung automatisch aktualisiert.

Canceled Status (default Canceled): ein Webhook hat gemeldet, dass die Transaktion abgelehnt, storniert oder abgelaufen ist, bevor die Bestellung bezahlt wurde, oder Sie haben eine nicht erfasste Autorisierung storniert. Wird die Transaktion einer bezahlten Bestellung im Authorize.Net-Panel storniert, bleibt ihr Status unverändert, und es wird eine Warnnotiz hinzugefügt.

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

Auf OpenCart 4 kann eine nicht bezahlte Bestellung der Kasse den Status Voided erhalten, den OpenCart 4 setzt, wenn der Kunde zum Schritt Confirm Order zurückkehrt. Die Erweiterung behandelt eine solche Bestellung wie eine Bestellung ohne Status: Eine spätere Zahlung oder ein Webhook setzt trotzdem ihren Status.

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

VibeFox Authorize.Net Gateway tab

Öffnen Sie unter Sales > Orders eine mit Authorize.Net bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox Authorize.Net Gateway die Trans ID mit der Kennzeichnung Sandbox bei Sandbox-Zahlungen, den Transaction type, den Status der Transaktion, die Card und den Autorisierungscode, die Beträge Charged / order / refunded, die Schaltfläche zum Erfassen, das Erstattungsformular, den Erstattungsverlauf und die Authorize.Net notes der Bestellung. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben. Erfassung und Erstattungen erfordern das Recht, die Erweiterung zu bearbeiten (eingestellt unter System > Users > User Groups).

Capture

Klicken Sie bei einer Bestellung im Authorized Status im Reiter auf Capture payment und bestätigen Sie Capture the authorized amount through Authorize.Net? Der autorisierte Betrag wird erfasst, und die Bestellung erhält den Order Status After Payment. Schlägt die Erfassung fehl, wird der Fehler angezeigt und in den Notizen vermerkt. Sie können auch im Authorize.Net-Panel erfassen; mit Webhooks wird die Bestellung automatisch aktualisiert.

Refunds

Geben Sie im Reiter den Amount ein (der noch nicht erstattete Betrag wird vorausgefüllt), optional einen Reason (optional), klicken Sie auf Refund via Authorize.Net und bestätigen Sie Refund this amount through Authorize.Net? This cannot be undone. Eine Erstattung des vollen Betrags storniert zuerst die Transaktion, wenn sie noch nicht abgerechnet ist, oder eine Autorisierung, die nicht erfasst wurde. Abgerechnete Transaktionen, in der Regel nach 24 Stunden, können vollständig oder teilweise erstattet werden. Vor der Abrechnung ist keine Teilerstattung möglich: Erstatten Sie den vollen Betrag, um die Transaktion zu stornieren, oder versuchen Sie es nach der Abrechnung erneut. Erstattungen erfolgen in dem Betrag und der Währung, die Authorize.Net belastet hat; nach einer Betragsabweichung können Sie daher höchstens den Betrag erstatten, den der Kunde tatsächlich bezahlt hat, nicht den Bestellbetrag. Akzeptiert Authorize.Net die Erstattung nicht, zeigt der Reiter den Fehler, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung oder Stornierung wird im Erstattungsverlauf und in den Notizen vermerkt. Eine vollständige Erstattung setzt die Bestellung auf Refunded Status (bei einer nur stornierten Autorisierung auf Canceled Status), ohne den Kunden zu benachrichtigen und ohne Produkte in den Lagerbestand zurückzubuchen, wie bei einer manuellen Statusänderung. Eine Teilerstattung ändert den Status nicht. Solange eine Transaktion zur Prüfung zurückgehalten wird, werden keine Erstattungen angeboten.

Erfassungen, Erstattungen und Webhook-Prüfungen einer Bestellung verwenden die Zugangsdaten des Modus, in dem die Bestellung bezahlt wurde. Bestellungen des anderen Modus können daher auch nach dem Umschalten von Sandbox mode noch erfasst und erstattet werden. Behalten Sie die Zugangsdaten dieses Modus in ihren Feldern, bis diese Bestellungen abgeschlossen sind.

Produktrücksendungen unter Sales > Returns erstatten kein Geld über Authorize.Net. Im Authorize.Net-Panel vorgenommene Erstattungen werden dem Shop nicht gemeldet: Aktualisieren Sie die Bestellung manuell.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Authorize.Net Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Authorize.Net 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 (etwa das Datum, bis zu dem die Lizenz gilt, und Ihre Domain) sowie die Schaltflächen Check now zur erneuten Statusprüfung, Change key zur Eingabe eines anderen Schlüssels und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: opencart-payment-authorizenet und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit dem Recht Modify für die Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen der Admin-Sprache (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt der Block den Grund, zum Beispiel Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Nach einer Änderung der Shop-Adresse oder nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet die Erweiterung mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert auf einer Domain: der Shop-Adresse aus der OpenCart-Konfiguration. Das Entfernen des Schlüssels aus dem Shop gibt seinen Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird die Authorize.Net-Kartenzahlung Kunden in der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Ein Admin-Benutzer, der im Admin-Bereich im selben Browser angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert mit (unlicensed — visible to admins only), sodass Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. Auf OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht den Admin-Login nicht, daher wird die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint ein Hinweis auf dem Dashboard des Admin-Bereichs. Schließen Sie ihn mit ×, um ihn 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: bereits begonnene Zahlungen werden weiterhin bestätigt, und Erfassungen 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 Dashboard oder die Seite Edit im Admin-Bereich öffnen: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal wöchentlich. Ein Cron-Job ist nicht nötig. Die Deinstallation der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Die Kartenzahlung erscheint nicht in der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und der aktuelle Modus eine API Login ID, einen Transaction Key und einen Public Client Key hat. Die Einstellungsseite zeigt eine Warnung, wenn etwas fehlt. Prüfen Sie, ob die Währung des Kunden unterstützt wird, ob die Rechnungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht.

Die Zahlung wurde durchgeführt, aber die Bestellung bleibt im Status autorisiert oder zur Prüfung: Der Transaktionstyp ist Authorize only (erfassen Sie sie im Bestellreiter), oder Authorize.Net hat die Transaktion zur Prüfung zurückgehalten. Genehmigen oder lehnen Sie sie im Authorize.Net-Panel ab. Damit solche Bestellungen automatisch aktualisiert werden, richten Sie den Webhook ein: Prüfen Sie, ob der Endpunkt im Konto des verwendeten Modus existiert, ob seine URL exakt der unter Endpoint URL angezeigten entspricht, ob die vier Ereignisse ausgewählt sind und ob der Signature Key dieses Kontos eingetragen ist.

Webhook-Antwort: webhooks are not configured: für keinen der beiden Modi ist ein Signature Key eingetragen.

Webhook-Antwort: invalid signature: Der Signature Key gehört zu einem anderen Konto, oder in Authorize.Net wurde ein Schlüssel geändert. Erstellen oder kopieren Sie den Signature Key erneut und fügen Sie ihn in das Feld seines Modus ein.

Webhook-Antwort: mode mismatch: Die Benachrichtigung wurde mit dem Schlüssel des einen Modus signiert, die Zahlung wurde aber im anderen Modus durchgeführt. Prüfen Sie, ob die Signature Keys für Sandbox und Live nicht vertauscht sind.

Webhook-Antwort: verification failed, retry later: Der Shop konnte die Transaktion nicht über die Authorize.Net-API abrufen, oder die Zugangsdaten des Modus der Zahlung fehlen. Authorize.Net wiederholt die Zustellung.

Webhook-Antwort: busy, retry later: Die Bestellung wurde im selben Moment von einer anderen Anfrage aktualisiert, oder die Verarbeitung ist fehlgeschlagen. Authorize.Net wiederholt die Zustellung. Den Grund finden Sie im Feld Log.

Die Webhook-URL zeigt im Browser method not allowed: Das ist normal. Die URL akzeptiert nur Anfragen von Authorize.Net.

Das Kartenformular zeigt The secure card form (Accept.js) could not be loaded: Die Kasse muss HTTPS verwenden, und der Public Client Key und die API Login ID des aktuellen Modus müssen korrekt sein.

Payment error: the card could not be tokenized: Accept.js hat kein Token zurückgegeben. Der Kunde sollte die Kartendaten erneut eingeben und es noch einmal versuchen.

Der Kunde sieht This payment method is not available: Die Kassensitzung passt nicht mehr zur Bestellung, die Zahlungsart wurde in der Zwischenzeit deaktiviert, die Zugangsdaten fehlen oder der Bestellbetrag ist null. Mit Please reload the checkout page lädt der Kunde die Kasse neu.

Der Kunde sieht eine allgemeine Fehlermeldung: Sehen Sie im Feld Log auf der Erweiterungsseite nach; Fehler werden dort immer protokolliert. Eine Währung, die das Konto nicht unterstützt, wird von Authorize.Net abgelehnt.

Eine Teilerstattung schlägt fehl, weil die Transaktion noch nicht abgerechnet ist: Erstatten Sie den vollen Betrag, um die Transaktion zu stornieren, oder versuchen Sie es nach der Abrechnung erneut, in der Regel innerhalb von 24 Stunden.

Erstattung oder Erfassung schlägt mit einer Meldung zum Modus fehl: Die Zahlung wurde im Sandbox- oder Live-Modus durchgeführt, und die API Login ID und der Transaction Key dieses Modus sind nicht eingetragen. 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 Authorize.Net Gateway auf Uninstall (der rote −-Button). 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 im Abschnitt Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Ereignis der Erweiterung wird entfernt (auf OpenCart 4 seine Ereignisse, darunter das, das die Meldung oberhalb der Kassenseite anzeigt, und seine Startaktion, die den Webhook im Wartungsmodus durchlässt). Ist Delete data on uninstall aktiv, werden die übrigen Einstellungen (Titel, Beschreibung, Sandbox-Modus, Zugangsdaten, Transaktionstyp, Protokollierung) und das Protokoll entfernt. Ist die Option deaktiviert, bleiben sie für eine spätere Neuinstallation erhalten. Die Authorize.Net-Transaktionen und -Erstattungen werden immer aufbewahrt, sodass vorher bezahlte Bestellungen nach einer Neuinstallation noch erfasst und 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 Authorize.Net Gateway auf Uninstall (der orangefarbene −-Button) und danach auf Delete (der rote Papierkorb-Button), um das hochgeladene Paket zu entfernen.

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