{{public:faq:shopware-fatchipctpayment:0_logo_computop.png?nolink&400|}}\\
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
{{public:magento-fatchipctpayment:240611_zahlartenlogos_no_amznpay_easycredit.jpg?nolink&800|}}\\
==== 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.\\
{{public:magento-fatchipctpayment:2240610_ct_m2_secure_base_url.png?nolink&800|}}\\
* 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 \\
{{public:magento-fatchipctpayment:240610_ct_m2_update_composer.png?nolink&600|}}
* 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**\\
{{public:magento-fatchipctpayment:240610_ct_m2_configuration_general.png?nolink&600|}} \\
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 ===
{{public:magento-fatchipctpayment:240610_ct_m2_configuration_payment_creditcard.png?nolink&800|}} \\
^ **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===
{{public:magento-fatchipctpayment:240610_ct_m2_configuration_payment_direktdebit.png?nolink&800|}} \\
^ **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===
{{public:magento-fatchipctpayment:240610_ct_m2_configuration_payment_paypal.png?nolink&800|}} \\
^ **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===
{{public:magento-fatchipctpayment:240610_ct_m2_configuration_payment_klarna.png?nolink&800|}} \\
^ **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 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===
{{public:magento-fatchipctpayment:240610_ct_m2_configuration_payment_giropay.png?nolink&800|}} \\
^ **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===
{{public:magento-fatchipctpayment:240610_ct_m2_configuration_payment_ideal.png?nolink&800|}} \\
^ **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 .