Schnelle Einrichtung

Diese Anleitung beschreibt eine schnelle Installation des Novalnet-Zahlungsplugins (diese Anleitung wird mit dem Plugin geliefert), um es in Ihr Shopsystem zu integrieren und damit zu beginnen, Zahlungen weltweit anzunehmen. Für diese Einbindung benötigen Sie einen Novalnet-Händleraccount, um Zahlungen über Novalnet entgegenzunehmen. Stellen Sie deshalb sicher, dass Sie Ihre Händler-Kontodaten von unserem Sales-Team erhalten haben. Wenn nicht, schicken Sie bitte eine E-Mail an sales@novalnet.de

Laden Sie die neueste Version des Novalnet-Plugins herunter, um auf Ihrer WooCommerce-Website mit Novalnet anzufangen:

Um anzufangen:

1. Loggen Sie sich in das Novalnet Admin-Portal mit den Daten Ihres Händlerkontos ein (Nutzer-Zugangsdaten)
2. Loggen Sie sich in Ihr WooCommerce-Shopsystem ein.
3. Stellen Sie sicher, dass Sie das Paket mit dem Zahlungsplugin aus der Zip-Datei extrahiert haben, welche Sie empfangen haben. Falls Sie nur die Installationsanleitung ohne das Paket mit dem Zahlungsmodul erhalten haben, schicken Sie uns bitte eine Mail an technic@novalnet.de mit Ihrer Händler-ID.

Installation des Plugins

Um das Novalnet-Zahlungsplugin zu installieren, gehen Sie bitte zu Ihrem Shopsystem und befolgen die Schritte unten.

Schritt 1: Gehen Sie zu Plugins -> Installieren im Admin-Panel Ihres Shops wie unten gezeigt

Schritt 2:Neben Plugins hinzufügen klicken Sie auf Plugin hochladen.

Schritt 3:In dem nächsten Fenster, das erscheint, klicken Sie auf Datei auswählen und wählen die Datei woocommerce-novalnet-gateway.zip aus, welche im Novalnet Woocommerce-Plugin-Paket beinhaltet ist. Klicken Sie auf Jetzt installieren um diese wie unten angezeigt in Ihr Shopsystem hochzuladen

Schritt 4: Klicken Sie nach der Installation auf Plugin aktivieren wie unten angezeigt

Aktualisierung des Novalnet-Zahlungsplugins

Befolgen Sie die Schritte unten, um das Novalnet Zahlungsplugin - WooCommerce über das Admin-Panel des Shops auf die neueste Version zu aktualisieren.

Schritt 1: Gehen Sie zu Plugins -> Installierte Plugins im Admin-Panel Ihres Shops wie unten angezeigt

Schritt 2: Unter dem Novalnet-Zahlungsplugin -> WooCommerce, klicken Sie jetzt auf Update wie unten angezeigt

Jetzt wird die aktualisierte Version des Novalnet Zahlungsplugin -> WooCommerce angezeigt, wie unten dargestellt

Schritt 3: Nachdem Sie das Novalnet Zahlungsplugin – WooCommerce installiert oder aktualisiert haben, klicken Sie auf Konfiguration wie unten angezeigt

Sehen Sie sich dem Abschnitt Novalnet Haupteinstellungen an, um die Details Ihres Novalnet-Händleraccounts einzurichten.

Globale Einstellungen im Shopsystem WooCommerce

Die Einrichtung findet hauptsächlich in Ihrem WooCommerce Shopsystem statt sowie im Novalnet Admin-Portal.

Gehen Sie in Ihrem WooCommerce-Shopsystem zu WooCommerce -> Einstellungen -> Novalnet Haupteinstellungen. Geben Sie die folgenden Schlüssel ein, wie unten angezeigt:

• Aktivierungsschlüssel des Produkts - ein eindeutiges Token für die Authentifizierung des Händlers und die Verarbeitung von Zahlungen.
• Zahlungs-Zugriffsschlüssel - ein geheimer, jedem Händler zugewiesener Schlüssel welcher Daten verschlüsselt, um Manipulation durch Nutzer und Betrug zu verhindern.
• Auswahl der Tarif-ID - ein eindeutiger Bezeichner, der auf der Grundlage des Tariftyps bei Novalnet angelegt wird.

Um Ihren Aktivierungsschlüssel des Produkts und Ihren Zahlungs-Zugriffsschlüssel zu erhalten, gehen Sie zum Novalnet Admin-Portal , und dort zum Menüpunkt Projekte, wo Sie auf das Icon rechts von Ihrem entsprechenden Projekt klicken, um die Projektdetails anzusehen.

Klicken Sie auf API-Anmeldeinformationen und kopieren Sie API Signature (Aktivierungsschlüssel des Produkts) und den Paymentzugriffsschlüssel. Legen Sie eine Tarif-ID für jeden Tariftyp im Webshop an.

Fügen Sie den Aktivierungsschlüssel des Produkts und den Paymentzugriffsschlüssel in den jeweiligen Feldern in Ihrem Shopsystem ein. Als nächstes wählen Sie die Tarif-ID aus dem Drop-Down-Menü aus, welches Sie im Novalnet Admin-Portal für dieses WooCommerce-Shopsystem erstellt haben.

Klicken Sie dann auf um die Änderungen zu übernehmen.

Einrichtung von Benachrichtigungen / des Webhooks im Novalnet Admin-Portal

Auf der Seite Novalnet Haupteinstellungenin Ihrem Shopsystem finden Sie Ihren Benachrichtigungs- / Webhook-URL unter Benachrichtigungs- / Webhook-URL festlegen wie unten angezeigt

Klicken Sie auf Konfigurieren um Ihren URL für Benachrichtigungen / Webhook-URL im Novalnet Admin-Portal einzurichten, wie unten angezeigt

Nach der erfolgreichen Einrichtung ist der Webhook-URL Ihres Shops mit Ihrem Novalnet-Händler-Account verknüpft, wie Sie in dem Feld Händlerskript-URL / Notifikation & Webhook -URL unter dem Reiter API-Anmeldeinformationen sehen können, wie unten angezeigt

In Ihrem Shopsystem können Sie zusätzlich den Webhook-URL manuell testen und Benachrichtigungs-E-Mails an bestimmte E-Mail-Adressen schicken, wie unten angezeigt

• Webhook-URL - Notwendig, um die Datenbank / das System des Händlers aktuell und mit Novalnet synchron zu halten (zum Beispiel: Lieferung des aktuellen Transaktionsstatus).
• Manuelles Testen der Benachrichtigungs / Webhook-URL erlauben - Aktivieren Sie dies, um den Benachrichtigungs- / Webhook-URL von Novalnet manuell zu testen. Deaktivieren Sie dies bitte, bevor Sie Ihr Shopsystem live schalten, um unautorisierte Aufrufe von externen Parteien zu blockieren.
• E-Mails senden an - Bei jeder Ausführung wird eine Nachricht an die E-Mail-Adresse in diesem Feld geschickt.

Einrichtung des Client-Key im Novalnet Admin-Portal

Der Client-Key ist ein eindeutiger Schlüssel welcher mit Ihrem Novalnet Händlerkonto verbunden ist, um Ihre Aufrufe von Kundenseite aus zu authentifizieren. Sie benötigen den Kundenschlüssel, um das sichere Zahlungsformular anzuzeigen und (zeitweise) sensible Informationen zu tokenisieren.

Schritt 1: Gehen Sie mit den Details Ihres Novalnet-Händleraccounts zum Novalnet Admin-Portal.

Schritt 2: Gehen Sie zum Menüpunkt Projekte und wählen Sie Ihr Projekt wie unten angezeigt.

Schritt 3: Auf der Seite mit den Projektdetails klicken Sie auf API-Anmeldeinformationen und klicken Sie auf neben Erlaubte Domäne(n) wie unten angezeigt

Schritt 4: Fügen Sie die URL Ihrer Website in das Feld Domainname ein und klicken Sie auf +Hinzufügen wie unten angezeigt

Schritt 5: Nachdem Sie den Domainname hinzugefügt haben, wird er unter Erlaubte Domäne(n) aufgelistet, wie unten angezeigt

Aktivierung von Zahlungsarten im Novalnet Admin-Portal

Alle durch Novalnet unterstützten Zahlungsarten können hier angesehen werden: https://www.novalnet.de/zahlungsarten. Wenn Sie Fragen zu den Zahlungsarten haben oder zusätzliche Zahlungsarten wünschen, kontaktieren Sie bitte unser Sales-Team.

Um die bevorzugten Zahlungsarten für Ihre Website zu aktivieren, gehen Sie zum Novalnet Admin-Portal -> Projekte -> Wählen Sie Ihr Projekt -> Zahlungsmethoden -> und klicken Sie auf Zahlungsmethoden bearbeiten in der Ecke oben rechts wie unten angezeigt.

Wählen Sie jetzt die bevorzugten Zahlungsarten aus und klicken Sie auf Aktualisieren, um diese wie unten angezeigt zu aktivieren

Um die Zahlungsart Apple Pay einzusetzen, gehen Sie zu Apple Pay -> Konfigurieren -> Neue Domain hinzufügen im Novalnet Admin-Portal wie unten angezeigt.

Dann fügen Sie die Domain Ihres Shops ein, für welchen Sie Apple Pay aktivieren und klicken sie auf Verifizierungs-Datei herunterladen. Sie müssen diese Verifizierungsdatei im Hauptverzeichnis Ihrer Domain unterbringen.

Der Pfad sollte zum Beispiel so aussehen: https://woocommerce.novalnet.de/.well-known/apple-developer-merchantid-domain-association

Um die Zahlungsart PayPal einzusetzen, richten Sie die Details zur PayPal-API im Novalnet Admin-Portal ein, wie unten angezeigt

Um die PostFinance-Zahlungsarten einzusetzen, richten Sie die Daten zur Ep2-Händler-ID im Novalnet Admin-Portal ein, wie unten angezeigt

Konfiguration von Zahlungsarten im Shopsystem WooCommerce

Bald nach der Aktivierung der Zahlungsarten im Novalnet Admin-Portal, müssen Sie diese Zahlungsarten in Ihrem Shopsystem aktiveren, um sie auf Ihrer WooCommerce-Checkout-Seite anzuzeigen. Gehen Sie zu WooCommerce -> Einstellungen wie unten angezeigt

Auf der Seite mit den Einstellungen klicken Sie auf den Reiter Zahlungen wie unten angezeigt und dann neben der jeweiligen Zahlungsart auf Verwalten

Klicken Sie auf Zahlungsart aktivieren um die bevorzugten Zahlungsarten zu aktivieren, wie unten angezeigt

Sehen Sie sich das Kapitel ZUSÄTZLICHE KONFIGURATION mit weiteren Einstellungen zu Zahlungen an.

• Falls Sie Empfehlungen oder Verbesserungsvorschläge für uns haben, teilen Sie uns Ihre Überlegungen bitte an technic@novalnet.de mit oder rufen Sie uns unter +49 89 9230683-19 an.
• Sind Sie glücklich mit unserem Service und unserer Unterstützung? Wenn ja, nehmen Sie sich einige Minuten, um Ihren Erfolg hier zu teilen.

Deinstallation

Um das Novalnet-Zahlungsplugin zu deinstallieren, befolgen Sie bitte die Schritte unten.

Schritt 1: Gehen Sie zu Plugins -> Installierte Plugins wie unten angezeigt

Schritt 2: Unter dem Plugin Novalnet Zahlungsplugin – WooCommerce, klicken Sie auf Deaktivieren wie unten angezeigt

Schritt 3: Nach der Deaktivierung klicken Sie auf Löschen.

Schritt 4: Klicken Sie auf OK, um zu bestätigen, dass Sie das Novalnet Zahlungsplugin dauerhaft aus Ihrem Shopsystem deinstallieren und löschen wollen.