PayPalPlus Benutzerhandbuch - i-ways.net · PDF fileMagento-API Die zusätzlichen...
Transcript of PayPalPlus Benutzerhandbuch - i-ways.net · PDF fileMagento-API Die zusätzlichen...
1. 2. 3. 4.
5.
PayPalPlus BenutzerhandbuchDas PayPalPlus-Modul für Magento ersetzt die komplette Auswahl von Zahlungsmethoden in Magento. Mit dem PayPalPlus-Modul könnenandere, 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.xPHP ab 5.3.x
Folgende Magento-Checkouts werden unterstützt:
Magento Onepage 1.7.1 - 1.9Amasty Checkout 2.9.10Awesome Checkout 1.5.0Aheadworks Checkout 1.3.8Magestore Onestepcheckout 3.1.0TM Firecheckout 1.3.1 / 2.7.1Idev OneStepCheckout 4.1 / 4.5IWD OPC 4.2.2
Das Modul ist außerdem mit folgenden Modulen getestet:
FiregentoMarket 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: bzw. http://www.IHRE-SHOPURL.de/paypal/ipn/ https://www.IHRE-SHOPURL.de/paypal/ipn/
Loggen Sie sich in Ihren PayPal Account ein: www.paypal.deKlicken Sie auf "Mein Profil" -> "Kontoeinstellungen"Danach gehen sie zu "Benachrichtigungen über Sofortzahlungen" -> "Aktualisieren" -> "Einstellungen bearbeiten"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/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 WebHookswerden automatisch beim Speichern von Klienten-ID und Klienten-Schlüssel erstellt. Nutzung von Webhooks ist auf lokalen Testumgebungen undbei Verwendung von htaccess Zugriffseinschränkung nicht möglich. Ggf. wird eine Fehlermeldung bei der Speicherung der Einstellungenangezeigt.
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
| Tragen Sie die Klienten-ID Ihrer PayPal-APP ein.Klienten-ID
| Tragen Sie den Klienten-Schlüssel Ihrer PayPal-APP ein.Klienten-Schlüssel
| Hier können Sie zwischen der Sandbox und dem Live-Modus umschalten. Es wird empfohlen, die Konfiguration zunächst imModusSandbox-Modus zu testen.
Kopfbereich-Bild-URL | Das Bild oben links auf der Bezahlseite. Max. 750px × 90px. Sollten Sie dieses Feld nicht ausfüllen, wird dasStandard-Logo benutzt.
PayPalPlus-Einstellungen
| Mit diesem Dropdown aktivieren Sie das PayPalPlus-Modul im Checkout.Aktiviert
| Hier können Sie einen alternativen Titel für die Zahlungsmethode hinterlegen.Titel
| Dieses Dropdown-Menü ermöglicht Ihnen den Wechsel zwischen der Anzeige in jedem Kundenland oderZahlung aus erlaubten Länderndenen unter ausgewählten Ländern.Zahlung aus bestimmten Ländern
| Hier können Sie die Kundenländer beschränken, in denen die Zahlungsmethodenauswahl durchZahlung aus bestimmten LändernPayPalPlus ersetzt werden soll.
| Hier haben Sie die Möglichkeit, andere Zahlungsmethoden zu aktivieren, die in derErlaubte Zahlungsmethoden von DrittanbieternZahlungsmethodenauswahl 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
" ausgewählt wurde, wird die Zahlungsmethode im Checkout versteckt und imZahlungsmethoden von DrittanbieternPayPalPlus-Modul dargestellt.Magento aktiv: ja , PayPalPlus-Drittanbieter aktiv: nein – Die Zahlungsmethode ist aktiv und wird wie gewohnt im Checkoutdargestellt.
Wenn Sie Zahlungsmethoden haben, die ein Eingabefeld benötigen, ist es empfehlenswert diese nicht unter PayPalPlus-Drittanbieter zu aktivieren.
Alle Zahlungsmethoden werden im Checkout auf Gültigkeit für die aktuelle Bestellung des Kunden überprüft und gegebenenfalls aktiviert. Bittebeachten Sie, dass es zu Problemen kommen kann, sollte die Zahlungsmethode weitere Eingaben im Checkout benötigen.
Entwicklereinstellungen
| Sollten Sie Probleme mit einem anderen Autoloader für PHP-Klassen haben, können Sie diesen hierPayPalSDK-Autoloader aktivdeaktivieren.
| Durch den Debug-Modus werden API-Fehler im Frontend angezeigt.Debug
Bestellabwicklung
Im Magento-Backend wird die Bestellung mit der entsprechenden, vom Kunden ausgewählten, Zahlungsmethode angelegt. Wenn der Käufereine der PayPal-Zahlungsmethoden verwendet (PayPal, Lastschrift oder Kreditkarte), können weitere Funktionalitäten desStandard-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 derZahlungsauswahl angezeigt.
Hinweis: Information zum Kauf auf Rechnung können pro Transaktion dynamisch sein und dürfen unter keinen Umständen festgesetzt angezeigtwerden. 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 weitereZahlungsinformation 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-Backendangezeigt.
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-Systemezu ü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 hinzugefügt und sind über folgende Methoden abrufbar:salesOrderPaymentEntity
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 Resource hinzugefügt.orders
Weitere Informationen zur Magento REST API erhalten sie unter folgendem Link:
http://devdocs.magento.com/guides/m1x/api/rest/introduction.html