VibeFox Nexi XPay 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: Der Kunde muss in EUR bezahlen, daher muss die Währung EUR unter System > Localisation > Currencies aktiviert sein. Bei anderen Währungen wird die Zahlungsart an der Kasse ausgeblendet.

Nexi-XPay-Konto: Sie benötigen ein Nexi-XPay-Händlerkonto (Weiterleitungsintegration „Pagamento Semplice“) mit dem Alias (Terminal-ID) und dem MAC-Schlüssel Ihres Terminals. Test- und Live-Zugangsdaten sind getrennt: Die Testdaten stammen aus dem Testbereich von Nexi XPay oder dem Entwicklerportal (developer.nexi.it), die Live-Daten aus Ihrem Nexi-XPay-Back-Office, nachdem das Händlerkonto aktiviert wurde. Im Nexi-Back-Office muss nichts eingerichtet werden: Die Rückkehr- und Benachrichtigungsadressen werden mit jeder Zahlung übermittelt.

Öffentlicher Shop: Die Benachrichtigungs-URL muss aus dem Internet erreichbar sein, ohne Basisauthentifizierung oder Firewall-Regel, die Nexi blockiert. Kann die Benachrichtigung den Shop nicht erreichen, wird die Zahlung trotzdem durch die signierte Rückkehr des Kunden bestätigt.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. 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 OpenCart-3-Paket wcp_nexi_gateway-oc3-(version).ocmod.zip und das OpenCart-4-Paket wcp_nexi_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 zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_nexi_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 den Inhalt des Ordners upload aus diesem Paket auch in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox Nexi XPay Gateway und klicken Sie auf Install (die grüne +-Schaltfläche). Ihr Admin-Benutzer braucht 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 Lizenzschlüssel).

4. Lassen Sie Test Mode eingeschaltet und tragen Sie den Test-Alias und den Test-MAC-Schlüssel ein (siehe Konfiguration).

5. Schalten Sie Enable/Disable ein, klicken Sie auf Save und führen Sie eine Testbestellung in EUR durch. Wenn alles funktioniert, tragen Sie den Live-Alias und den Live-MAC-Schlüssel ein und schalten Sie Test Mode aus.

OpenCart 4

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

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

3. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox Nexi XPay Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

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

Eine neue Installation startet mit ausgeschalteter Zahlungsart und eingeschaltetem Testmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Nexi XPay Gateway > Edit. Die Abschnitte stehen links; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen zeigt die Seite Test mode is on: payments go to the Nexi XPay test environment, no real money is charged., solange der Testmodus eingeschaltet ist. Sie warnt, wenn das Gateway aktiviert ist, aber Alias oder MAC-Schlüssel des aktuellen Modus leer sind (die Zahlungsart wird dann an der Kasse ausgeblendet), sowie wenn die Standardwährung des Shops nicht EUR ist (die Zahlungsart wird dann nur Kunden angezeigt, die in EUR bezahlen). Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen, kann sie aber nicht speichern.

Beim Speichern darf Title nicht länger als 128 Zeichen sein, Sort Order muss eine ganze Zahl sein, Total eine Zahl von 0 oder mehr, und die Geozone und Bestellstatus müssen vorhanden sein. Ist eines davon falsch, wird nichts gespeichert. Leerzeichen um eingefügte Aliase und Schlüssel werden entfernt.

Nexi XPay

Enable/Disable: Enable Nexi XPay Gateway schaltet die Zahlungsart ein oder aus. Standard: aus.

Title: der Name der Zahlungsart, der dem Kunden an der Kasse angezeigt wird. Er wird auch als Zahlungsart in der Bestellung gespeichert. Standard: Credit Card (Nexi); ein leerer Titel verwendet den Standard. Bis zu 128 Zeichen. Im Testmodus fügen Kasse und Bestellung dem Titel (TEST MODE) hinzu; ein sehr langer Titel wird so gekürzt, dass der Name mit (TEST MODE) in die 128 Zeichen der Bestellung passt.

Description: der Text, den der Kunde im Schritt Confirm Order sieht. Standard: Pay securely with your credit card via Nexi XPay.

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

Geo Zone: Nexi XPay nur für Rechnungsadressen in der gewählten Geozone anbieten. Standard: All zones. Geozonen werden unter System > Localisation > Geo Zones eingerichtet.

Total: der Warenkorbbetrag in der Standardwährung des Shops, den eine Bestellung erreichen muss, bevor Nexi XPay angeboten wird. Leer lassen, um es bei jedem Betrag anzubieten.

Testumgebung

Testzahlungen gehen an int-ecommerce.nexi.it und belasten niemals echte Karten. Den Test-Alias und den Test-MAC-Schlüssel erhalten Sie im Testbereich von Nexi XPay oder im Entwicklerportal (developer.nexi.it, im Abschnitt verlinkt).

Test Mode: verwendet die Testumgebung von Nexi XPay und die Testzugangsdaten. Schalten Sie ihn aus, um echte Zahlungen mit den Live-Zugangsdaten anzunehmen. Standard: eingeschaltet. Solange er eingeschaltet ist, sehen Kunden im Schritt Confirm Order TEST MODE: the payment goes to the Nexi XPay test environment, no real money is charged.

Test Alias: der Alias (Terminal-ID) Ihres Nexi-XPay-Testterminals.

Test MAC Key: der MAC-Berechnungsschlüssel Ihres Nexi-XPay-Testterminals.

Live-Umgebung

Der Live-Alias und der Live-MAC-Schlüssel werden in Ihrem Nexi-XPay-Back-Office (ecommerce.nexi.it) angezeigt, nachdem Ihr Händlerkonto aktiviert wurde.

Live Alias: der Alias (Terminal-ID) Ihres Nexi-XPay-Live-Terminals.

Live MAC Key: der MAC-Berechnungsschlüssel Ihres Nexi-XPay-Live-Terminals.

Gespeicherte MAC-Schlüssel werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um einen gespeicherten Schlüssel zu entfernen, aktivieren Sie unter dem Feld Clear the saved MAC key on save und klicken Sie auf Save.

Zahlung

Notification URL: wird zur Information angezeigt. Bei OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_nexi_gateway/s2s&nexi_order={order_id}, bei OpenCart 4 so: https://your-store/index.php?route=extension/wcp_nexi_gateway/payment/wcp_nexi_gateway.s2s&nexi_order={order_id}, mit der Bestellnummer am Ende, und wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet. Sie wird mit jeder Zahlung an Nexi übermittelt, daher muss im Nexi-Back-Office nichts konfiguriert werden. Nexi sendet das Zahlungsergebnis serverseitig an diese URL und übergibt es außerdem mit der Rückkehr des Kunden. Beide sind gleich signiert und werden mit dem MAC-Schlüssel der Umgebung, in der die Zahlung erfolgte, dem Alias dieser Umgebung und dem für die Bestellung ausgestellten Transaktionscode geprüft. Ergebnisse, die die Prüfung nicht bestehen, werden abgelehnt und verändern nichts.

Capture: wann der Betrag eingezogen wird.

Order Status After Payment: der Status der Bestellung nach einer erfolgreichen Zahlung. Die OpenCart-Status für jede Auswahl werden im Abschnitt Orders festgelegt.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Sie erhält einen Status erst durch ein verifiziertes Ergebnis von Nexi. Jedes Feld unten listet Ihre OpenCart-Bestellstatus auf. OpenCart hat keinen Status „On hold“: Standardmäßig wird Pending verwendet, und eine Bestellnotiz erklärt den Grund. Sie können unter System > Localisation > Order Statuses eigene Status anlegen und hier auswählen.

Status: Processing: wird verwendet, wenn Order Status After Payment Processing ist. Standard: Processing.

Status: Completed: wird verwendet, wenn Order Status After Payment Completed ist. Standard: Complete.

Status: awaiting payment: Nexi meldet die Zahlung als ausstehend (esito PEN). Standard: Pending.

Status: on hold: Abweichung bei Betrag oder Währung, eine Zahlung für eine stornierte Bestellung, verzögerte Erfassung (autorisiert, noch nicht erfasst) oder Order Status After Payment auf On hold gesetzt. Standard: Pending.

Status: payment failed: eine ausstehende Zahlung, die anschließend fehlgeschlagen ist. Standard: Failed.

Status of cancelled orders: der Status, den Ihr Shop für stornierte Bestellungen verwendet. Eine Zahlung für eine solche Bestellung wird auf Halt gesetzt, niemals als bezahlt markiert. Die Erweiterung liest diesen Status nur und setzt ihn nie. Standard: Canceled.

Erweitert

Debug Log: protokolliert Zahlungsereignisse in nexi_ip_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über den Webbrowser geöffnet werden. MAC-Schlüssel, MACs, Kartendaten und E-Mail-Adressen werden nicht protokolliert. Fehler und Warnungen, zum Beispiel eine fehlgeschlagene MAC-Prüfung, werden immer protokolliert, auch wenn die Option ausgeschaltet ist. Standard: aus.

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. Die Nexi-XPay-Zahlungsdaten der Bestellungen bleiben immer erhalten. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Die MAC-Schlüssel werden nicht exportiert.

Import: Fügen Sie exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Die gespeicherten MAC-Schlüssel bleiben unverändert.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Credit Card (Nexi)). In OpenCart 4 wählt der Kunde sie mit der Schaltfläche Choose im Block der Zahlungsart im Fenster Payment method options aus und klickt unten auf der Kassenseite auf Confirm Order. Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung. OpenCart legt die Bestellung in diesem Schritt an, weiterhin ohne Status. Wenn der Kunde auf Confirm Order klickt, zeigt die Seite Redirecting to the Nexi XPay payment page... und Please do not close this window. und leitet den Kunden nach einer Sekunde automatisch zur Nexi-XPay-Seite weiter; als Alternative gibt es eine Schaltfläche Pay with Nexi XPay. Die Zahlung wird in EUR für den Bestellbetrag mit einem neuen Transaktionscode, der E-Mail-Adresse des Kunden und der Beschreibung Order, der Bestellnummer und dem Namen Ihres Shops übermittelt. Die Nexi-Seite öffnet sich in der Shop-Sprache des Kunden, wenn es Italienisch, Englisch, Spanisch, Französisch, Deutsch, Japanisch, Chinesisch, Arabisch, Russisch oder Portugiesisch ist, andernfalls auf Englisch.

Der Kunde bezahlt und kehrt in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn ein verifiziertes Nexi-Ergebnis mit genau dem Bestellbetrag und der Währung vorliegt: entweder die serverseitige Benachrichtigung oder die signierte Rückkehr des Kunden, je nachdem, was zuerst eintrifft. Die Bestellung erhält dann ihren Status auf die übliche OpenCart-Weise, mit der üblichen Bestell-E-Mail und Bestandsaktualisierung, und der Kunde sieht die OpenCart-Erfolgsseite mit Your Nexi XPay payment has been received. Meldet Nexi die Zahlung als ausstehend, zeigt die Seite Your payment is pending confirmation from Nexi XPay. We will update your order as soon as the payment is confirmed. Bei einer Bestellung auf Halt (verzögerte Erfassung oder manuelle Prüfung) zeigt sie Your Nexi XPay payment has been received and is being reviewed. We will contact you if anything is needed.

Ist das Ergebnis beim Zurückkehren des Kunden noch nicht verarbeitet, zeigt eine Seite Payment confirmation We have not received the payment confirmation from Nexi XPay yet. If you completed the payment, your order will be updated shortly. mit einer Schaltfläche Check again. Die Benachrichtigung setzt den Bestellstatus, sobald sie eintrifft.

Wird die Zahlung abgelehnt, schlägt eine ausstehende Zahlung fehl oder bricht der Kunde auf der Nexi-Seite ab, kehrt er zur Kasse zurück und sieht eine dieser Meldungen: The payment was not completed. Please try again or choose a different payment method., Payment was cancelled. Please try again. oder We could not confirm the payment. If your card was charged, please contact us before paying again. In OpenCart 4 werden diese Meldungen über der Kassenseite angezeigt. Eine Bestellung ohne Status bleibt ohne Status, und der Warenkorb bleibt erhalten, sodass der Kunde erneut bezahlen kann. 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 bezahlt dieselbe Bestellung erneut mit einem neuen Transaktionscode. ist eine andere Bestellung desselben Warenkorbs bereits bezahlt, ausstehend oder auf Halt, gelangt der Kunde zur Erfolgsseite statt zu einer neuen Zahlung.

In OpenCart 4 bleibt die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel ist eine ausstehende Zahlung fehlgeschlagen oder Sie haben sie storniert), wird der Kunde mit Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. zur Kasse zurückgeschickt, auch wenn er von Nexi zurückkehrt, und das nächste Confirm Order bezahlt eine neue Bestellung. Wurde die Bestellung bezahlt und dann vom Shop geschlossen (zum Beispiel erstattet), lautet die Meldung Your previous order #(Nummer) was closed by the store. Please confirm the order again to pay with a new order. Ist die Bestellung für diese Kasse bereits aufgegeben und der Warenkorb seitdem geändert, lautet die Meldung Your previous order #(Nummer) has already been placed. Your cart has changed: please confirm the new order to pay for it. Eine Änderung des Warenkorbs, auch eine neue Menge, gilt als neuer Warenkorb, der eine eigene Zahlung braucht.

Ist die Erweiterung für den aktuellen Modus nicht eingerichtet, sieht der Kunde This payment method is not available right now. Please choose another payment method.

Die Benachrichtigung funktioniert auch, während der Shop im Wartungsmodus ist, da OpenCart 3 Anfragen von Zahlungserweiterungen durchlässt und OpenCart 4 dafür eine Startaktion der Erweiterung ergänzt, die auch die Rückkehr des Kunden von Nexi durchlässt.

Die Erweiterung nimmt Zahlungen nur auf der Nexi-XPay-Seite entgegen. Sie bietet keine Erstattungen aus OpenCart, keine gespeicherten Karten oder OneClick, keine Abonnements oder wiederkehrenden Zahlungen, kein Pay-By-Link, keine eingebetteten XPay-Build-Felder und keine Auswahl von Zahlungsarten in OpenCart: Die Nexi-Seite zeigt die auf Ihrem Terminal aktivierten Zahlungsarten.

Bestellungen und Erstattungen

Bestellstatus

No status (missing order): Der Kunde wurde zu Nexi geschickt und hat nicht bezahlt, abgebrochen oder die Zahlung wurde abgelehnt, oder Nexi hat die Zahlung noch nicht bestätigt. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Status: Processing, Completed or on hold: Nexi hat die Zahlung bestätigt. Der Status folgt Order Status After Payment. Eine Notiz zeigt den Autorisierungscode, den Transaktionscode, die Kartenmarke und die Nachricht von Nexi.

Status: on hold (authorized): Verzögerte Erfassung ist ausgewählt und die Zahlung ist nur autorisiert. Erfassen Sie sie mit Capture Nexi XPay payment im Bestellreiter.

Status: awaiting payment: Nexi hat die Zahlung als ausstehende Bestätigung gemeldet. Die Bestellung wird durch das endgültige Ergebnis aktualisiert.

Status: on hold after payment: Betrag oder Währung von Nexi stimmen nicht mit der Bestellung überein (die Bestellung wird nicht als bezahlt markiert), oder eine erfolgreiche Zahlung ging für eine bereits stornierte Bestellung ein. Die Notiz erklärt es. Prüfen Sie die Zahlung im Nexi-XPay-Back-Office und bearbeiten oder erstatten Sie die Bestellung.

Status: payment failed: Eine ausstehende Zahlung ist fehlgeschlagen.

Eine bezahlte Bestellung wird durch einen späteren Fehlschlag nie herabgestuft. Geht eine weitere erfolgreiche Zahlung für eine bereits bezahlte Bestellung oder für eine andere Bestellung desselben Warenkorbs ein, bittet eine Notiz an der bezahlten Bestellung darum, sie im Nexi-XPay-Back-Office zu erstatten, falls es ein Duplikat ist; die zweite Bestellung wird nicht als bezahlt markiert. Wenn eine ausstehende Zahlung später erfolgreich ist oder fehlschlägt, benachrichtigt OpenCart den Kunden über den neuen Status.

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

Registerkarte VibeFox Nexi XPay Gateway

Öffnen Sie unter Sales > Orders eine Bestellung, die mit Nexi XPay bezahlt wurde. Unten auf der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox Nexi XPay Gateway den Transaktionscode (codTrans) mit der Bezeichnung Test environment bei Testzahlungen, den Status und das Ergebnis von Nexi, den Erfassungsmodus und -status, den an Nexi gesendeten und den empfangenen Betrag, den Autorisierungscode, die Kartenmarke, die Nachricht von Nexi, das Datum und die Nexi XPay notes der Bestellung. Die Registerkarte wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Verzögerte Erfassung

Klicken Sie bei einer autorisierten Bestellung auf Halt auf der Registerkarte auf Capture Nexi XPay payment (die Schaltfläche zeigt den Betrag) und bestätigen Sie die Frage Capture the authorized amount through Nexi XPay? Sie benötigen das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups). Die Erweiterung erfasst den autorisierten Betrag in der Umgebung der Zahlung mit den Schlüsseln dieser Umgebung und setzt den Status aus Order Status After Payment mit einer Notiz. Der Status wird direkt geändert, wie bei einer manuellen Statusänderung, ohne E-Mails und Bestandsbewegungen. Schlägt die Erfassung fehl, zeigt die Registerkarte den Fehler, es wird eine Notiz hinzugefügt und die Bestellung bleibt auf Halt. Eine zweite Erfassung derselben Zahlung wird abgelehnt.

Erstattungen

Erstattungen werden nicht aus OpenCart heraus vorgenommen, daher gibt es für Nexi XPay keine Erstattungsschaltfläche. Nehmen Sie die Erstattung im Nexi-XPay-Back-Office vor und erfassen Sie sie anschließend manuell in OpenCart. Produktrücksendungen unter Sales > Returns zahlen über Nexi kein Geld zurück.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Nexi XPay Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Nexi XPay 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, 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-nexi 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 Domainplatz 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. Das Entfernen des Schlüssels aus dem Shop gibt den Domainplatz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Nexi XPay 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 Admin im selben Browser angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. In 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 auf dem Dashboard des Admins eine Erinnerung. Mit × schließen Sie sie und blenden sie für 7 Tage aus. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und autorisierte Zahlungen können noch erfasst werden.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, Updates und Support erfordern aber eine Verlängerung. Der Status wird beim Öffnen des Dashboards oder der Seite Edit im Admin automatisch erneut geprüft: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Das Deinstallieren der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Nexi XPay erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, der aktuelle Modus beide Zugangsdaten hat (Test Alias und Test MAC Key im Testmodus, Live Alias und Live MAC Key im Live-Modus) und der Kunde in EUR bezahlt. Die Einstellungsseite zeigt in diesen Fällen eine Warnung. Prüfen Sie außerdem, ob die Zahlungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht.

Die Zahlung ist erfolgt, aber die Bestellung bleibt ohne Status: Weder die Benachrichtigung noch die Rückkehr des Kunden wurden akzeptiert. Prüfen Sie, ob der Shop aus dem Internet erreichbar ist, ob MAC-Schlüssel und Alias zur Umgebung (Test oder Live) der Zahlung passen, und schalten Sie das Debug Log ein, um im Feld Log auf der Seite der Erweiterung zu sehen, was Nexi gesendet hat.

Die Benachrichtigung antwortet invalid_mac oder invalid_alias: Der MAC-Schlüssel oder der Alias in den Einstellungen passt nicht zum Terminal, das das Ergebnis gesendet hat. Kopieren Sie beides erneut aus dem Nexi-Testbereich oder dem Back-Office.

Die Benachrichtigung antwortet unknown_transaction oder order_not_found: Der Transaktionscode wurde von diesem Shop für diese Bestellung nicht ausgestellt, oder die Bestellung existiert nicht. Das Ergebnis wird ignoriert.

Die Benachrichtigung antwortet not_configured oder busy: Alias oder MAC-Schlüssel der Umgebung der Zahlung sind leer, oder die Bestellung wurde im selben Moment von einer anderen Anfrage aktualisiert. Nexi wiederholt die Benachrichtigung.

Die Benachrichtigungs-URL zeigt im Browser method_not_allowed: Das ist normal. Die URL akzeptiert nur Anfragen von Nexi.

Der Kunde sieht This payment method is not available. Please reload the checkout page.: Die Kassensitzung passt nicht mehr zur Bestellung, oder die Zahlungsart wurde inzwischen ausgeschaltet. Der Kunde lädt die Kasse neu.

Die Bestellung steht nach der Zahlung im Status „auf Halt“: Lesen Sie die Nexi XPay notes im Bestellreiter. Verzögerte Erfassung ist ausgewählt (erfassen Sie die Zahlung mit der Schaltfläche), Betrag oder Währung stimmten nicht überein, eine Zahlung ging für eine stornierte Bestellung ein, oder Order Status After Payment ist auf On hold gesetzt.

Capture Nexi XPay payment fehlt oder schlägt fehl: Die Schaltfläche wird nur bei Nexi-XPay-Bestellungen angezeigt, die als autorisiert mit verzögerter Erfassung auf Halt stehen, und nur für Benutzer, die die Erweiterung ändern dürfen. Sind Alias oder MAC-Schlüssel der Umgebung der Zahlung leer, weist der Reiter darauf hin. Schlägt die Erfassung fehl, lesen Sie den Fehler im Reiter und in den Notizen, zum Beispiel Nexi XPay refused the capture mit dem Code und der Nachricht von Nexi.

Testzahlungen bestätigen keine Live-Zahlung: Jede Zahlung wird mit den Schlüsseln der Umgebung geprüft, in der sie gestartet wurde. Stellen Sie Test Mode auf den gewünschten Modus um und verwenden Sie Alias und MAC-Schlüssel dieses Modus.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Nexi XPay Gateway auf Uninstall (die rote −-Schaltfläche). 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 Status des Abschnitts Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Das OpenCart-Ereignis der Erweiterung wird ebenfalls entfernt (in OpenCart 4 seine Ereignisse und seine Startaktion, die die Benachrichtigung im Wartungsmodus durchlässt). Ist Delete Data on Uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Testmodus, Aliase, MAC-Schlüssel, Erfassung, Bestellstatus nach der Zahlung, Debug-Protokoll) und das Protokoll entfernt. Ist es ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die Nexi-XPay-Zahlungsdaten der Bestellungen (Zahlungen, Erfassungen und Erstattungen) bleiben immer erhalten, sodass autorisierte Zahlungen nach einer Neuinstallation noch erfasst werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

In OpenCart 4 entfernen Sie außerdem die Dateien der Erweiterung: Gehen Sie nach der Deinstallation zu Extensions > Installer und klicken Sie in der Liste der installierten Erweiterungen neben VibeFox Nexi XPay Gateway auf Uninstall (die orangefarbene −-Schaltfläche) und danach auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

Nexi und XPay sind Marken ihrer jeweiligen Inhaber. Diese Erweiterung ist nicht mit Nexi verbunden und wird von Nexi nicht unterstützt.