PayPalPlus Benutzerhandbuch Das PayPalPlus-Modul für Magento 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 1.7.x - 1.9.x PHP ab 5.3.x Folgende Magento-Checkouts werden unterstützt: Magento Onepage 1.7.1-1.9 Amasty Checkout 2.9.10 Awesome Checkout 1.5.0 Aheadworks Checkout 1.3.8 Magestore Onestepcheckout 3.1.0 TM Firecheckout 1.3.1 / 2.7.1 Idev OneStepCheckout 4.1 / 4.5 IWD OPC 4.2.2 Das Modul ist außerdem mit folgenden Modulen getestet: Firegento Market Ready Germany Aktivierung des IPN-Services in Ihrem PayPal-Account. Bitte tragen Sie dazu Ihre IPN-URL im PayPal Account ein. Die IPN URL lautet: http://www.ihre-shopurl.de/paypal/ipn/ bzw. https://www.ihre-shopurl.de/paypal/ipn/ 1. Loggen Sie sich in Ihren PayPal Account ein: www.paypal.de 2. Klicken Sie auf "Mein Profil" -> "Kontoeinstellungen" 3. Danach gehen sie zu "Benachrichtigungen über Sofortzahlungen" -> "Aktualisieren" -> "Einstellungen bearbeiten" 4. Tragen Sie unter "Benachrichtigungs-URL" bitte Ihre Shop-Url gefolgt von "/paypal/ipn/" ein. (Beispiel: http://www.example.de/paypal/ipn/ oder https://www.example.de/paypal/ipn/ ) 5. Wählen Sie "Sofortige Zahlungsbestätigungen erhalten (aktiviert)" aus und bestätigen Sie Ihre Einstellungen mit dem Klick auf "Speichern" Parallel zu IPN verwendet das Modul PayPal WebHooks um die Aktualisierung über den Zahlungsstatus von PayPal zu erhalten. Die WebHooks werden automatisch beim Speichern von Klienten-ID und Klienten-Schlüssel erstellt. Nutzung von Webhooks ist auf lokalen Testumgebungen und bei Verwendung von htaccess Zugriffseinschränkung nicht möglich. Ggf. wird eine Fehlermeldung bei der Speicherung der Einstellungen angezeigt. Backend Den Backend-Bereich des Moduls erreichen Sie über die Magento-Konfiguration unter: System Konfiguration Verkäufe Zahlungsarten PayPalPlus-Einstellungen.
Konfiguration Folgende Felder können konfiguriert werden: PayPalPlus API-Einstellungen
Klienten-ID Tragen Sie die Klienten-ID Ihrer PayPal-APP ein. 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. Titel Hier können Sie einen alternativen Titel für die Zahlungsmethode hinterlegen. 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 Zahlungsmethodenauswahl von PayPalPlus angezeigt werden können. Dabei können Zahlungsmethoden folgendermaßen dargestellt werden: Magento aktiv: nein, PayPalPlus-Drittanbieter aktiv: nein Die Zahlungsmethode wird nicht angezeigt. Magento aktiv: ja, PayPalPlus-Drittanbieter aktiv: ja Wenn die Zahlungsmethode aktiv ist und unter "Erlaubte Zahlungsmethoden von Drittanbietern" ausgewählt wurde, wird die Zahlungsmethode im Checkout versteckt und im PayPalPlus-Modul dargestellt. Magento aktiv: ja, PayPalPlus-Drittanbieter aktiv: nein Die Zahlungsmethode ist aktiv und wird wie gewohnt im Checkout dargestellt. Wenn Sie Zahlungsmethoden haben, die ein Eingabefeld benötigen, ist es empfehlenswert diese nicht unter PayPalPlus-Drittan bieter zu aktivieren. 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. 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. 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. 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.
Kauf auf Rechnung 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.
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_pui_reference_number Verwendungszweck string ppp_pui_instruction_type Art der Zahlung. Immer: " PAY_UPON_INVOICE" string ppp_pui_payment_due_date Fälligkeitsdatum der Zahlung string ppp_pui_note Kommentar string ppp_pui_bank_name Bankname string ppp_pui_account_holder_name Kontoinhaber string ppp_pui_international_bank_account_number ISBN string ppp_pui_bank_identifier_code BIC string ppp_pui_routing_number Bankleitzahl string ppp_pui_amount Rechnungsbetrag string ppp_pui_currency Rechnungswährung string
SOAP API v1/v2 Die oben beschriebenen Felder wurden der salesorderpaymententity hinzugefügt und sind über folgende Methoden abrufbar: sales_order.info (SOAP V1) salesorderinfo (SOAP V2) Weitere Informationen sind unter folgendem Link zu beziehen: http://www.magentocommerce.com/api/soap/sales/salesorder/sales_order.info.html REST Die oben beschriebenen Felder wurden der orders Resource hinzugefügt. Weitere Informationen zur Magento REST API erhalten sie unter folgendem Link: http://devdocs.magento.com/guides/m1x/api/rest/introduction.html