VibeFox Nets Nexi for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

WooCommerce: 7.0 oder neuer, installiert und aktiv. Ohne WooCommerce lässt sich das Plugin nicht aktivieren.

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: Das Plugin beschränkt weder Währungen noch Länder. Verwenden Sie die in Ihrem Nets-Konto aktivierten Währungen; eine nicht unterstützte Währung meldet Nets beim Anlegen der Zahlung. Welche Zahlungsarten der Kunde sieht, hängt von Ihrem Nets-Vertrag, dem Land und der Währung ab.

HTTPS für Webhooks: Nets ruft nur öffentliche HTTPS-Adressen mit höchstens 256 Zeichen ohne „&“ auf. Ihre Website benötigt daher HTTPS und saubere Permalinks, um Webhooks zu empfangen. Auf anderen Websites wird die Zahlung bestätigt, wenn der Kunde zum Shop zurückkehrt, oder über die Bestellaktion.

VibeFox-Lizenzschlüssel: Erwerb über vibefox.net. Ein Schlüssel gilt für eine Domain.

Installation

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

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Nets Nexi (Nordics) > Manage, oder klicken Sie auf der Plugins-Seite unter dem Plugin-Namen auf Settings.

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

5. Kopieren Sie den geheimen Testschlüssel aus dem Nets-Easy-Testportal und fügen Sie ihn in Test Secret Key ein (siehe Konfiguration).

6. Aktivieren Sie Enable/Disable, lassen Sie Test Mode eingeschaltet und legen Sie eine Testbestellung an. Geben Sie danach den geheimen Live-Schlüssel ein und entfernen Sie das Häkchen bei Test Mode.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Nets Nexi (Nordics). Oberhalb der Felder warnt die Seite, wenn der geheime Schlüssel des gewählten Modus fehlt (die Zahlungsart wird dann an der Kasse ausgeblendet), und zeigt Nets Nexi is in test mode: payments go to the Nets test environment and no real money is charged., solange der Testmodus aktiv ist. In der Liste der Zahlungsarten ist Nets Nexi als einrichtungsbedürftig markiert, bis der gewählte Modus einen geheimen Schlüssel hat.

Allgemein

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

Title: der Titel der Zahlungsart, der Kunden an der Kasse angezeigt wird. Standard: Nets Easy.

Description: die Beschreibung der Zahlungsart, die Kunden an der Kasse angezeigt wird. Standard: Pay securely with Nets Easy.

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. Die Checkout-Schlüssel werden nicht benötigt.

Test Mode: Enable 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: an.

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.

Zahlung

Nets-Benachrichtigungen (Webhooks) werden bei jeder Zahlung automatisch registriert. Im Nets-Portal ist nichts zu konfigurieren. Dieser Abschnitt zeigt die Webhook-URL. Sie sieht etwa so aus: https://your-site/wc-api/nng_nets_nexi/. Ist die URL keine öffentliche HTTPS-Adresse, warnt Sie der Abschnitt, dass die Website keine Webhooks empfängt; Zahlungen werden dann bestätigt, wenn der Kunde zum Shop zurückkehrt, oder über die Bestellaktion Nets: check payment status and capture. Folgende Ereignisse werden registriert:

Jeder Webhook muss das zufällige Geheimnis enthalten, das das Plugin für die Bestellung erzeugt hat. Webhooks ohne das korrekte Geheimnis werden abgelehnt. Der Webhook teilt dem Plugin nur mit, welche Zahlung sich geändert hat: Die Zahlung selbst wird immer über die Nets-API mit Ihrem geheimen Schlüssel abgerufen.

Order Status After Payment: der Status der Bestellung, sobald Nets die Zahlung bestätigt und abgebucht hat. Der Status wird sofort gesetzt, sodass der Kunde nur eine E-Mail erhält.

Erweitert

Debug log: Enable debug logging protokolliert API-Aufrufe und Zahlungsstatusänderungen in WooCommerce > Status > Logs, Quelle wcp_nets_nexi_gateway. Fehler werden immer protokolliert. Schlüssel und Kundendaten werden nicht protokolliert. Standard: aus.

Delete Data on Uninstall: Delete the plugin settings and logs when the plugin is deleted. Das Deaktivieren des Plugins löscht nie etwas. Zahlungsdaten, die in Bestellungen gespeichert sind, bleiben immer erhalten. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsart (standardmäßig Nets Easy) und gibt die Bestellung auf. Das Plugin legt eine Nets-Zahlung mit den Bestellpositionen, Versand und Gebühren in der Bestellwährung an und leitet den Kunden auf die gehostete Zahlungsseite von Nets weiter. E-Mail-Adresse, Name, Anschrift und Telefonnummer des Kunden werden an Nets übergeben, sofern Nets deren Format akzeptiert; Ihre Seite mit den Geschäftsbedingungen wird auf der Nets-Seite verlinkt. Im Testmodus zeigt die Kasse Test mode: no real money will be charged.

Der Kunde bezahlt und kehrt zur Bestellbestätigungsseite Ihres Shops zurück. Die Bestellung wird erst als bezahlt markiert, nachdem Nets die Zahlung bestätigt hat: Das Plugin ruft die Zahlung über die Nets-API ab, vergleicht den reservierten Betrag und die Währung mit der Bestellung, bucht die Reservierung ab und schließt die Bestellung erst danach ab. Dies geschieht über den Webhook, bei der Rückkehr des Kunden zur Bestellbestätigungsseite oder über die Bestellaktion Nets: check payment status and capture.

Bricht der Kunde auf der Nets-Seite ab, kehrt er zur Kasse oder zur Seite Pay for order zurück und sieht die Meldung The Nets payment was cancelled. You can try again or choose another payment method. Ein Kunde kann eine unbezahlte Bestellung erneut bezahlen. Das Plugin prüft zuerst die vorherige Zahlung; ist sie bereits bezahlt, wird die Bestellung bestätigt. Andernfalls wird die vorherige Nets-Sitzung geschlossen, bevor eine neue beginnt. Wird eine Zahlung zur Prüfung durch Sie zurückgehalten, sieht der Kunde A payment for this order is already being reviewed by the shop. Please contact us instead of paying again.

Kann Nets die Zahlung nicht starten, sieht der Kunde eine kurze 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. oder The payment service could not be reached. Please try again in a moment. Die Details werden im Protokoll festgehalten.

Die Zahlungsart funktioniert an der klassischen Kasse, im Checkout-Block und auf der Seite Pay for order. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Das Plugin nutzt ausschließlich die gehostete Zahlungsseite. Es bietet keinen eingebetteten Nets-Checkout auf der Seite, keine Abonnements oder wiederkehrenden Zahlungen, keine gespeicherten Karten, keine Rechnungsgebühren, keinen Modus „nur autorisieren“ und keine Teilerfassungen pro Versand.

Bestellungen und Erstattungen

Bestellstatus

Pending payment: Der Kunde wurde zu Nets weitergeleitet und hat noch nicht bezahlt. Die Bestellnotiz zeigt die Nets-Zahlungs-ID, den Betrag und die Umgebung.

Processing or Completed: Nets hat die Zahlung bestätigt und abgebucht. Der Status richtet sich nach Order Status After Payment. Die Bestellnotiz zeigt die Zahlungs-ID, die Abbuchungs-ID und die Zahlungsart. Die Transaktions-ID ist die Nets-Zahlungs-ID.

On hold: Betrag oder Währung bei Nets weichen von der Bestellung ab (nicht erfasst), die Erfassung wurde abgelehnt, oder der Kunde hat bezahlt, nachdem die Bestellung storniert worden war (reserviert, nicht erfasst). Die Bestellnotiz erklärt dies. Nach Prüfung der Bestellung erfassen Sie mit der Bestellaktion Nets: check payment status and capture oder stornieren die Reservierung im Nets-Portal.

Cancelled: Die Reservierung der letzten Zahlung der Bestellung wurde storniert, zum Beispiel im Nets-Portal.

Wiederholte Webhooks und Neuladen belasten nie doppelt und erzeugen keine doppelten Notizen, Lagerbuchungen oder E-Mails; eine Bestellung, die nach der Zahlung bezahlt, erstattet oder storniert wurde, wird nie wieder geöffnet. Wird ein alter Zahlungslink für eine bereits bezahlte Bestellung abgeschlossen, wird die zweite Reservierung automatisch freigegeben; wurde sie bereits abgebucht, fordert eine Notiz Sie auf, sie im Nets-Portal zu erstatten.

Bestellaktion

Für unbezahlte Bestellungen mit einer Nets-Zahlung enthält die Liste der Bestellaktionen Nets: check payment status and capture. Sie liest die Zahlung von Nets und erfasst eine passende Reservierung. Ändert sich nichts, erklärt eine Notiz den Grund, zum Beispiel dass der Kunde die Zahlung noch nicht abgeschlossen hat.

Erstattungen

Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via Nets Easy (die Schaltfläche verwendet den Titel der Zahlungsart). Vollständige und teilweise Erstattungen sind möglich, sobald die Zahlung abgebucht wurde; eine nur reservierte Zahlung kann im Nets-Portal storniert werden. Die Erstattung erfolgt auf die Abbuchung der Bestellung in der Umgebung, in der bezahlt wurde. Akzeptiert Nets die Erstattung nicht, zeigt WooCommerce den Fehler an, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird mit der Nets-Erstattungs-ID den Bestellnotizen hinzugefügt.

Direkt im Nets-Portal vorgenommene Erstattungen werden nicht zu WooCommerce-Erstattungen. Erstellen Sie bei Bedarf eine manuelle Erstattung in WooCommerce ohne Refund via Nets Easy.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzbereich befindet sich oben unter WooCommerce > Settings > Payments > Nets Nexi (Nordics). Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Bereich 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 den Domain-Platz nicht frei. Geben Sie ihn in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Nets Nexi Kunden an der Kasse nicht angezeigt. Wird dennoch eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Angemeldete Shop-Manager sehen die Zahlungsart weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Ein Hinweis erscheint auf der Plugins-Seite und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren weiterhin.

Läuft eine Lizenz ab, arbeitet das Plugin weiter, für Updates und Support ist aber eine Verlängerung nötig. Der Status wird automatisch im Hintergrund erneut geprüft.

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.

Die Zahlung ist erfolgt, aber die Bestellung bleibt auf Pending payment: Der Webhook hat Ihren Shop nicht erreicht. Prüfen Sie, ob die Website HTTPS und saubere Permalinks verwendet, sodass die Webhook-URL im Abschnitt Payment eine öffentliche HTTPS-Adresse ohne „&“ ist, und ob der geheime Schlüssel der Umgebung der Zahlung hinterlegt ist. Verwenden Sie danach die Bestellaktion Nets: check payment status and capture. Die Bestellung wird auch bestätigt, wenn der Kunde zur Bestellbestätigungsseite zurückkehrt.

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

Webhook answers Busy, retry later, Payment lookup failed oder Payment not reserved yet: Eine andere Anfrage hat die Bestellung gerade aktualisiert, die Nets-API war nicht erreichbar, oder die Reservierung war noch nicht sichtbar. Nets wiederholt den Webhook automatisch.

Der Kunde sieht beim Bestellen einen Fehler: Aktivieren Sie Debug log und sehen Sie unter WooCommerce > Status > Logs, Quelle wcp_nets_nexi_gateway, nach. This payment method is temporarily unavailable. Please choose another payment method. bedeutet meist einen falschen oder fehlenden geheimen Schlüssel. Eine abgelehnte Währung meldet Nets im Protokoll.

Order is On hold after payment: Lesen Sie die Bestellnotiz. Wurde die Erfassung abgelehnt, versuchen Sie es mit der Bestellaktion Nets: check payment status and capture erneut oder buchen Sie im Nets-Portal ab. 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 Easy fehlt oder schlägt fehl: Erstattungen sind erst möglich, nachdem die Zahlung abgebucht wurde. Prüfen Sie die Bestellnotiz auf die Abbuchung. Eine Erstattung verwendet den geheimen Schlüssel der Umgebung, in der die Bestellung bezahlt wurde; dieser Schlüssel muss daher hinterlegt sein.

The license block shows an error: Folgen Sie der Meldung im Lizenzbereich. 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

Das Deaktivieren des Plugins behält alle Daten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Lizenzschlüssel und Lizenzstatus dieses Plugins werden immer entfernt. Die Gateway-Einstellungen und die Protokolle werden nur entfernt, wenn Delete Data on Uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

Nets, Nets Easy und Nexi sind Marken ihrer jeweiligen Eigentümer. Dieses Plugin ist nicht mit Nets oder Nexi verbunden und wird von keinem der beiden unterstützt.