{{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 .