VibeFox Nets Nexi 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.

Nets-Konto: Sie benötigen die geheimen Schlüssel Ihres Nets-Easy-Kontos (Test und Live). Nur die geheimen Schlüssel werden verwendet. Die Checkout-Schlüssel werden nicht benötigt, da Kunden auf der gehosteten Zahlungsseite von Nets bezahlen.

Währungen und Zahlungsarten: Die Erweiterung beschränkt Währungen nicht selbst. Verwenden Sie die in Ihrem Nets-Konto aktivierten Währungen; eine nicht unterstützte Währung meldet Nets, wenn die Zahlung angelegt wird. Welche Zahlungsarten der Kunde sieht, hängt von Ihrem Vertrag mit Nets, dem Land und der Währung ab.

HTTPS für Webhooks: Nets ruft nur öffentliche HTTPS-Adressen mit höchstens 256 Zeichen ohne "&" auf. Ihr Shop braucht daher HTTPS, um Webhooks zu empfangen. Ohne HTTPS wird die Zahlung trotzdem bestätigt, wenn der Kunde in den Shop zurückkehrt, oder bei der Statusprüfung auf der Bestellseite.

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 Paket für OpenCart 3 wcp_nets_nexi_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_nets_nexi_gateway.ocmod.zip. Installieren Sie nur das Paket für Ihre OpenCart-Version. Der Lizenzschlüssel ist für beide Versionen derselbe.

OpenCart 3

1. Gehen Sie im Admin zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_nets_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 Nets Nexi 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. Kopieren Sie den geheimen Testschlüssel aus dem Nets-Easy-Testportal und fügen Sie ihn in Test Secret Key ein (siehe Konfiguration). Im Nets-Portal muss nichts eingerichtet werden.

5. Schalten Sie Enable/Disable ein, lassen Sie Test Mode eingeschaltet, klicken Sie auf Save und führen Sie eine Testbestellung durch. Tragen Sie danach den geheimen Live-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_nets_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 auf derselben Seite in der Liste der installierten Erweiterungen. Klicken Sie daneben auf Install (die grüne +-Schaltfläche).

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

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

Eine neue Installation startet mit ausgeschalteter Zahlungsart und eingeschaltetem Testmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Nets Nexi Gateway > Edit. Die Abschnitte stehen links; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt die Seite, wenn der geheime Schlüssel des gewählten Modus fehlt, zum Beispiel mit Nets Nexi: enter the Test Secret Key — the payment method is hidden at checkout until the key of the selected mode is set., und sie zeigt Nets Nexi is in test mode: payments go to the Nets test environment and no real money is charged., solange der Testmodus eingeschaltet ist. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen, kann sie aber nicht speichern.

Beim Speichern darf Title nicht leer sein (bis zu 128 Zeichen), Sort Order muss eine ganze Zahl sein, Total eine Zahl von 0 oder mehr, und die Geozone und Bestellstatus müssen vorhanden sein. Ist ein Feld fehlerhaft, wird nichts gespeichert.

Nets Nexi (Nordische Länder)

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

Title: der Name der Zahlungsart, der dem Kunden beim Checkout angezeigt wird. Er wird auch als Zahlungsart in der Bestellung gespeichert. Standard: Nets Easy. Pflichtfeld.

Description: der Text, den der Kunde im Schritt Confirm Order sieht. Standard: Pay securely with Nets Easy.

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

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

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

API-Schlüssel

Kopieren Sie die geheimen Schlüssel aus dem Nets-Easy-Portal unter Company > Integration: das Testportal (test.portal.dibspayment.eu) für den Testschlüssel und das Live-Portal (portal.dibspayment.eu) für den Live-Schlüssel. Der Abschnitt verlinkt beide Portale. Die Checkout-Schlüssel werden nicht benötigt.

Test Mode: Der Testmodus verwendet test.api.dibspayment.eu mit dem geheimen Testschlüssel; der Live-Modus verwendet api.dibspayment.eu mit dem geheimen Live-Schlüssel. Erstattungen und Erfassungen einer Bestellung verwenden immer die Umgebung, in der sie bezahlt wurde. Standard: eingeschaltet. Solange er eingeschaltet ist, sehen Kunden im Schritt Confirm Order den Hinweis Test mode: no real money will be charged.

Test Secret Key: Ihr geheimer API-Schlüssel für die Nets-Testumgebung.

Live Secret Key: Ihr geheimer API-Schlüssel für die Nets-Live-Umgebung.

Gespeicherte 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 key on save und klicken Sie auf Save.

Zahlung

Webhooks: Die Nets-Benachrichtigungen (Webhooks) werden bei jeder Zahlung automatisch registriert. Im Nets-Portal ist nichts zu konfigurieren. Das Feld zeigt die Adresse, an die sie gesendet werden. Bei OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_nets_nexi_gateway/webhook, bei OpenCart 4 so: https://your-store/index.php?route=extension/wcp_nets_nexi_gateway/payment/wcp_nets_nexi_gateway.webhook. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet. Ist sie keine öffentliche HTTPS-Adresse, warnt das Feld, dass der Shop keine Webhooks empfängt. Zahlungen werden dann bestätigt, wenn der Kunde in den Shop zurückkehrt, oder mit Nets: check payment status and capture auf der Bestellseite. Folgende Ereignisse werden registriert:

Jeder Webhook muss das zufällige Geheimnis enthalten, das die Erweiterung für diese Zahlung erzeugt hat. Webhooks ohne das richtige Geheimnis werden abgelehnt. Der Webhook teilt der Erweiterung nur mit, welche Zahlung sich geändert hat. Die Zahlung selbst wird immer über die Nets-API mit dem geheimen Schlüssel der Umgebung gelesen, in der sie erfolgte.

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Sie erhält erst dann einen Status, wenn die Zahlung über die Nets-API zurückgelesen wurde (Webhook, Rückkehr des Kunden oder Nets: check payment status and capture auf der Bestellseite) und eine passende Reservierung belastet wurde. Jedes Statusfeld unten listet Ihre OpenCart-Bestellstatus auf.

Order Status After Payment: der Status der Bestellung, sobald Nets die Zahlung bestätigt und belastet hat. Standard: Processing. Wählen Sie Complete, um bezahlte Bestellungen als abgeschlossen zu markieren.

Nets Payment On Hold Status: Der Betrag oder die Währung weicht von der Bestellung ab, die Erfassung ist fehlgeschlagen oder der Kunde hat bezahlt, nachdem die Bestellung storniert wurde. Es wird nichts automatisch erfasst, und eine Notiz erklärt den Grund. Standard: Pending, da OpenCart keinen Status „On hold“ hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Cancelled Status: wird gesetzt, wenn die Reservierung der Bestellung im Nets-Portal storniert wird. Standard: Canceled.

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

Erweitert

Debug log: protokolliert API-Aufrufe und Statusänderungen von Zahlungen in nng_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über den Webbrowser geöffnet werden. Schlüssel und Kundendaten werden nicht protokolliert. Fehler und Warnungen werden immer protokolliert, auch wenn das Protokoll 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 Nets-Zahlungs- und Erstattungsdaten der Bestellungen bleiben immer erhalten. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Geheime Schlüssel 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 Nets Easy). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will be redirected to the Nets payment page to pay securely. OpenCart legt die Bestellung in diesem Schritt an, noch ohne Status. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine Nets-Zahlung über den Bestellbetrag in der Bestellwährung. Die Produkte, der Versand und die übrigen Bestellsummen (Gutscheine, Coupons, Gebühren) werden als Bestellpositionen übergeben. Danach wird der Kunde zur gehosteten Zahlungsseite von Nets geschickt. Bei OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose des Zahlungsartblocks im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order. Die Zahlungsreferenz bei Nets ist die OpenCart-Bestellnummer. E-Mail-Adresse, Name, Lieferadresse und Telefonnummer des Kunden werden an Nets übergeben, sofern Nets deren Format akzeptiert. Die Seite mit den AGB Ihres Shops wird auf der Nets-Seite verlinkt (ist keine gesetzt, die Startseite des Shops).

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn Nets die Zahlung bestätigt: Die Erweiterung liest die Zahlung über die Nets-API, vergleicht den reservierten Betrag und die Währung mit der Bestellung, belastet die Reservierung und setzt erst danach den Bestellstatus. Dies geschieht über den Webhook oder bei der Rückkehr des Kunden, je nachdem, was zuerst eintritt. Die Bestellung erhält ihren Status dann auf die übliche OpenCart-Weise, mit der üblichen Bestell-E-Mail und Bestandsaktualisierung, und der Kunde sieht die Erfolgsseite von OpenCart. Konnte die Zahlung noch nicht bestätigt werden (Nets war nicht erreichbar oder eine andere Anfrage bestätigte sie gerade), zeigt eine Seite Payment confirmation den Hinweis Your Nets payment is being confirmed. Your order will be updated as soon as it is confirmed — please do not pay again. mit den Schaltflächen Check again und Back to checkout.

Bricht der Kunde auf der Nets-Seite ab, kehrt er zur Kasse zurück, mit dem Hinweis The Nets payment was cancelled. You can try again or choose another payment method. Wurde nichts bezahlt, lautet die Meldung The payment was not completed. You can try again or choose another payment method. Auf OpenCart 4 werden diese Meldungen oberhalb der Kassenseite angezeigt. Der Warenkorb bleibt erhalten. 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 bei und bezahlt dieselbe Bestellung erneut mit einer neuen Nets-Zahlung. Bei einem neuen Versuch prüft die Erweiterung zuerst die früheren Zahlungen des Warenkorbs; ist eine davon bereits bezahlt, wird diese Bestellung bestätigt, statt eine neue Zahlung zu starten. Andernfalls werden die früheren Nets-Sitzungen geschlossen, bevor eine neue beginnt. Ist eine andere Bestellung desselben Warenkorbs bereits bezahlt oder angehalten, gelangt der Kunde zur Erfolgsseite.

Auf OpenCart 4 bleibt die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel von Ihnen storniert, auch nachdem die Reservierung im Nets-Portal storniert wurde), 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 Nets zurückkehrt, und das nächste Confirm Order bezahlt eine neue Bestellung. Eine Bestellung des Warenkorbs, die bezahlt und dann storniert oder erstattet wurde, hält den Warenkorb nicht mehr fest.

Kann Nets die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung, zum Beispiel Nets could not start the payment with the details of this order. Please check your address and phone number, or choose another payment method., This payment method is temporarily unavailable. Please choose another payment method. oder The payment service could not be reached. Please try again in a moment. Ein Bestellbetrag von null führt zu The order total must be greater than zero to pay with Nets. Die Details werden im Protokoll festgehalten.

Der Webhook funktioniert auch, wenn 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 Nets zulässt.

Die Erweiterung nutzt nur die gehostete Zahlungsseite. Sie hat keinen eingebetteten Nets-Checkout auf der Seite, keine Abonnements oder wiederkehrenden Zahlungen, keine gespeicherten Karten, keine Rechnungsgebühren, keinen reinen Autorisierungsmodus und keine Teilerfassungen pro Versand.

Bestellungen und Erstattungen

Bestellstatus

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

Order Status After Payment (default Processing): Nets hat die Zahlung bestätigt und belastet. Eine Notiz zeigt die Zahlungs-ID, die Belastungs-ID und die Zahlungsart.

Nets Payment On Hold Status (default Pending): Der Betrag oder die Währung bei Nets weicht von der Bestellung ab (nicht erfasst), die Erfassung wurde abgelehnt, oder der Kunde hat bezahlt, nachdem die Bestellung storniert wurde (reserviert, nicht erfasst). Die Notiz erklärt den Grund. Es wird nichts automatisch erfasst. Nach der Prüfung der Bestellung erfassen Sie mit Nets: check payment status and capture oder stornieren Sie die Reservierung im Nets-Portal.

Cancelled Status (default Canceled): Die Reservierung der Bestellung wurde storniert, zum Beispiel im Nets-Portal.

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

Wenn ein Webhook oder die Rückkehr des Kunden eine Bestellung vom Wartestatus in den Status „bezahlt“ überführt oder sie storniert, benachrichtigt OpenCart den Kunden. Wiederholte Webhooks und Seitenneuladen belasten nie doppelt und fügen keine doppelten Notizen hinzu; eine bezahlte Bestellung wird durch Nets-Ereignisse nie wieder geändert. Wird ein alter Zahlungslink für eine bereits bezahlte Bestellung abgeschlossen oder für eine andere Bestellung desselben Warenkorbs, wird die zweite Reservierung automatisch freigegeben. Wurde sie bereits belastet, bittet eine Notiz Sie, die Erstattung im Nets-Portal vorzunehmen. Wurde die Bestellung auf andere Weise als bezahlt markiert, wird eine reservierte Nets-Zahlung nicht erfasst, und eine Notiz weist darauf hin.

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

Registerkarte VibeFox Nets Nexi Gateway

Öffnen Sie unter Sales > Orders eine Bestellung, die mit Nets bezahlt wurde. Unten auf der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox Nets Nexi Gateway den Block Nets Easy payment: die Zahlungs-ID, die Belastungs-ID, die Umgebung (mit der Bezeichnung Test environment bei Testzahlungen), den Status und die Zahlungsart, die bei Nets reservierten und belasteten Beträge, den Bestellbetrag und den erstatteten Betrag, das Erstattungsformular, den Erstattungsverlauf und die Nets notes der Bestellung. Die Registerkarte wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben; ihre Schaltflächen erfordern das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups).

Nets: check payment status and capture: wird bei Bestellungen angezeigt, die noch nicht bezahlt sind. Diese Schaltfläche liest die Zahlung von Nets und erfasst eine zur Bestellung passende Reservierung, auch nach einer fehlgeschlagenen Erfassung oder nachdem Sie eine angehaltene Bestellung geprüft haben. Ändert sich nichts, erklärt eine Notiz den Grund, zum Beispiel dass der Kunde die Zahlung noch nicht abgeschlossen hat. Ein durch diese Schaltfläche gesetzter Status wird – ebenso wie ein Status durch eine Erstattung – direkt als manuelle Statusänderung vorgenommen, ohne E-Mails und Bestandsbewegungen.

Erstattungen

Geben Sie auf der Registerkarte den Amount ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via Nets. Bestätigen Sie die Abfrage Refund this amount through Nets? This cannot be undone. Vollständige und teilweise Erstattungen sind möglich, sobald die Zahlung belastet wurde, bis zur Höhe des Bestellbetrags. Eine nur reservierte Zahlung kann im Nets-Portal storniert werden. Die Erstattung erfolgt auf die Belastung der Bestellung in der Umgebung, in der die Zahlung erfolgte, daher muss deren geheimer Schlüssel eingetragen sein. Akzeptiert Nets die Erstattung nicht, zeigt die Registerkarte den Fehler, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird mit der Nets-Erstattungs-ID dem Erstattungsverlauf und den Notizen hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf den Refunded Status; eine teilweise Erstattung ändert den Status nicht.

Produktrücksendungen unter Sales > Returns zahlen über Nets kein Geld zurück. Erstattungen, die im Nets-Portal vorgenommen werden, werden nicht synchronisiert; aktualisieren Sie die Bestellung bei Bedarf manuell.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Nets Nexi Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Nets Nexi 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-nets-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 Nets 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. Bei OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Admin-Anmeldung nicht, daher ist 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 Erstattungen funktionieren.

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

Nets Nexi erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und der gewählte Modus einen geheimen Schlüssel hat: Test Secret Key im Testmodus, Live Secret Key im Live-Modus. Die Einstellungsseite zeigt eine Warnung, wenn der Schlüssel fehlt. 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: Der Webhook hat Ihren Shop nicht erreicht. Prüfen Sie, ob der Shop HTTPS verwendet, sodass die Adresse unter Webhooks eine öffentliche HTTPS-Adresse ist, und ob der geheime Schlüssel der Umgebung der Zahlung eingetragen ist. Die Bestellung erhält ihren Status auch, wenn der Kunde nach der Zahlung in den Shop zurückkehrt, oder mit Nets: check payment status and capture auf der Registerkarte der Bestellung.

Der Webhook antwortet Unauthorized: Der Webhook enthielt nicht das Geheimnis dieser Zahlung. Webhooks werden nur mit dem bei der Zahlung registrierten Geheimnis akzeptiert.

Der Webhook antwortet Unknown payment: Die Zahlung wurde nicht von diesem Shop erstellt.

Der Webhook antwortet Busy, retry later, Payment lookup failed oder Payment not reserved yet: Eine andere Anfrage bestätigte gerade denselben Warenkorb, die Nets-API war nicht erreichbar, oder die Reservierung war noch nicht sichtbar. Nets wiederholt den Webhook automatisch.

Der Webhook antwortet Order could not be updated, retry later: Der Bestellstatus konnte nicht gesetzt werden. Nets wiederholt den Webhook. Schalten Sie das Debug log ein, um den Grund zu sehen.

Die Webhook-URL zeigt im Browser Method not allowed: Das ist normal. Die Adresse akzeptiert nur Anfragen von Nets.

Der Kunde sieht nach Confirm Order einen Fehler: Schalten Sie das Debug log ein und sehen Sie im Feld Log auf der Seite der Erweiterung nach. This payment method is temporarily unavailable. Please choose another payment method. deutet meist auf einen falschen oder fehlenden geheimen Schlüssel hin. Eine abgelehnte Währung meldet Nets im Protokoll. This payment method is not available. bedeutet, dass die Kassensitzung nicht mehr zur Bestellung passt oder die Zahlungsart inzwischen ausgeschaltet wurde: Der Kunde lädt die Kasse neu.

Der Kunde sieht We could not match this payment to an order: Der Rücksprunglink ist unvollständig oder gehört zu einer anderen Bestellung. Wurde der Kunde belastet, suchen Sie die Zahlung im Nets-Portal und prüfen Sie die Bestellung.

Die Bestellung steht nach der Zahlung im Status „angehalten“: Lesen Sie die Nets notes auf der Registerkarte. Wurde die Erfassung abgelehnt, versuchen Sie es erneut mit Nets: check payment status and capture oder belasten Sie die Zahlung im Nets-Portal. Weichen Betrag oder Währung ab, prüfen Sie die Zahlung im Nets-Portal. Hat der Kunde nach der Stornierung bezahlt, prüfen Sie die Bestellung und erfassen oder stornieren Sie die Reservierung.

Refund via Nets fehlt oder schlägt fehl: Erstattungen sind nur möglich, nachdem die Zahlung belastet wurde; die Registerkarte zeigt dann eine Belastungs-ID. Eine Erstattung verwendet den geheimen Schlüssel der Umgebung, in der die Bestellung bezahlt wurde. Dieser Schlüssel muss eingetragen sein; andernfalls zeigt die Registerkarte an, welcher Umgebungsschlüssel fehlt.

Für Entwickler: Bevor die Zahlung erstellt wird, löst die Erweiterung das OpenCart-Ereignis nng_create_payment_payload mit dem Anfragetext und der Bestellung aus; nng_currency_decimals ändert die Nachkommastellen einer Währung.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Nets Nexi 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 Bestellstatus des Abschnitts Payment, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Bei OpenCart 4 werden außerdem die Ereignisse der Erweiterung und ihre Startaktion entfernt, die den Webhook im Wartungsmodus durchlässt. Ist Delete Data on Uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Testmodus, geheime Schlüssel, Protokollierung) und das Protokoll entfernt. Ist es ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die Nets-Zahlungsdaten der Bestellungen (Zahlungen, Belastungen und Erstattungen) bleiben immer erhalten, sodass früher bezahlte Bestellungen nach einer Neuinstallation weiterhin erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

Nets, Nets Easy und Nexi sind Marken ihrer jeweiligen Inhaber. Diese Erweiterung ist nicht mit Nets oder Nexi verbunden und wird von diesen nicht unterstützt.