PayPalPlus Magento 2 Benutzerhandbuch

Transkript

1 PayPalPlus Magento 2 Benutzerhandbuch Das PayPalPlus-Modul für Magento 2 ersetzt die komplette Auswahl von Zahlungsmethoden in Magento. Mit dem PayPalPlus-Modul können andere, eigene Zahlungsmethoden unterstützt werden, die in der Modul-Konfiguration aktiviert werden. Voraussetzung Als technische Voraussetzungen für die Modul-Installation gelten: Magento Community Edition PHP ab 5.6.x Installation Über composer Damit sie unser Modul über composer installieren können fügen sie bitte unser Repository in ihre composer.json Datei ein. { } "repositories": [ { "url": " "type": "vcs" } ] Nach dem sie das Repository hinzugefügt haben müssen Sie unser Modul als required in Ihrer composer.json hinzufügen. Dafür gibt es zwei Möglichkeiten: Füren Sie folgenden Befehl in ihrem Magentohauptverzeichnis aus: composer require iways/module-pay-pal-plus Fügen Sie das Modul manuell in Ihre composer.json Datei ein. "require": { "iways/module-pay-pal-plus": "~1.0" } Aktivierung des Moduls Aktivieren Sie das Modul über die Magento 2 Console mit folgendem Befehl aus dem Magento-Hauptverzeichnis: bin/magento module:enable --clear-static-content Iways_PayPalPlus

2 Nach diesem Schritt müssen Sie noch das Datenbankipdate mit folgendem Befehl durchführen: bin/magento setup:upgrade Das Magento 2 PayPal Plus Modul sollte nun erfolgreich in Ihrem Webshop installiert worden sein. Magento Marktplatz (Noch nicht verfügbar) Loggen Sie sich mit vollen Administrationsrechten in Ihrem Webshop ein und navigieren Sie zu System Tools Web Setup Wizard Componen t Manager Sollten Sie noch keine Zugangsdaten eingegeben haben, werden Sie an dieser Stelle nach diesen Daten gefragt. Weitere Information zur Generierung Ihrer Zugangsdaten erhalten sie unter ml. Nach einer Syncronisation mit Ihrem Magento Marketplace Account sollten sie unter "New Purchases" eine Zahl über Null sehen. Um das PayPal Plus Modul zu installieren klicken sie im weiteren Verlauf auf Install.

3 Im nächsten Schritt müssen sie unsere Erweiterung auswählen und sie wird installiert. Für eine ausführliche Anleitung wie Sie in Magento 2 Module installieren, lesen Sie bitte die offizielle Dokumentation unter: om/marketplace/user_guide/quick-tour/install-extension.html. Backend Den Backend-Bereich des Moduls erreichen Sie über die Magento-Konfiguration unter: Shops Konfiguration Umsatz Zahlungsarten PayPalPlus-Einstellungen. Konfiguration Folgende Felder können konfiguriert werden:

4

5 PayPalPlus API-Einstellungen Klienten-ID Tragen Sie die Klienten-ID Ihrer PayPal-APP ein.

6 Klienten-Schlüssel Tragen Sie den Klienten-Schlüssel Ihrer PayPal-APP ein. Modus Hier können Sie zwischen der Sandbox und dem Live-Modus umschalten. Es wird empfohlen, die Konfiguration zunächst im Sandbox-Modus zu testen. Kopfbereich-Bild-URL Das Bild oben links auf der Bezahlseite. Max. 750px 90px. Sollten Sie dieses Feld nicht ausfüllen, wird das Standard-Logo benutzt. PayPalPlus-Einstellungen Aktiviert Mit diesem Dropdown aktivieren Sie das PayPalPlus-Modul im Checkout. Zahlung aus erlaubten Ländern Dieses Dropdown-Menü ermöglicht Ihnen den Wechsel zwischen der Anzeige in jedem Kundenland oder denen unter Zahlung aus bestimmten Ländern ausgewählten Ländern. Zahlung aus bestimmten Ländern Hier können Sie die Kundenländer beschränken, in denen die Zahlungsmethodenauswahl durch PayPalPlus ersetzt werden soll. Erlaubte Zahlungsmethoden von Drittanbietern Hier haben Sie die Möglichkeit, andere Zahlungsmethoden zu aktivieren, die in der

7 Zahlungsmethodenauswahl von PayPalPlus angezeigt werden können. Alle Zahlungsmethoden werden im Checkout auf Gültigkeit für die aktuelle Bestellung des Kunden überprüft und gegebenenfalls aktiviert. Bitte beachten Sie, dass es zu Problemen kommen kann, sollte die Zahlungsmethode weitere Eingaben im Checkout benötigen. Drittanbieterinformationstexte Sollten Sie im Punkt Erlaubte Zahlungsmethoden von Drittanbietern Zahlungsmethoden ausgewählt haben, so können Sie diesen Zahlungsmethoden hier Beschreibungstexte hinzufügen. Diese werden im iframe angezeigt. Die Felder werden dynamisch generiert und sind erst nach einer Auswahl und dem Abspeichern der Konfiguration sichtbar. Entwicklereinstellungen PayPalSDK-Autoloader aktiv Sollten Sie Probleme mit einem anderen Autoloader für PHP-Klassen haben, können Sie diesen hier deaktivieren. Debug Durch den Debug-Modus werden API-Fehler im Frontend angezeigt und die einzelnen Abfragen der PayPal Rest Api werden im Log-Verzeichnis in der Datei PayPal.log gespeichert. Bestellabwicklung Im Magento-Backend wird die Bestellung mit der entsprechenden, vom Kunden ausgewählten, Zahlungsmethode angelegt. Wenn der Käufer eine der PayPal-Zahlungsmethoden verwendet (PayPal, Lastschrift oder Kreditkarte), können weitere Funktionalitäten des Standard-PayPal-Moduls, wie z.b. Gutschrift, in der Bestellabwicklung verwendet werden.

8 Frontend Im Frontend des Magento-Shops ist die in der Konfiguration vordefinierte Auswahl der Zahlungsmethoden sichtbar. Bitte beachten Sie, dass es zu Problemen bei Zahlungsmethoden mit zusätzlichen Eingabefeldern im Backend kommen kann.

9 Kauf auf Rechnung

10 Sollte Ihr Account bei PayPal für den "Kauf auf Rechnung" freigeschaltet sein, wird diese Zahlungsmethode automatisch bei der Zahlungsauswahl angezeigt. Hinweis: Information zum Kauf auf Rechnung können pro Transaktion dynamisch sein und dürfen unter keinen Umständen festgesetzt angezeigt werden. Bitte laden Sie immer die aktuellen Information für die Anzeige. Frontend Entscheidet sich der Käufer für den "Kauf auf Rechnung" wird er durch den "Kauf auf Rechnung"-Prozesse geführt und es werden Ihm weitere Zahlungsinformation auf der Bestellbestätigungsseite angezeigt. Backend Bei einer Bestellung mit "Kauf auf Rechnung" werden die zusätzlichen Zahlungsinformation auch in der Bestellansicht in Ihrem Magento-Backend angezeigt.

11 Rechnung Diese zusätzlichen Zahlungsinformation werden dem Kunden auch auf der PDF-Rechnung angezeigt. Magento-API Die zusätzlichen Zahlungsinformationen werden Ihnen auch über die Magento-API zur verfügung gestellt,um sie gegebenenfalls in Dritt-Systeme zu übernehmen. Name Beschreibung Typ ppp_reference_number Verwendungszweck string ppp_instruction_type Art der Zahlung. Bei einer Bestellung mit "Kauf auf Rechnung" ist der Wert: "PAY_UPON_I NVOICE" string ppp_payment_due_date Fälligkeitsdatum der Zahlung string ppp_note Kommentar string ppp_bank_name Bankname string ppp_account_holder_name Kontoinhaber string ppp_international_bank_account_number ISBN string ppp_bank_identifier_code BIC string ppp_routing_number Bankleitzahl string

12 ppp_amount Rechnungsbetrag string ppp_currency Rechnungswährung string Diese Informationen finden Sie im im payment - > extension_attributes Knoten des "salesorderrepositoryv1"-calls der Magento 2 WebAPI. Weitere Informationen zu Magento 2 WebAPI finden Sie unter folgenden Links: