Das nexi Paygate für OXID 6 ermöglicht die Anbindung von OXID 6 an die nexi Plattform. Das Plugin unterstützt die Abwicklung nachfolgender Zahlungsarten:

Kredit- und Debitkarten inkl. 3D Secure

• Visa, MasterCard, American Express

Online-Überweisung

• iDeal (direkt oder via PPRO)
• Klarna

Wallet

• Amazon Pay
• PayPal Standard
• PayPal Express

Lastschrift

• Ratepay
• SEPA-Lastschrift
• Klarna

Rechnungskauf

• Ratepay

Ratenkauf

• Klarna

Für die Verwendung des OXID 6 nexi Paygates sind folgende Systemvorrausetzungen notwendig:

• Installierter und lauffähiger OXID eShop ab Version 6.3 bis Version 6.5
• nexi Händlerkonto und je nach verwendeten Zahlarten, Konten bei den Zahlungsanbietern wie z.B. Paypal
• PHP Version ab 7.3 bis 8.1
• Shop muss mit einem SSL-Zertifikat laufen und die https-Adresse muss in der Shop-Config hinterlegt sein
• Für automatische Zahlungsstatus-Updates muss der Shop extern erreichbar sein
• Der Server, auf dem das OXID 6 nexi Paygate für den OXID eShop genutzt werden soll, muss selbstverständlich den OXID Server- und Systemvoraussetzungen entsprechen:
  https://docs.oxid-esales.com/eshop/de/6.3/installation/neu-installation/server-und-systemvoraussetzungen.html

nexi sendet zur Validierung von Transaktionen Requests an Ihren OXID eShop.

Damit solche Callback Aufrufe von nexi an Ihren Shop erfolgen können, muss Ihr Shop frei von draußen über das Internet erreichbar sein. Das heißt, es darf weder einen Passwortschutz, noch eine IP-Sperre oder einen Firewallschutz in Ihrem Shop aktiv sein, der nexi daran hindert, die entsprechenden Informationen an den Shop zu senden.

Denken Sie insbesondere daran, wenn Sie in Ihrer Entwicklungs- oder Stage-Umgebung testen wollen: HTTPS-Aufrufe von den externen Klarna Servern auf Port 443 Ihres Servers müssen erlaubt sein.

Es gibt 2 Möglich Wege für die Installation des OXID 6 nexi Paygates.

Führen Sie die nachfolgenden Schritte aus:

• Loggen Sie sich auf die Kommandozeile (CLI) ein und navigieren Sie zum Rootverzeichnis des Shops
• Führen Sie folgende Befehle nacheinander aus:

  composer require fatchip-gmbh/nexi-payments-ox6

Führen Sie die nachfolgenden Schritte aus:

• Laden Sie aus der Liste der verfügbaren Releases eine Version von GitHub herunter:GitHub Releases
• Erstellen Sie den Ordner „fatchip-gmbh“ im Ordner „source/modules“ der Oxid 6-Installation.
• Erstellen Sie den Ordner „nexi_payments“ im neuen Ordner „source/modules/fatchip-gmbh“ der Oxid 6-Installation.
• Kopieren Sie den Inhalt des heruntergeladenen Releases in den neu erstellten Ordner „nexi_payments“.
• Editieren Sie die Datei composer.json im Basisordner des Shops. Fügen Sie die Autoload-Konfiguration hinzu oder erweitern diese, falls bereits vorhanden:

       "autoload": {
         "psr-4": {
             "Fatchip\\ComputopPayments\\": "./source/modules/fatchip-gmbh/nexi_payments/src",
             "Fatchip\\CTPayment\\" : "./source/modules/fatchip-gmbh/nexi_payments/lib/CTPayment"
         }
       },

• Stellen Sie über eine Konsole eine SSH Verbindung zu Ihrem Server her, navigieren Sie zum Shop-Basisordner und führen Sie den folgenden Befehl aus, um die Autoloader-Dateien neu zu generieren:

     vendor/bin/composer dump-autoload

• Sie müssen nun die Modulkonfiguration importieren. Loggen Sie sich hierzu per SSH auf dem Server ein, auf dem die Shopinstallation liegt. Navigieren Sie in das Verzeichnis, in dem die Ordner source und vendor liegen. Führen Sie nun folgende Befehle aus:

     vendor/bin/oe-console oe:module:install-configuration source/modules/fatchip-gmbh/nexi_payments/
     vendor/bin/oe-console oe:module:apply-configuration

  Sie sollten 2 Ausgaben erhalten:

  Module configuration has been installed.

  und

  Applying configuration for module with id fatchip_nexi_payments

Die aktuelle Versionsnummer des OXID 6 nexi Paygate erhalten Sie unter https://github.com/FATCHIP-GmbH/plugin-oxid6-nexi/releases
Für Plugin-Updates können Sie auch unseren Twitter-Account: https://twitter.com/fatchip folgen.

Um das OXID 6 nexi Paygate zu aktualisieren, müssen Sie die nachfolgenden Schritte ausführen:

• Loggen Sie sich per sFTP/FTP auf Ihren Server ein und wechseln Sie in das Rootverzeichnis des Shops
• Öffnen Sie die composer.json und ändern Sie die angegebene Version auf die Version, auf die Sie aktualisieren möchten
  
• Loggen Sie sich auf die Kommandozeile (CLI) ein und navigieren Sie zum Rootverzeichnis des Shops
• Führen Sie den folgenden Befehl aus:

  composer update

• Loggen Sie sich in den Admin Ihres OXID eShops ein
• Rufen Sie das Plugin unter Erweiterungen → Module auf
• Deaktivieren Sie das Plugin und Aktivieren Sie es wieder

Um das OXID 6 nexi Paygate zu aktualisieren, müssen Sie die nachfolgenden Schritte ausführen:

• Laden Sie sich das neue Release des Plugins herunter
• Entfernen Sie alle Dateien im Ordner „source/modules/fatchip-gmbh/nexi_payments“
• Kopieren Sie den Inhalt des heruntergeladenen Releases auf Ihren Server in Ordner „source/modules/fatchip-gmbh/nexi_payments“
• Stellen Sie über eine Konsole eine SSH Verbindung zu Ihrem Server her, navigieren Sie zum Shop-Basisordner und führen Sie den folgenden Befehl aus, um die Autoloader-Dateien neu zu generieren:

     vendor/bin/composer dump-autoload

• Sie müssen nun die Modulkonfiguration importieren. Loggen Sie sich hierzu per SSH auf dem Server ein, auf dem die Shopinstallation liegt. Navigieren Sie in das Verzeichnis, in dem die Ordner source und vendor liegen. Führen Sie nun folgende Befehle aus:

     vendor/bin/oe-console oe:module:install-configuration source/modules/fatchip-gmbh/nexi_payments/
     vendor/bin/oe-console oe:module:apply-configuration

  Sie sollten 2 Ausgaben erhalten:

  Module configuration has been installed.

  und

  Applying configuration for module with id fatchip_nexi_payments

• Rufen Sie das Plugin unter Erweiterungen → Module auf
• Deaktivieren Sie das Plugin und Aktivieren Sie es wieder

Im eShop Admin Haupt-Menü taucht die neue Rubrik „nexi“ links mit mehreren Unter-Menüeinträgen auf:

oder auch unter „Erweiterung“ → „Module“ → „nexi Paygate“ → Reiter „Einstellungen“

Aktivieren Sie die neu erstellten nexi-Zahlungsarten unter „Shopeinstellungen“ → „Zahlungsarten“ indem Sie die entsprechende Zahlungsart auswählen und die „Aktiv“-Checkbox setzten.

Ordnen Sie die neu erstellten nexi-Zahlungsarten unter „Shopeinstellungen“ → „Versandarten“ den entsprechenden Versandarten zu, so wie Sie es auch für andere Zahlungsarten im OXID eShop machen würden.

Im OXID eShop Adminbereich unter nexi → API finden Sie alle Logeinträge zu den Requests, Responses und Notifies.

Sollten Sie Fragen zum Plugin und zu Ihrem Merchantkonto haben, wenden Sie sich bitte an den nexi Helpdesk helpdesk@nexi.com.