Benutzer-Werkzeuge

Webseiten-Werkzeuge


public:oxid7-fatchipctpayment


Installations-und Konfigurationsanleitung für OXID 7

Modul-Version 1.0.0 – Stand 12.12.2024
Modulname Computop Payment Connector für den OXID eShop 7
Modulkategorie Bezahlmethoden / Payments
Dieses Modul fügt dem OXID eShop zusätzliche Zahlungsarten hinzu.
Modulanbieter COMPUTOP PAYGATE GMBH - Schwarzenbergstrasse 4 - 96050 Bamberg www.computop.com
Entwicklung des Moduls Fatchip GmbH www.fatchip.de Mail: support@fatchip.de
Computop Merchant Support: helpdesk@computop.com

1. Funktionsübersicht

1.1 Funktionsbeschreibung

Das Computop Payment Plugin für OXID 7 ermöglicht die Anbindung von OXID 7 an die Computop 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

Lastschrift (SEPA)

  • SEPA-Lastschrift
  • Klarna

Wallet

  • Amazon Pay
  • PayPal Standard
  • PayPal Express

Ratenkauf

  • easycredit
  • Klarna


1.2 Systemvoraussetzungen und Hinweise

Für die Verwendung des OXID 7 Computop Payment Plugins sind folgende Systemvorrausetzungen notwendig:

  • Installierter und lauffähiger OXID eShop ab Version 7.0
  • Computop Händlerkonto und je nach verwendeten Zahlarten, Konten bei den Zahlungsanbietern wie Paypal, Klarna etc.
  • PHP Version ab 7.4 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 7 Computop Payment Plugin für den OXID eShop genutzt werden soll, muss selbstverständlich den OXID Server- und Systemvoraussetzungen entsprechen:
    https://docs.oxid-esales.com/eshop/de/7.1/installation/neu-installation/server-und-systemvoraussetzungen.html

1.3 Erreichbarkeit des Shops von außen

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

Damit solche Callback Aufrufe von Computop 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 Computop 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.

2. Installation

Für die Installation des OXID 7 Computop Payment Plugins 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/computop-payments-ox7

3. Update

Die aktuelle Versionsnummer des OXID 7 Computop Payment Plugin erhalten Sie unter https://github.com/FATCHIP-GmbH/plugin-oxid7-computop/releases
Für Plugin-Updates können Sie auch unseren Twitter-Account: https://twitter.com/fatchip folgen.

Um das OXID 7 Computop Payment Plugin 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 ErweiterungenModule auf
  • Deaktivieren Sie das Plugin und Aktivieren Sie es wieder

4. Konfiguration

4.1 Allgemeine Angaben

Versandarten zuordnen

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

Computop Menü

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

4.2 General


Konfiguration Beschreibung
MerchantID Hinterlegen Sie hier Ihre MerchantID, die Sie von Computop erhalten haben.
MAC Hinterlegen Sie hier en HMAC-Key, welchen Sie von Computop erhalten haben.
Passwort Hinterlegen Sie hier Verschlüsselungspasswort, welches Sie von Computop erhalten haben.
Debug-Protokoll Aktiviert die Protokollfunktion, damit sämtliche API-Kommunikation mit Computop aufgezeichnet wird. Dies kann bei der Analyse oder Fehlersuche nützlich sein. Im Produktiv-Betrieb sollte die Funktion abgeschaltet sein, da sich sonst ggf. große Log-Mengen anhäufen und sensitive Daten gespeichert werden.

inactive: Das Aufzeichnen der API-Logs über den Standard hinaus, ist deaktiviert
active: Das Aufzeichnen der API-Logs über den Standard hinaus, ist aktiviert
extended: Dieses Log protokolliert sehr viele Daten und kann Last erzeugen. Diese Option sollte nur nach Rücksprache mit Computop oder Fatchip aktiviert werden!
Verschlüsselung Hier stellen Sie die Verschlüsselungsmethode ein. Standard ist Blowfish. Sollte Ihr Server Blowfish nicht mehr unterstützen, wenden Sie sich bitte an den Computop Merchant Service, umn Ihr Merchant Konto auf AES umstellen zu lassen. Aktivieren Sie AES wirklich nur, nachdem die Umstellung auf AES erfolgt ist

Ob die Zugangsdaten korrekt sind oder nicht, wird Ihnen nach dem Speichern angezeigt:

4.3 Kreditkarte


Konfiguration Beschreibung
Kreditkarte - Modus Hier legen Sie fest in welchen Schritten der Kunde seine Kreditkarten Informationen eingibt.

IFRAME/PAYMENTPAGE: Kreditkartendaten werden nach Klick auf Zahlungspflichtig bestellen in einemn iFrame eingegeben.
Silent Mode: Kreditkartendaten werden auf der Seite Bestellübersicht eingegeben.

Hinweis: Für die Kreditkartenanbindung ist es notwendig eine PCI-Selbstauskunft für Ihren Kreditkarten Acquirer auszufüllen. Weitere Informationen erhalten Sie von Ihrem Computop Ansprechpartner. Bitte klären Sie vorab mit ihm, ob Sie die iFrame- oder die Silent Mode Variante nutzen wollen.
Kreditkarte - Testmodus Das Plugin erlaubt den Betrieb der Kreditkartenzahlung in einem sogenannten „Test-Modus“, in welchem alle ausgeführten Test-Transaktionen nicht zu realen Buchungen führen. Die De/Aktivierung des Testmodus erfolgt über diesen Menüpunkt.
Kreditkarte - Visa (Silent Mode) Hier legen Sie fest, ob Visa im Silent Mode zur Verfügung steht.
Kreditkarte - MasterCard (Silent Mode) Hier legen Sie fest, ob Mastercard im Silent Mode zur Verfügung steht.
Kreditkarte - American Express (Silent Mode) Hier legen Sie fest, ob American Express im Silent Mode zur Verfügung steht.
Kreditkarte - Capture Modus Hier legen Sie fest zu welchem Zeitpunkt die Zahlung eingezogen wird.

AUTO: Reservierte Beträge werden sofort automatisch eingezogen.
MANUAL: Geldeinzüge werden von Ihnen manuell im OXID Backend oder Computop Analytics durchgeführt.
Kreditkarte - Acquirer Legen Sie in Absprache mit Ihrem Computop Ansprechpartner fest, welchen Acquirer Sie verwenden. Diese Einstellung muss mit der Angabe auf Seiten von Computop übereinstimmen.
Kreditkarte - Template Name Name der XSLT-Datei mit Ihrem individuellen Layout für das Bezahlformular.

Wenn Sie kein individuelles Formular nutzen, verwenden Sie hier bitte den Templatenamen ct_responsive.

4.4 iDeal


Konfiguration Beschreibung
iDEAL - Dienst iDEAL kann direkt oder über PPRO angebunden werden. Legen Sie in Absprache mit Ihrem Computop Ansprechpartner fest, welchen Dienst Sie verwenden.

4.5 PayPal


Konfiguration Beschreibung
Paypal - Capture Modus Hier legen Sie fest zu welchem Zeitpunkt die Zahlung eingezogen wird.

AUTO: Reservierte Beträge werden sofort automatisch eingezogen.
MANUELL: Geldeinzüge werden von Ihnen manuell im OXID eShop Backend oder Computop Analytics durchgeführt.

Wichtig: Bitte kontaktieren Sie den Computop Support für Manuell, um die unterschiedlichen Einsatzmöglichkeiten abzuklären.

4.6 PayPal Express


Konfiguration Beschreibung
PayPal Express - Test Modus Das Plugin erlaubt den Betrieb von PayPal Express in einem sogenannten „Test-Modus“, in welchem alle ausgeführten Test-Transaktionen nicht zu realen Buchungen führen. Die De/Aktivierung des Testmodus erfolgt über diesen Menüpunkt.
PayPal Express - Capture Modus Hier legen Sie fest zu welchem Zeitpunkt die Zahlung eingezogen wird.

AUTO: Reservierte Beträge werden sofort automatisch eingezogen.
MANUELL: Geldeinzüge werden von Ihnen manuell im OXID eShop Backend oder Computop Analytics durchgeführt.

Wichtig: Bitte kontaktieren Sie den Computop Support für Manuell, um die unterschiedlichen Einsatzmöglichkeiten abzuklären.
PayPal Express - Client-ID
Option steht nur im Livemodus zur Verfügung
Tragen Sie hier Ihre PayPal-Express Client-ID ein.
Weitere Informationen entnehmen Sie bitte der Developer Dokumentation
PayPal Express - Merchant-ID
Option steht nur im Livemodus zur Verfügung
Tragen Sie hier Ihre PayPal-Express Merchant-ID ein.
Weitere Informationen entnehmen Sie bitte der Developer Dokumentation
Computop - Partner-Attribution-ID
Option steht nur im Livemodus zur Verfügung
Tragen Sie hier Ihre Computop Partner-Attribution-ID ein.
Weitere Informationen entnehmen Sie bitte der Developer Dokumentation

4.7 Lastschrift


Konfiguration Beschreibung
Lastschrift - Capture Modus Hier legen Sie fest zu welchem Zeitpunkt die Zahlung eingezogen wird.

AUTO: Reservierte Beträge werden sofort automatisch eingezogen.
MANUELL: Geldeinzüge werden von Ihnen manuell im OXID eShop Backend oder Computop Analytics durchgeführt.

Wichtig: Bitte kontaktieren Sie den Computop Support für Manuell, um die unterschiedlichen Einsatzmöglichkeiten abzuklären.

4.8 Amazon Pay


Konfiguration Beschreibung
AmazonPay - MerchantId Geben Sie hier Ihre AmazonPay MerchantID ein.
Weitere Informationen entnehmen Sie bitte der Developer Dokumentation
AmazonPay - Public Key Id Geben Sie hier Ihre AmazonPay Public Key ID ein.
Weitere Informationen entnehmen Sie bitte der Developer Dokumentation
Amazon Modus Das Plugin erlaubt den Betrieb von Amazon Pay in einem sogenannten „Test-Modus“, in welchem alle ausgeführten Test-Transaktionen nicht zu realen Buchungen führen. Die De/Aktivierung des Testmodus erfolgt über diesen Menüpunkt.
Amazon Capture Modu Tragen Sie hier Ihre Computop Partner-Attribution-ID ein.
Weitere Informationen entnehmen Sie bitte der Developer Dokumentation
AmazonPay - Button Farbe Hier können Sie die Farbe des AmazonPay-Buttons, welcher im letzten Schritt der Bestellung angezeigt wird, auswählen. Zur Auswahl stehen:
- Gold
- LightGray

4.9 Klarna


Konfiguration Beschreibung
Klarna Konto Geben Sie hier das zu benutzende Klarna-Konto ein.
Sollten Sie die Klarna-Integration testen wollen, geben Sie hier bitte test ein.

5. API Logs

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

6. Support

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

public/oxid7-fatchipctpayment.txt · Zuletzt geändert: 2024/12/11 09:50 von markusmichalski