CrefoPay Payment Plugin für Shopware 5 Installation und Konfiguration
Inhaltsverzeichnis 1. Einleitung... 3 2. Installation... 3 2.1 Installation über den Shopware Store (empfohlen)... 3 2.2 Installation über das Shopware Backend... 3 2.3 Installation über die Kommandozeile... 3 3. Upgrade... 3 4. WICHTIGER Hinweis für ein Update von Versionen < 1.0.0... 4 5. Konfiguration... 4 6. Kompatibilität... 5 Seite 1 von 5
ÄNDERUNGSHISTORIE Datum Autor Änderung 01.06.2018 support@senbyte.com INITIALE VERSION 20.06.2018 support@senbyte.com HINWEIS FÜR UPDATE VON VERSION < 1.0.0 HINZUGEFÜGT 19.11.2018 support@senbyte.com KONFIGURATION FÜR AUTO CAPTURE ANGEPASST Seite 2 von 5
1. Einleitung Das CrefoPay Zahlungsmodul für Shopware ermöglicht es Ihnen durch einfache Installation die Zahlarten der CrefoPayment GmbH & Co. KG in Ihrem Shopware-Shop anbieten zu können. Weitere Informationen zu den Lösungen der CrefoPayment finden Sie unter https://www.crefopay.de. 2. Installation 2.1 Installation über den Shopware Store (empfohlen) Sie können das CrefoPay Zahlungsmodul ganz bequem über den Shopware Store kostenlos beziehen und mittels Plugin Manager im Shopware Backend installieren. Nachdem Sie das Plugin über den Shopware Store bezogen haben, melden Sie sich hierzu in Ihrem Shopware Backend an und öffnen über das Menü Einstellungen den Plugin Manager. Anschließend finden Sie das CrefoPay Zahlungsmodul unter Meine Einkäufe und können dies installieren. 2.2 Installation über das Shopware Backend Sollte Ihnen das CrefoPay Zahlungsmodul als.zip Datei vorliegen, so können Sie dies auch im Shopware Backend über den Plugin Manager hochladen und installieren. Melden Sie sich hierzu in Ihrem Shopware Backend an und öffnen über das Menü Einstellungen den Plugin Manager. Anschließend klicken Sie unter Verwaltung auf installiert und dort auf den Button Plugin hochladen. Wählen Sie nun die.zip Datei des CrefoPay Zahlungsmoduls aus und bestätigen den Upload. Nach erfolgreichem Hochladen des Plugins können Sie das Plugin wie gewohnt installieren. 2.3 Installation über die Kommandozeile Sollte das CrefoPay Plugin bereits installiert gewesen sein, löschen Sie das alte Plugin bitte vor dem Kopieren aus dem Pluginverzeichnis! Zur Installation über die Kommandozeile, kopieren Sie das Plugin Verzeichnis SbPaymentCrefoPay in das unten angegebene Plugin-Verzeichnis: CP -R SBPAYMENTCREFOPAY /PATH/TO/SHOPWARE/ENGINE/SHOPWARE/PLUGINS/COMMUNITY/FRONTEND/ Anschließend muss das Plugin wie folgt noch aktiviert werden: CD /PATH/TO/SHOPWARE CHMOD +X BIN/CONSOLE./BIN/CONSOLE SW:PLUGIN:REFRESH./BIN/CONSOLE SW:PLUGIN:INSTALL SBPAYMENTCREFOPAY./BIN/CONSOLE SW:PLUGIN:ACTIVATE SBPAYMENTCREFOPAY 3. Upgrade Sofern eine neuere Version des CrefoPay Zahlungsmoduls vorliegt, können Sie dies über den Plugin Manager des Shopware Backends aktualisieren. Sollten Sie das Plugin nicht über den Shopware Store bezogen und installiert haben, müssen sie die neue Plugin Version zunächst hochladen, verfahren Sie hierzu wie unter Punkt 1.1.2 bzw. 1.1.3 beschrieben. Anschließend wird Ihnen die mögliche Aktualisierung in Ihrem Plugin Manager angezeigt und kann wie in Shopware gewohnt durchgeführt werden. Seite 3 von 5
4. WICHTIGER Hinweis für ein Update von Versionen < 1.0.0 Bitte beachten Sie, dass sich er technische Name des Plugins mit der Veröffentlichung der Version 1.0.0 geändert hat. Sollten Sie von einer Plugin Version kleiner (älter) als 1.0.0 auf mindestens die Version 1.0.0 aktualisieren wollen, gehen Sie wie folgt vor: Lassen Sie das bisherige Plugin in der älteren Version installiert Installieren Sie als nächstes das Plugin in der neuen Version wie unter Punkt 2 beschrieben Deinstallieren Sie erst jetzt die alte Version des Plugins Abschließend aktivieren Sie bitte die gewünschten CrefoPay Zahlarten wieder wie gewohnt über das Shopware Backend Durch die beschriebene Vorgehensweise wird die Funktionalität sicher gestellt. Dieser Vorgang ist nur einmalig notwendig und ausschließlich wenn Sie von einer Version kleiner als 1.0.0 auf mindestens die Version 1.0.0 oder höher aktualisieren! 5. Konfiguration Nach erfolgreicher Installation des CrefoPay Zahlungsmoduls (siehe Punkt 1) öffnen Sie die Konfiguration des Plugins über den Plugin Manager: Dadurch öffnet sich das Fenster mit dem Konfigurations-Formular für das CrefoPay Zahlungsmodul. Sie müssen das Formular für alle (Sub-)Shops ausfüllen, in welchen Sie die CrefoPay Zahlarten anbieten möchten. Die einzelnen Felder des Formulars sind im Folgenden beschrieben: Händler ID: Eine eindeutige Kennung, welche Sie von der CrefoPayment erhalten haben Händler Passwort: Ihr CrefoPay Passwort Shop ID für Währung XYZ: Für jede von Ihnen im jeweiligen (Sub-)Shop angebotene Währung erhalten Sie von der CrefoPayment eine separate Shop ID. Tragen Sie diese hier bitte ein. Seite 4 von 5
Public Token für Währung XYZ: Für jede von Ihnen im jeweiligen (Sub-)Shop angebotene Währung erhalten Sie von der CrefoPayment einen separaten Shop Token. Tragen Sie diesen hier bitte ein. Umgebung: Auswahl ob CrefoPay im Testmodus (Sandbox) oder Livebetrieb (Production) genutzt werden soll Auto Capture: Transaktion werden bei Bestellabschluss automatisch im System der CrefoPayment gebucht Auto Capture für bestimmte Kategorien: Befindet sich mindestens ein Artikel der hier ausgewählten Kategorien im Warenkorb des Kunden, wird die Transaktion bei Bestellabschluss automatisch im System der CrefoPayment gebucht. Auto Capture wenn Bestell Status: Ändert sich der Bestell Status auf den hier konfigurierten Wert, wird die Bestellung automatisch im System der CrefoPayment gebucht. Auto Update Transaction: Wenn aktiviert, versendet das Plugin nach Rechnungserzeugung im Shopware Backend automatisch die Rechnungsinformationen an CrefoPay. Logging: Hier können Sie den Plugin-eigenen Protokollierungsmechanismus aktivieren. Log Level: Hier können Sie den Log Level des Plugin eigenen Protokollierungsmechanismus einstellen. Im Testbetrieb können Sie Debug auswählen um detaillierte Informationen zu erhalten. Im Livebetrieb empfehlen wir hier den Wert Error auszuwählen. Es erfolgen dann nur Protokolleinträge im Fehlerfall. Nach erfolgreicher Konfiguration speichern Sie bitte die gemachten Einstellungen. Abschließend müssen Sie noch die gewünschten Zahlungsarten des CrefoPay Plugins aktivieren. Öffnen Sie hierzu das Menü Einstellungen -> Zahlungsarten im Shopware Backend. Wählen Sie die gewünschten CrefoPay Zahlungsarten der nacheinander aus und aktivieren diese: 6. Kompatibilität Das CrefoPay Zahlungsmodul ist mit Shopware ab Version 5.2.0 kompatibel. Das Modul setzt PHP in der Version 5.6 oder 7.x voraus. Die weiteren Systemvoraussetzungen richten sich nach den Anforderungen von Shopware in der jeweiligen Version. Seite 5 von 5