Fatchip GmbH Wiki

Inhaltsverzeichnis

1. Funktionsübersicht
- 1.1 Funktionsbeschreibung
- 1.2 Systemvoraussetzungen und Hinweise
2. Installation
3. Update
4. Konfiguration
- 4.1 Allgemeine Angaben
- 4.2 Zahlartenkonfigurationen
5. API Logs
6. Support

Installations-und Konfigurationsanleitung für Magento 2 ab Version 2.4.6
COMPUTOP PAYGATE GMBH - Schwarzenbergstrasse 4 - 96050 Bamberg \\

1. Funktionsübersicht

1.1 Funktionsbeschreibung

Das Computop Payment Plugin für Magento 2 ermöglicht die Anbindung von Magento 2 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 SOFORT
Giropay

Lastschrift (SEPA)

SEPA-Lastschrift
Klarna Lastschrift

Wallet

PayPal Standard
PayPal Express

Rechnungskauf

Klarna Rechnungskauf

1.2 Systemvoraussetzungen und Hinweise

Für die Verwendung des Magento 2 Computop Payment Plugins sind folgende Systemvorrausetzungen notwendig:

Installierter und lauffähiger Magento 2 Shop ab Version 2.4.6
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 unter Configuration > General > Web > Base URLs und Secure Base URLs eingegeben sein.

Für automatische Zahlungsstatus-Updates muss der Shop extern erreichbar sein

2. Installation

Für die Installation des Magento 2 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/plugin-magento2-computop
  php bin/magento module:enable Fatchip_Computop
  php bin/magento setup:upgrade
  php bin/magento setup:di:compile
  php bin/magento cache:flush

3. Update

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

Um das Magento 2 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 folgende Befehle nacheinander aus:

  composer update
  php bin/magento setup:upgrade
  php bin/magento setup:di:compile
  php bin/magento cache:flush

4. Konfiguration

4.1 Allgemeine Angaben

Die allgemeinen Einstellungen für das Plugin finden Sie im Mangento 2 Adminbereich im Menüpunkt Computop → General

Die Daten für MerchantID, HMAC und Blowfish Password bekommen Sie vom Computop Sales-Team nach Vertragsabschluss.
Vergessen Sie nicht, nach Eingabe oder Änderung der Daten, den Magneto 2 Cache über das Cache Management zu leeren.

Konfiguration	Beschreibung
MerchantID	Ihre Computop Merchant ID
HMAC	Ihr HMAC-Key
Blowfish Password	Ihr Blowfish Passwort
Order number Präfix	Wird zu Anfang der in Magento 2 erzeugten Bestellnummer eingefügt.
Order number Suffix	Wird an die in Magento 2 erzeugte Bestellnummer angehangen.

4.2 Zahlartenkonfigurationen

Die Einstellungen für die einzelnen Zahlarten finden Sie im Mangento 2 Adminbereich im Menüpunkt Computop → Payment

4.2.1 Kreditkarte

Konfiguration	Beschreibung
Enabled	yes aktiviert die Zahlart no deaktiviert die Zahlart
Title	Hier können Sie den Namen der Zahlart, wie sie im Checkout angezeigt werden soll, festlegen
Mode	Hier legen Sie fest, wann der Kunde seine Kreditkarten Informationen eingibt. iFrame: Kreditkartendaten werden nach Klick auf Place Order in ein iFrame eingegeben. Silent Mode: Kreditkartendaten werden im Abschnitt der Zahlartenauswahl eingegeben. Payment Page: Kreditkartendaten werden nach Klick auf Place Order in ein iFrame eingegeben. Das iFrame ist auf einer blanken Seite eingebunden, anstatt im Shop-Layout. 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-, Payment Page- oder die Silent Mode Variante nutzen wollen.
Test-Mode	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.
Capture method	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 oder durch ein anderes System im Magento 2 Backend durchgeführt.
New Order Status	Hier legen Sie fest, welchen Status neue Bestellungen haben sollen.
Instructions	Sie können hier einen Text hinterlegen, welcher dann bei der Zahlart im Checkout angezeigt wird.
Minimum Order Total	Hier können Sie einen Betrag eingeben, ab dem die Zahlart im Checkout zur Verfügung steht. Bei Bestellungen unter diesem Betrag, wird die Zahlart im Checkout ausgeblendet.
Maxmimum Order Total	Hier können Sie einen Betrag eingeben, bis zu dem die Zahlart im Checkout zur Verfügung steht. Bei Bestellungen über diesem Betrag, wird die Zahlart im Checkout ausgeblendet.
Creditcard types (Silent Mode)	Wählen Sie hier die Kreditkartenmarken aus, die im Frontend zur Auswahl stehen. Diese Option ist nur wirksam, wenn als Mode der Silent Mode ausgewählt ist.
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.
Sort Order	Legen Sie hier fest, in welcher Reihenfolge die Zahlart im Checkout angezeigt werden soll.

4.2.2 Direct Debit

Konfiguration	Beschreibung
Enabled	yes aktiviert die Zahlart no deaktiviert die Zahlart
Title	Hier können Sie den Namen der Zahlart, wie sie im Checkout angezeigt werden soll, festlegen
Capture method	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 oder durch ein anderes System im Magento 2 Backend durchgeführt.
New Order Status	Hier legen Sie fest, welchen Status neue Bestellungen haben sollen.
Instructions	Sie können hier einen Text hinterlegen, welcher dann bei der Zahlart im Checkout angezeigt wird.
Minimum Order Total	Hier können Sie einen Betrag eingeben, ab dem die Zahlart im Checkout zur Verfügung steht. Bei Bestellungen unter diesem Betrag, wird die Zahlart im Checkout ausgeblendet.
Maxmimum Order Total	Hier können Sie einen Betrag eingeben, bis zu dem die Zahlart im Checkout zur Verfügung steht. Bei Bestellungen über diesem Betrag, wird die Zahlart im Checkout ausgeblendet.
Sort Order	Legen Sie hier fest, in welcher Reihenfolge die Zahlart im Checkout angezeigt werden soll.

4.2.3 PayPal

Konfiguration	Beschreibung
Enabled	yes aktiviert die Zahlart no deaktiviert die Zahlart
Title	Hier können Sie den Namen der Zahlart, wie sie im Checkout angezeigt werden soll, festlegen
PayPal Express active	Hier aktivieren/deaktivieren Sie die Anzeige des PayPal-Express-Button im Mini-Warenkorb und im Warenkorb.
PayPal Account ID	Die PayPal Account ID finden Sie in Ihrem PayPal-Konto. Diese zwingend notwendig für die Verwendung von PayPal Express.
Capture method	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 oder durch ein anderes System im Magento 2 Backend durchgeführt.
New Order Status	Hier legen Sie fest, welchen Status neue Bestellungen haben sollen.
Instructions	Sie können hier einen Text hinterlegen, welcher dann bei der Zahlart im Checkout angezeigt wird.
Minimum Order Total	Hier können Sie einen Betrag eingeben, ab dem die Zahlart im Checkout zur Verfügung steht. Bei Bestellungen unter diesem Betrag, wird die Zahlart im Checkout ausgeblendet.
Maxmimum Order Total	Hier können Sie einen Betrag eingeben, bis zu dem die Zahlart im Checkout zur Verfügung steht. Bei Bestellungen über diesem Betrag, wird die Zahlart im Checkout ausgeblendet.
Sort Order	Legen Sie hier fest, in welcher Reihenfolge die Zahlart im Checkout angezeigt werden soll.

4.2.4 Klarna

Konfiguration	Beschreibung
Enabled	yes aktiviert die Zahlart no deaktiviert die Zahlart
Title	Hier können Sie den Namen der Zahlart, wie sie im Checkout angezeigt werden soll, festlegen
Klarna Account	Bei Computop können mehrere Klarna-Benutzernamen auf einer MerchantID hinterlegt und durch diesen Parameter angesteuert werden. Standardmäßig ist dieser Wert „0“. Bei mehreren Klarna-Accounts stimmen Sie den Wert bitte mit helpdesk@computop.com ab.
New Order Status	Hier legen Sie fest, welchen Status neue Bestellungen haben sollen.
Instructions	Sie können hier einen Text hinterlegen, welcher dann bei der Zahlart im Checkout angezeigt wird.
Minimum Order Total	Hier können Sie einen Betrag eingeben, ab dem die Zahlart im Checkout zur Verfügung steht. Bei Bestellungen unter diesem Betrag, wird die Zahlart im Checkout ausgeblendet.
Maxmimum Order Total	Hier können Sie einen Betrag eingeben, bis zu dem die Zahlart im Checkout zur Verfügung steht. Bei Bestellungen über diesem Betrag, wird die Zahlart im Checkout ausgeblendet.
Sort Order	Legen Sie hier fest, in welcher Reihenfolge die Zahlart im Checkout angezeigt werden soll.

4.2.5 Giropay

Konfiguration	Beschreibung
Enabled	yes aktiviert die Zahlart no deaktiviert die Zahlart
Title	Hier können Sie den Namen der Zahlart, wie sie im Checkout angezeigt werden soll, festlegen
Request BIC	Bei Aktivierung dieser Option wird im Checkout zur IBAN zusätzlich noch die BIC abgefragt.
New Order Status	Hier legen Sie fest, welchen Status neue Bestellungen haben sollen.
Instructions	Sie können hier einen Text hinterlegen, welcher dann bei der Zahlart im Checkout angezeigt wird.
Minimum Order Total	Hier können Sie einen Betrag eingeben, ab dem die Zahlart im Checkout zur Verfügung steht. Bei Bestellungen unter diesem Betrag, wird die Zahlart im Checkout ausgeblendet.
Maxmimum Order Total	Hier können Sie einen Betrag eingeben, bis zu dem die Zahlart im Checkout zur Verfügung steht. Bei Bestellungen über diesem Betrag, wird die Zahlart im Checkout ausgeblendet.
Sort Order	Legen Sie hier fest, in welcher Reihenfolge die Zahlart im Checkout angezeigt werden soll.

4.2.6 iDEAL

Konfiguration	Beschreibung
Enabled	yes aktiviert die Zahlart no deaktiviert die Zahlart
Title	Hier können Sie den Namen der Zahlart, wie sie im Checkout angezeigt werden soll, festlegen
Service	Hier stellen Sie ein, wie die Anbindung an iDeal erfolgt: iDEAL direkt: iDEAL-Integration via niederländische Hausbank. Gutschriften über das Plugin sind bei einer Direktanbindung nicht möglich. via PPRO: Anbindung über den Dienstleister PPRO
New Order Status	Hier legen Sie fest, welchen Status neue Bestellungen haben sollen.
Instructions	Sie können hier einen Text hinterlegen, welcher dann bei der Zahlart im Checkout angezeigt wird.
Button: Update iDEAL banks	Mit diesem Button aktualisieren Sie die Bankenliste für iDeal. Die Bankenliste wird nur bei dem Service iDEAL direkt benötigt. Die Bankenliste wird dann beim Checkout bei der Zahlart angezeigt.
Minimum Order Total	Hier können Sie einen Betrag eingeben, ab dem die Zahlart im Checkout zur Verfügung steht. Bei Bestellungen unter diesem Betrag, wird die Zahlart im Checkout ausgeblendet.
Maxmimum Order Total	Hier können Sie einen Betrag eingeben, bis zu dem die Zahlart im Checkout zur Verfügung steht. Bei Bestellungen über diesem Betrag, wird die Zahlart im Checkout ausgeblendet.
Sort Order	Legen Sie hier fest, in welcher Reihenfolge die Zahlart im Checkout angezeigt werden soll.

5. API Logs

Im Magento 2 Adminbereich unter Computop → API 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.