PayPalPlus Benutzerhandbuch - i-ways.net · PDF fileMagento-API Die zusätzlichen...

10
1. 2. 3. 4. 5. 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: 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.de Klicken 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 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.

Transcript of PayPalPlus Benutzerhandbuch - i-ways.net · PDF fileMagento-API Die zusätzlichen...

Page 1: PayPalPlus Benutzerhandbuch - i-ways.net · PDF fileMagento-API Die zusätzlichen Zahlungsinformationen werden Ihnen auch über die Magento-API zur verfügung gestellt,um sie gegebenenfalls

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.

Page 2: PayPalPlus Benutzerhandbuch - i-ways.net · PDF fileMagento-API Die zusätzlichen Zahlungsinformationen werden Ihnen auch über die Magento-API zur verfügung gestellt,um sie gegebenenfalls

Konfiguration

Folgende Felder können konfiguriert werden:

PayPalPlus API-Einstellungen

Page 3: PayPalPlus Benutzerhandbuch - i-ways.net · PDF fileMagento-API Die zusätzlichen Zahlungsinformationen werden Ihnen auch über die Magento-API zur verfügung gestellt,um sie gegebenenfalls

| 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

Page 4: PayPalPlus Benutzerhandbuch - i-ways.net · PDF fileMagento-API Die zusätzlichen Zahlungsinformationen werden Ihnen auch über die Magento-API zur verfügung gestellt,um sie gegebenenfalls

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

Page 5: PayPalPlus Benutzerhandbuch - i-ways.net · PDF fileMagento-API Die zusätzlichen Zahlungsinformationen werden Ihnen auch über die Magento-API zur verfügung gestellt,um sie gegebenenfalls
Page 6: PayPalPlus Benutzerhandbuch - i-ways.net · PDF fileMagento-API Die zusätzlichen Zahlungsinformationen werden Ihnen auch über die Magento-API zur verfügung gestellt,um sie gegebenenfalls

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.

Page 7: PayPalPlus Benutzerhandbuch - i-ways.net · PDF fileMagento-API Die zusätzlichen Zahlungsinformationen werden Ihnen auch über die Magento-API zur verfügung gestellt,um sie gegebenenfalls

Backend

Bei einer Bestellung mit "Kauf auf Rechnung" werden die zusätzlichen Zahlungsinformation auch in der Bestellansicht in Ihrem Magento-Backendangezeigt.

Page 8: PayPalPlus Benutzerhandbuch - i-ways.net · PDF fileMagento-API Die zusätzlichen Zahlungsinformationen werden Ihnen auch über die Magento-API zur verfügung gestellt,um sie gegebenenfalls

Rechnung

Diese zusätzlichen Zahlungsinformation werden dem Kunden auch auf der PDF-Rechnung angezeigt.

Page 9: PayPalPlus Benutzerhandbuch - i-ways.net · PDF fileMagento-API Die zusätzlichen Zahlungsinformationen werden Ihnen auch über die Magento-API zur verfügung gestellt,um sie gegebenenfalls

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

Page 10: PayPalPlus Benutzerhandbuch - i-ways.net · PDF fileMagento-API Die zusätzlichen Zahlungsinformationen werden Ihnen auch über die Magento-API zur verfügung gestellt,um sie gegebenenfalls

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