Installations-Anleitung PayPal Plus für WooCommerce

Transkript

1 Dies ist das PDF-Handbuch für das offizielle Plugin. Erfahren Sie hier, wie Sie PayPal Plus in wenigen Schritten in Ihren WooCommerce Shop integrieren. Plugin Version: vom Eine Kooperation von PayPal und der Inpsyde GmbH

2

3 ist das offizielle PayPal Plus Plugin. PayPal Plus erlaubt Ihnen, neben PayPal drei weitere Zahlungsmöglichkeiten im WooCommerce Shop anzubieten. Diese sind Zahlung über Kreditkarte, Lastschrift oder per Rechnung. Download: WordPress.org. Siehe Changelog Voraussetzungen Um PayPal Plus zusammen mit WooCommerce nutzen zu können sind folgende Mindestanforderungen nötig: WooCommerce 3.0 oder höher PHP 5.6 oder höher MySQL 5.6 oder höher WordPress 4.4+ WP Memory limit mind. 64 MB (128 MB oder höher empfohlen) ein freigeschalteter PayPal Plus Account Installation 1. Gehen Sie zu Plugins > Installieren in Ihrer WordPress Seite. 2. Geben Sie PayPal PLUS für WooCommerce im Suchfeld ein. Autor ist Inpsyde GmbH. 3. Klicken Sie Jetzt installieren und Aktivieren. Seite 1/24

4 Anmeldung/Registrierung Um PayPal Plus nutzen zu können, benötigen Sie ein PayPal-Geschäftskonto, das für PayPal PLUS freigeschaltet ist. Des Weiteren benötigen Sie eine REST Applikation, um Ihre PayPal Zugangsdaten abfragen zu können. Hier finden Sie den Antrag zur PayPal Plus Kontoeröffnung für Geschäftskunden: signuptype=create_new_account&productintentid=ppp Im unteren Bereich REST Applikation erstellen finden Sie eine Anleitung, um eine REST Applikation zu erstellen. Seite 2/24

5 Einrichtung und Konfiguration Gehen Sie zum linken Administrations Menü und klicken Sie auf WooCommerce. Klicken Sie dann auf Einstellungen. Auf der WooCommerce Einstellungsseite wählen Sie den Reiter Kasse und dann PayPal PLUS aus. Seite 3/24

6 1. Aktivieren/Deaktivieren Um das Gateway aktivieren und wieder deaktivieren zu können, klicken Sie in die Checkbox mit dem Titel PayPal Plus aktivieren. 2. Titel Unter Titel tragen Sie Ihre gewünschten Zahlarten ein. Sie können PayPal/Lastschrift/Kreditkarte oder auch PayPal/Lastschrift/Kreditkarte/Rechnung wählen, wenn Sie über PayPal PLUS auch den Kauf auf Rechnung anbieten wollen. Diesen Titel des Zahlungs-Gateways sehen die Benutzer während des Zahlungsvorgangs an der Kasse. Seite 4/24

7 3. Beschreibung Tragen Sie unter Beschreibung die Zahlarten PayPal/Lastschrift/Kreditkarte oder ggf. auch PayPal/Lastschrift/Kreditkarte/Rechnung ein, wenn Sie über PayPal PLUS auch den Kauf auf Rechnung anbieten möchten. Seite 5/24

8 4. PayPal Sandbox / Live Modus Mit der Option PayPal Sandbox können Sie entscheiden, welches System Sie ansprechen möchten: Die PayPal-Sandbox für Testzwecke oder das PayPal-Produktivsystem. Hinweis: Im Testmodus können Sie ausschließlich mit PayPal-Sandbox-Konten arbeiten. Im Live-Modus hingegen können Sie nur mit PayPal-Live-Konten arbeiten. Wenn Sie das Häkchen bei PayPal Sandbox aktivieren entfernen, verändern sich die Eingabefelder von Sandbox Client ID zu Live Client ID und von Sandbox Secret ID zu Live Secret ID. Seite 6/24

9 Um eine Verbindung zu Ihrem PayPal-Geschäftskonto herzustellen, tragen Sie unter Live Client ID Ihre Client ID ein. Außerdem geben Sie unter Live Secret ID Ihren SecretSchlüssel für die Live-Umgebung und, sofern zutreffend, auch für die Sandbox ein. Eine Anleitung wie Sie eine Live Client ID und Live Secret ID generieren können, finden Sie im unteren Abschnitt unter REST Applikation erstellen und REST Live Client ID und Live Secret ID Zugangsdaten abfragen. 5. Experience Profil ID/Sandbox Experience Profil ID Die Experience Profil ID wird automatisch generiert, sobald Sie Ihre Eingaben speichern Seite 7/24

10 6. Firmenname Tragen Sie Ihren Firmennamen unter Firmenname ein. 7. PayPal Checkout Logo (190x60px) Legen Sie nun die https-source zu Ihrem Logo fest. Diese wird dann auf den von PayPal gehosteten Seiten angezeigt. Beispiel: Der Link zur Ihrem Logo über eine mit SSL geschützten Verbindung (SSL) wird empfohlen. Sollten Sie das Logo über eine nicht gesicherte Webseite, beispielsweise einbinden, kann es zu mehreren Fehlermeldungen im Browser kommen. Des Weiteren ist die gesicherte Übertragung der sensiblen Kundendaten nicht mehr vollständig gewährleistet. Bei einer nicht vollständig gesicherten Verbindung (SSL) kann PayPal den Bezahlvorgang widerrufen. Hinweis: Bitte achten Sie darauf, dass das Format Ihres Logos *.gif, *.jpg oder *.png ist. Außerdem sollte es die Größe 190 x 60 Pixel vorweisen. 8. Rechnungspräfix Geben Sie an dieser Stelle ein Präfix für die Rechnungsnummern ein. Seite 8/24

11 Hinweis: Stellen Sie sicher, dass das Präfix einzigartig ist, falls Sie Ihr PayPal-Konto für mehrere Shops verwenden. Andernfalls wird PayPal keine Bestellungen mit identischer Rechnungsnummer akzeptieren. 9. Bestellung abgebrochen Seite Hier können Sie angeben, wohin Ihre Besucher, die den Zahlungsvorgang bei PayPal abgebrochen haben, weitergeleitet werden sollen. Seite 9/24

12 10. Benutzerdefinierte Abbruch-URL URL zu einer benutzerdefinierten Seite, zu der Besucher nach Abbruch der Bezahlung weitergeleitet werden. Bitte wählen Sie "benutzerdefiniert" zunächst im Dropdown Menü Bestellung abgebrochen Seite oben aus. Seite 10/24

13 11. Rechtliche Hinweise für die Bezahlung per Rechnung Hier finden Sie die rechtlichen Hinweise, die zur Danke- Seite und in s eingefügt werden. 12. Anweisungen für die Bezahlung per Rechnung Das sind die Anweisungen an die Käufer, die sich für die Bezahlung per Rechnung entschieden haben. Sie werden zur Danke -Seite und in s eingefügt. 13. Log-Datei herunterladen Um die Log-Datei herunterzuladen, gehen Sie bei WooCommerce zu System Status und dann zu Logs. Wählen Sie dann die Datei paypal_plus-...log aus und kopieren Sie den Inhalt. Fügen Sie ihn dem Ticket hinzu, wenn Sie den Support kontaktieren. 14. Abschalten der Standard-Gateway-Überschreibung Unabhängig von der Position in der Liste der aktivierten Gateways wird PayPal Plus als Standard-Payment-Gateway ausgewählt. Sollten Sie ein anderes als PayPal Plus als Standard-Payment-Gateway haben wollen, entfernen Sie bitte das Häkchen bei der Checkbox Deaktivieren. Seite 11/24

14 15. Änderungen speichern Wenn Sie alle Angaben eingegeben und überprüft haben, klicken Sie bitte auf den Button Änderungen speichern. Seite 12/24

15 REST Applikation erstellen und REST Live Client ID und Live Secret ID Zugangsdaten abfragen Sie müssen sich auf mit Ihren PayPal-Login-Daten einloggen, um die REST Applikation zu erstellen. Wählen Sie in der linken Sidebar "My Apps & Credentials" und klicken Sie im unteren Bereich Rest API apps auf den Button "Create App". Sollten Sie bereits Sandbox-Accounts erstellt haben, können Sie an dieser Stelle die App mit den Accounts verknüpfen. Für Live-Transaktionen wählen Sie den dort gelisteten facilitator account (DE). Überprüfen Sie die Detailangaben. Wenn alles richtig ist, kopieren Sie anschließend die Client-ID sowie das Secret. Sie sehen das Secret, wenn Sie auf Show klicken. Anschließend fügen Sie die Daten an entsprechender Stelle innerhalb der Konfigurationsseite des PayPal Plus Plugins ein. Das ist entweder bei Live ID und Secret ID oder Sandbox Client ID und Sandbox Secret ID. Seite 13/24

16 Bitte beachten Sie, dass Ihnen auf der PayPal Developer Website auch die Zugangsdaten für die Sandbox angezeigt werden. Wenn Sie die Zugangsdaten für die Live-Umgebung die API Credentials haben möchten, wählen Sie oben rechts den Button Live aus. Wenn Sie die Zugangsdaten für die Sandbox haben möchten, klicken Sie auf den Button Sandbox. Sie erhalten in Live den Hinweis, dass möglicherweise nicht alle Features zur Verfügung stehen. Dieser Hinweis wird automatisch erstellt. Er wird nicht aufgrund einer Prüfung verfügbarer Features angezeigt. Test Modus - Sandbox 1. Sandbox Übersicht Die PayPal-Sandbox spiegelt die Funktionen der Produktionsserver von PayPal wieder. Einige PayPal-Funktionen gelten allerdings nicht für die Sandbox. Das ist zum Beispiel das Schließen eines Kontos, das Ausstellen monatlicher Kontoauszüge oder das Speichern von Versandeinstellungen. Nichtsdestotrotz ist die Sandbox mit dem PayPal-API-Feature, welches von der Live-Umgebung unterstützt wird, kompatibel. Dies bedeutet also, dass Sie mit der Sandbox Ihre PayPal Prozesse testen können und wissen, dass sie sich auf den Produktionsservern genauso verhalten werden wie in der Sandbox-Umgebung. Seite 14/24

17 Weil fiktive Sandbox-Testkonten und die dazugehörigen Authentifizierungsdaten in Ihren PayPal-API-Aufrufen verwendet werden, können Sie Ihre Anwendung testen und debuggen, ohne auf echte PayPal-Nutzer oder deren Live-PayPal-Konten zu verweisen. Mit der Sandbox können Sie Ihre Anwendung in einer sicheren Umgebung betreiben und Ihre PayPal-Routinen optimieren, bevor Sie Ihr Produkt in die Produktion bringen. Beim Start einer Transaktion im Sandbox-Konto erstellt PayPal eine Scheintransaktion, die sich genau wie eine Transaktion in der Live-Umgebung verhält. Alle Sandbox-Transaktionen werden auf der Sandbox-Testseite nachverfolgt. Ebenso werden alle Live-Transaktionen auf der PayPal-Live-Website nachverfolgt. 2. Sandbox Konto erstellen Um ein Sandbox Konto zu erstellen, melden Sie sich auf der Entwickler-Website unter an. Gehen Sie dann auf der Registerkarte Dashboard zu Sandbox und wählen Sie Konten aus. Klicken Sie auf Konto erstellen und füllen Sie die folgenden Felder aus: Land Wählen Sie das Land des Händler- oder Käufertest-Kontos aus. Kontotyp Wählen Sie entweder Persönlich oder Unternehmen aus. Seite 15/24

18 -Adresse Die -Adresse muss keine echte -Adresse sein. Die Sandbox sendet keine s außerhalb der Sandbox-Umgebung. Passwort Das Passwort muss 8-20 alphanumerische Zeichen lang sein. Verwenden Sie das Kennwort, um sich als Testkonto bei der Sandbox-Testseite anzumelden. Vor- und Nachname Die Namensfelder akzeptieren nur alphabetische Zeichen. Diese Felder sind optional. PayPal-Kontostand Dieses Feld ist optional. Geben Sie einen ganzzahligen Wert zwischen 1 und 10 Millionen ein. Bank Überprüftes Konto Erstellen Sie sowohl verifizierte als auch nicht bestätigte Testkonten. So können Sie Ihre Anwendung vollständig testen. Zahlungskarte auswählen Diese Einstellung ist nur bei US-Privatkonten relevant. Testen Sie Zahlungen mit verschiedenen Zahlungskarten, indem Sie entweder Discover oder PayPal auswählen. Kreditkartentyp Auch dies ist ein optionales Feld. Sie können für jedes Testkonto einen einzelnen Kreditkartentyp auswählen. Die Sandbox verknüpft eine Schein-Kreditkartennummer mit dem Konto. Wenn Sie alle notwendigen Daten eingegeben haben, klicken Sie auf Konto erstellen. Die PayPal-Sandbox-Umgebung umfasst Folgendes: Die Sandbox-Testseite ( sowie die Verwaltung der Sandbox Accounts. Zugriff über 3. Sandbox API Details in PayPal Plus eingeben Um die Sandbox API Details einzugeben, müssen Sie zu den Einstellungen von PayPal Plus gelangen. Gehen Sie dafür zum linken Administration Menü und klicken Sie auf WooCommerce. Klicken Sie dann auf Einstellungen. Auf der WooCommerce Einstellungsseite wählen Sie den Reiter Kasse und dann PayPal PLUS aus. Seite 16/24

19 Setzen Sie bei PayPal Sandbox aktivieren ein Häkchen, wenn sich Ihr Shop momentan im Live Modus befindet. Geben Sie nun die generierte Sandbox Live ID und Sandbox Secret ID in die dafür vorgegeben Felder ein. Seite 17/24

20 Unter dem obigen Punkt Erstellen einer REST-Applikation und Abfragen der RESTZugangsdaten ist beschrieben, wie Sie diese generieren. 4. Sandbox mit PayPal Plus testen Mit der Option PayPal Sandbox legen Sie fest, ob Sie die PayPal-Sandbox für ein TestProduktivsystem ansprechen wollen. Hinweis: Im Testmodus können Sie ausschließlich mit PayPal-Sandbox-Konten arbeiten. Workflow Kassenbereich Nachdem Sie PayPal Plus aktiviert haben, wird im Kassenbereich Ihres Shops das PayPal Plus iframe mit den o.g. Zahlungsarten angezeigt. Nach erfolgreichem Abschluss einer Bestellung leiten Sie Ihre Kunden direkt nach der Auswahl einer PayPal PLUS Zahlungsmethode auf die PayPal-Seite weiter. Dort können sie die Zahlung bestätigen. Seite 18/24

21 Hinweis: Die Option Kauf auf Rechnung muss PayPal separat freischalten. Häufig gestellte Fragen Was sind die Mindestanforderungen, um PayPal Plus nutzen zu können? Um PayPal Plus zusammen mit WooCommerce nutzen zu können sind folgende Mindestanforderungen nötig: WooCommerce 3.0 oder höher PHP 5.6 oder höher MySQL 5.6 oder höher WordPress 4.4+ WP Memory limit mind. 64 MB (128 MB oder höher empfohlen) Wird Payment Action AUTHORIZE PayPal Plus unterstützt? Technisch wäre dies machbar. PayPal lehnt dies allerdings ab, da über AUTHORIZE die Zahlmethode Zahlung per Rechnung nicht möglich ist. Kann ich Woo PayPal Plus mit WooCommerce < 3.0 nutzen? Nein, das Plugin ist nur mit WooCommerce Versionen 3.0 und höher kompatibel. Seite 19/24

22 Was muss ich beachten, wenn ich PayPal Plus in mehreren Shops verwende? Sie müssen zwingend in den Einstellungen von für jeden Shop einen eindeutigen Rechnungspräfix vergeben. Andernfalls akzeptiert PayPal keine Bestellungen mit identischer Rechnungsnummer. Für welche Länder kann ich PayPal Plus nutzen? Derzeit können Sie PayPal Plus nur für Deutschland nutzen. Welche Zahlungsarten kann ich einbinden? Sie können die vier Zahlungsarten PayPal, Lastschrift, Kreditkarte und Rechnung einbinden. In meinem Shop wird die Zahlungsart Rechnung nicht angeboten. Was muss ich tun? Das PayPal Verkäufer-Konto muss von PayPal für den Kauf auf Rechnung freigeschaltet werden. Bis PayPal Ihr Konto geprüft und freigeschaltet hat, können ein paar Wochen vergehen. Kann ich PayPal Plus für digitale Produkte nutzen? Ja, das ist möglich. Die Option Kauf per Rechnung steht für digitale Produkte allerdings nicht zur Verfügung. Wie kann ich die Zahlungsmethode Zahlung auf Rechnung ausblenden? Als Händler werden Sie bei der Anmeldung zu PayPal Plus explizit gefragt, ob Sie Rechnung als Zahlungsart anbieten möchten. Sollten Sie bereits Rechnung als Zahlungsart anbieten und deshalb diese PayPal Plus Zahlungsmethode deaktivieren wollen, kontaktieren Sie bitte PayPal. Erlaubt PayPal Plus Abo-Zahlungen? Aktuell sind Abo-Zahlungen mit PayPal Plus nicht möglich. Ist mit PayPal Plus Ratenzahlung möglich? Ratenzahlung ist ein eigenes Produkt von PayPal, das einer individuellen Integration bedarf. Außerdem muss sich jeder Händler freischalten lassen. Wenn die beiden Integrationen Ratenzahlung und PayPal Plus zusammen betrieben werden, taucht Ratenzahlung als weitere Zahlart unter PayPal Plus auf. Ratenzahlung kann aber auch alleine betrieben Seite 20/24

23 werden. Ratenzahlung ist also theoretisch möglich, praktisch gibt es bisher aber derzeit noch kein Modul für WooCommerce. Wieso wird das iframe auf der Kasse-Seite nicht angezeigt? Vermutlich ist der PayPal Plus Account noch nicht für Live freigeschaltet. Wie bekomme ich die Icons neben den einzelnen Payment Methoden im iframe angezeigt? Die Icons sollten immer angezeigt werden. Ausnahme sind mobile Endgeräte, deren Bildschirme zu klein für die Anzeige sind. Können Zahlungsweisen von Drittanbietern in das iframe aufgenommen werden? Im iframe lassen sich bis zu 5 weitere Zahlungsweisen wie z.b. Sofortüberweisung oder Vorkasse einbinden. Kann man auch nur Kreditkarte oder nur per Lastschrift anbieten? Nein, Lediglich Kauf auf Rechnung kann optional hinzugefügt oder abgewählt werden. Gelten für alle Zahlarten die gleichen Garantien für Händler wie beim klassischen PayPal? Ja, für alle Zahlarten gilt der Verkäuferschutz. Können Käufer wie gewohnt einen Käuferschutzfall eröffnen? In jedem Fall müssen Kunden ein, die als Gast bezahlen, ein PP Kundenkonto eröffnen, um vom PP Käuferschutz zu profitieren Funktioniert PayPal Plus auch für internationale Transaktionen? Derzeit ist PayPal Plus nur für Händler in Deutschland verfügbar. Ihre Käufer können aber weltweit bei Ihnen einkaufen und bezahlen. Bekommt ein Händler bei allen Zahlarten sofort sein Geld? Sie erhalten Ihr Geld in der Regel unmittelbar nach Kaufabschluss bei allen vier PP+ Zahlungen. Seite 21/24

24 Fragen und Feedback Sie haben weitere Fragen zu oder benötigen Support? Bitte senden Sie eine an Seite 22/24