PayPal Plus Benutzerhandbuch - I

PayPal Plus 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.0.1 - 1.9.x
PHP ab 5.3.7
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.
Loading Indicator anzeigen | Dieses Dropdown Ihnen im Checkout ein Laderad anzeigen zu
lassen, solange die PSP geladen wird.
Bestellnummer als PayPal Rechnungsnummer übertragen| Mit diesem Dropdown
ermöglichen Sie die Übertragung der Bestellnummer als Rechnungsnummer an PayPal
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-Drittanbieter 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
Debug | Durch den Debug-Modus werden API-Fehler im Frontend angezeigt.
Kauf auf Rechnung in der Sandbox anzeigen| Mit diesem Dropdown können Sie die
Zahlungsmethode „Kauf auf Rechnung“ in dem Sandboxmodus von PayPal Plus für das Testen
nutzen
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-PayPalModuls, 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.
Backend Entwicklereinstellung
Wenn Sie „Kauf auf Rechnung“ im Sandbox-Modus testen wollen, müssen Sie die Option in den
Entwicklereinstellungen von PayPal PLUS aktivieren.
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
ArtderZahlung.Immer:
"PAY_UPON_INVOICE"
string
ppp_pui_payment_due_date
FälligkeitsdatumderZahlung
string
ppp_pui_note
Kommentar
string
Name
Beschreibung
Typ
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
PPPM-FAQ
Problem
Die Zahlungsmethode erscheint im Checkout und der iFrame wird geladen. Allerdings werden die
Radiobuttons angezeigt und der Checkout ist nicht im PPP-Design.
Lösung
Überprüfen von welchem Modul der Block Payment_Method überschrieben wird und als depends
in app/etc/modules/Iways_PayPalPlus.xml einfügen.
Beispiel:
<?xml version="1.0"?>
<config>
<modules>
<Iways_PayPalPlus>
<active>true</active>
<codePool>community</codePool>
<depends>
<Netresearch_Billsafe />
</depends>
</Iways_PayPalPlus>
</modules>
</config>
Problem
Die Thirdparty Payment Methoden werden in Look and Feel von PayPal angezeigt, allerdings ist
die Zahlungsmethode iways_paypalplus_payment nicht verfügbar.
Lösung
Es muss geprüft werden, ob die Zahlungsmethode für diese Bestellung und Versand und
Rechnungsadresse verfügbar ist. Es kann durch aus auch an anderen Modulen
wie RicoNeitzel_PaymentFilter liegen. In diesem Modul z.B. muss die Zahlungsmethod eextra in
den Kundengruppen aktiviert werden.
Problem
Bei aktivierten Idev_Onestepcheckout kommt die Fehlermeldung "paymentId cannot be null"
beim abschicken der Bestellung.
Lösung
In der Konfiguration des Idev_Onestepcheckouts muss PayPal Plus als standard
Zahlungsmethode eingestellt werden.
Problem
Es wird nur PayPal in der Listung der Bezahlmethoden ohne Kreditkarte und Lastschrift
angezeigt, obwohl PayPal Plus und nicht nur Express Checkout aktiv ist:
Lösung
In Ihrem PayPal Konto ist der mögliche Empfang von Gastzahlungen ausgestellt. Aktivieren Sie
diesen wieder:
Mein Profil => Verkäufer/Händler => Einstellungen für verschlüsselte Zahlungen => WebsiteZahlungsoptionen