VibeFox Authorize.Net for WooCommerce — Hilfe

Anforderungen

WordPress: 5.8 oder neuer.

WooCommerce: 7.0 oder neuer, installiert und aktiv. Ohne WooCommerce zeigt das Plugin einen Hinweis im Adminbereich, und die Zahlungsmethode wird nicht geladen.

PHP: 8.0 oder neuer.

HTTPS: Ihre Kasse muss HTTPS verwenden. Accept.js lässt sich über HTTP nicht ausführen.

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, Großbritannien, Europa, Australien und Neuseeland zur Verfügung.

Währung: die Shopwä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 Zahlungsmethode an der Kasse ausgeblendet.

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

Installation

1. Gehen Sie in WordPress zu Plugins > Add New > Upload Plugin, wählen Sie die ZIP-Datei des Plugins und klicken Sie auf Install Now. Alternativ können Sie den Ordner wcp_authorizenet_gateway per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Authorize.Net > Manage, oder klicken Sie auf der Plugins-Seite unter dem Plugin-Namen auf Settings.

4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.

5. Geben Sie die Zugangsdaten des Sandbox- und des Live-Kontos ein (siehe Konfiguration). Richten Sie optional den Webhook ein.

6. Schalten Sie Enable/Disable ein, wählen Sie die Transaction type und speichern Sie. Testen Sie eine Zahlung im Sandbox-Modus mit der Karte 4111 1111 1111 1111, einem beliebigen zukünftigen Ablaufdatum und einer beliebigen CVV. Entfernen Sie danach das Häkchen bei Sandbox mode.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Authorize.Net. Oberhalb der Felder warnt die Seite, wenn die Website kein HTTPS verwendet (Accept.js funktioniert nur auf HTTPS-Seiten), und wenn die Shopwährung nicht unterstützt wird (dann wird die Zahlungsmethode an der Kasse ausgeblendet). Die Seite zeigt nur die Zugangsdatenfelder des gewählten Modus.

Allgemein

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

Title: der Name der Zahlungsmethode, den Kunden an der Kasse sehen. Standard: Credit Card.

Description: der Text über dem Kartenformular an der Kasse. Standard: Pay securely with your credit card via Authorize.Net.

API-Zugangsdaten

Im Authorize.Net Merchant Interface öffnen Sie Account > Settings > Security Settings. Unter API Credentials & Keys kopieren Sie die API Login ID und erstellen einen Transaction Key sowie einen Signature Key. Unter Manage Public Client Key kopieren Sie den Public Client Key. Sandbox- und Live-Konto verwenden unterschiedliche Zugangsdaten.

Sandbox mode: Use the Authorize.Net sandbox (test transactions, no real charges). Schaltet den API-Endpunkt, Accept.js und die unten stehenden Zugangsdaten um. Standard: ein. Entfernen Sie das Häkchen, um echte Zahlungen anzunehmen.

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

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

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

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

Zahlung

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

Webhooks (empfohlen)

Ohne Webhooks müssen Bestellungen, die vom Fraud Detection Suite zurückgehalten oder im Authorize.Net-Panel erfasst oder storniert wurden, von Hand aktualisiert werden. Gehen Sie im Merchant Interface zu Account > Settings > Business Settings > Webhooks und klicken Sie auf Add Endpoint. Verwenden Sie die URL, die in diesem Abschnitt der Einstellungen angezeigt wird. Sie sieht so aus: https://your-site/wc-api/wc_authorizenet/. Wählen Sie diese Ereignisse aus:

Tragen Sie den Signature Key des Kontos in Live Signature Key oder Sandbox Signature Key ein. Webhooks ohne gültige Signatur werden abgelehnt. Bei jeder Benachrichtigung fragt das Plugin außerdem den aktuellen Status und Betrag der Transaktion bei Authorize.Net ab, bevor sich die Bestellung ändert; wiederholte Benachrichtigungen bewirken daher nichts.

Erweitert

Debug log: Log API requests and responses schreibt in WooCommerce > Status > Logs, Quelle wcp_authorizenet_gateway. Schlüssel, Kartentoken und personenbezogene Daten werden maskiert. Standard: aus.

Delete data on uninstall: Remove the settings and the Authorize.Net order meta when the plugin is deleted. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsmethode (standardmäßig Credit Card) und gibt auf der Kassenseite die Kartennummer, das Ablaufdatum (MM/JJ) und die Kartenprüfnummer (CVV) ein. Im Sandbox-Modus zeigt das Formular einen Hinweis mit der Testkarte 4111 1111 1111 1111. Wenn die Bestellung abgeschickt wird, tauscht Accept.js die Kartendaten im Browser gegen einen einmaligen Token. Die Kartenfelder tragen keine Formularnamen, daher gelangen Kartennummer und CVV nie an Ihren Server.

Das Plugin belastet den 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. Wird die Zahlung genehmigt, gelangt der Kunde zur Seite „Bestellung eingegangen“, und der Warenkorb wird geleert.

Wird die Karte abgelehnt, bleibt der Kunde auf der Kasse und sieht Payment failed: mit dem Grund, zum Beispiel eine abgelehnte Karte, eine falsche Kartenprüfnummer oder eine abgelaufene Karte. Konfigurations- und API-Fehler werden Kunden nicht angezeigt: Sie sehen eine allgemeine Meldung, die Details stehen in der Bestellnotiz und im Protokoll. Kann der Shop Authorize.Net nicht erreichen, sieht der Kunde Payment error: unable to connect to the payment gateway. Please try again.

Wiederholte Absendungen und wiederholte Zahlungen für dieselbe Bestellung belasten sie nie ein zweites Mal. Die Zahlungsmethode funktioniert an der klassischen Kasse, am Kassen-Block und auf der Seite Pay for order. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Das Plugin bietet keine gespeicherten Karten oder Kundenprofile, keine WooCommerce Subscriptions oder Vorbestellungen, kein eCheck/ACH, Apple Pay, Google Pay, PayPal oder 3-D Secure, keine Teilerfassung einer Autorisierung und keine automatische Währungsumrechnung.

Bestellungen und Erstattungen

Bestellstatus

Processing or Completed: die Karte wurde belastet (Authorize and capture) oder eine Autorisierung wurde erfasst. WooCommerce setzt „In Bearbeitung“, bei Bestellungen mit ausschließlich virtuellen, herunterladbaren Produkten „Abgeschlossen“. Die Bestellnotiz zeigt Betrag, Transaktions-ID, Autorisierungscode, Kartentyp und die letzten vier Ziffern. Die Transaktions-ID ist die Authorize.Net-Trans-ID.

On hold: der Betrag ist nur autorisiert (Authorize only), oder der Fraud Detection Suite hat die Transaktion zur Prüfung zurückgehalten. Genehmigen oder lehnen Sie eine zurückgehaltene Transaktion im Authorize.Net-Panel ab; mit Webhooks wird die Bestellung automatisch aktualisiert. Eine Bestellung wird auch auf „Wartend“ gesetzt, wenn eine per Webhook gemeldete Erfassung nicht zum Bestellbetrag passt.

Cancelled: ein Webhook meldete, dass die Transaktion vor der Bezahlung der Bestellung abgelehnt, storniert oder abgelaufen ist. Betrifft das eine bereits bezahlte Bestellung, bleibt ihr Status unverändert, und eine Warnnotiz wird hinzugefügt.

Erfassung

Bei einer Bestellung mit Autorisierung öffnen Sie die Bestellung, wählen Sie in den Bestellaktionen Capture payment (Authorize.Net) und klicken Sie auf die Schaltfläche Aktualisieren. Der gesamte Bestellbetrag abzüglich Erstattungen wird erfasst, und die Bestellung wird als bezahlt markiert. Schlägt die Erfassung fehl, wird der Fehler angezeigt und den Bestellnotizen hinzugefügt. Sie können auch im Authorize.Net-Panel erfassen; mit Webhooks wird die Bestellung automatisch aktualisiert.

Erstattungen

Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via Credit Card (die Schaltfläche verwendet den Titel Ihrer Zahlungsmethode). Die Erstattung des vollen Bestellbetrags 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 ganz oder teilweise erstattet werden. Vor der Abrechnung ist eine Teilerstattung nicht möglich: Erstatten Sie den vollen Betrag, um die Transaktion zu stornieren, oder versuchen Sie es nach der Abrechnung erneut. Akzeptiert Authorize.Net die Erstattung nicht, zeigt WooCommerce den Fehler an, und es wird keine Erstattung verbucht. Eine erfolgreiche Erstattung oder Stornierung wird den Bestellnotizen hinzugefügt.

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

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > Authorize.Net. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain. Mit Check now prüfen Sie den Status erneut, mit Change key geben Sie einen anderen Schlüssel ein und mit Remove key entfernen Sie ihn von dieser Website. Der Link Manage licenses and domains in your account öffnet Ihr vibefox.net-Konto.

Ein Schlüssel gilt für eine Domain. Das Entfernen des Schlüssels von einer Website gibt deren Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Authorize.Net Kunden an der Kasse nicht angezeigt. Versucht trotzdem jemand, eine Zahlung zu starten, sieht der Kunde This payment method is not available. Please choose another one. Angemeldete Shop-Manager sehen die Zahlungsmethode weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin einrichten und testen können, bevor Sie einen Schlüssel kaufen. Auf der Plugins-Seite und auf WooCommerce-Seiten erscheint ein Hinweis. Bestehende Bestellungen bleiben unberührt: Webhooks werden weiterhin verarbeitet, und Erfassungen und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet das Plugin weiter, doch Updates und Support erfordern eine Verlängerung. Der Status wird im Hintergrund automatisch erneut geprüft.

Fehlerbehebung

Authorize.Net erscheint nicht an 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. Prüfen Sie, ob die Shopwährung unterstützt wird; die Einstellungsseite zeigt eine Warnung, wenn nicht.

Die Zahlung ist durchgegangen, aber die Bestellung bleibt auf „Wartend“: die Transaktionsart ist Authorize only (erfassen Sie den Betrag mit der Bestellaktion), 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 die Endpunkt-URL genau der in den Einstellungen angezeigten entspricht, ob alle vier Ereignisse ausgewählt sind und ob der Signature Key des aktuellen Modus eingetragen ist.

Der Webhook antwortet mit „webhooks are not configured“: für keinen Modus ist ein Signature Key eingetragen.

Der Webhook antwortet mit „invalid signature“: der Signature Key gehört zu einem anderen Konto oder Modus. Erstellen oder kopieren Sie den Signature Key erneut und fügen Sie ihn in das Feld seines Modus ein.

Der Webhook antwortet mit „verification failed, retry later“: der Shop konnte die Transaktion nicht über die Authorize.Net-API abrufen. Authorize.Net wiederholt die Zustellung.

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

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

Der Kunde sieht eine allgemeine Fehlermeldung: öffnen Sie die Bestellnotizen oder schalten Sie das Debug log ein und sehen Sie in WooCommerce > Status > Logs, Quelle wcp_authorizenet_gateway, nach. Eine Währung, die das Konto nicht unterstützt, lehnt Authorize.Net ab.

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

Der Lizenzblock zeigt einen Fehler: folgen Sie der Meldung im Block. Ist der Schlüssel zum Beispiel bereits auf einer anderen Domain verwendet, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Hat sich die Adresse der Website geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Ist der Lizenzserver nicht erreichbar, arbeitet das Plugin mit dem zuletzt bekannten Status weiter.

Deinstallation

Beim Deaktivieren des Plugins bleiben alle Daten erhalten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt. Die Gateway-Einstellungen, die Authorize.Net-Daten an den Bestellungen und die Protokolle werden nur entfernt, wenn Delete data on uninstall eingeschaltet war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

Authorize.Net ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit Authorize.Net verbunden noch von Authorize.Net empfohlen.