Installation und Konfiguration PayPal PLUS

Die aktuellste Version des Plugins finden Sie in unserem Marketplace. Allgemeine Informationen zur Installation und Konfiguration finden Sie unter Plugins, Addons & Erweiterungen und Zahlungsweisen.

Direkt von PayPal finden Sie ein Installations-Tutorial auf YouTube:

Systemvoraussetzungen

Alle aktuelle Systemanfoderungen von xt:Commerce und PayPal Sicherheitsfahrplan 2017-2018
Der Shop muss über ein aktives SSL-Zertifikat (kein Proxy) verfügen.
Wenn Sie Strato verwenden nehmen Sie bitte diese Einstellung vor.
"Mod Rewrite URL" und "SEO-URLs für Seiten (pages)" müssen aktiviert sein (siehe Suchmaschinen).
PayPal erlaubt keine Kommastellen bei der Stückzahl.
Kundenseitig wird beim Internet Explorer von Microsoftt mind. die Version 10 benötigt. Der Kunde wird im Checkout entsprechend darauf hingwiesen.

Installation

Vorbereitungen:

PayPal-API- & PayPal-Sandbox-API-Daten:

Die PayPal-Sandbox erlaubt Ihnen Test-Transaktionen vorzunehmen, ohne dass diese echte Kosten verursachen. Unter developer.paypal.com können Sie sich einen Sandbox-Account erstellen und innerhalb von diesem Account eine App anlegen.

Folgen Sie dieser Anleitung um einen Account zu erstellen bzw. die API-Daten auszulesen.

Nachdem die App erstellt wurde können Sie diese in der Liste anklicken und die "Client ID" sowie das "Secret" wird Ihnen angezeigt.

Wichtig: Bitte beachten Sie, dass die "Client ID" und das "Secret" nicht identisch mit den mit "Username", "Password" und "signatur" aus dem Standard-Paypal sind. Es handelt sich hier um unterschiedliche Daten für Paypal Plus!

In einer Multishop-Installation erstellen Sie bitte für jeden Shop eine eigene REST Applikation.

Ab Plugin-Version 1.7.2 müssen Sie nicht mehr für jeden Shop einer Multishop-Installation eine separate App anlegen, können dies aber tun.

Direkt von PayPal finden Sie ein Tutorial auf YouTube:

Nun wechseln Sie zurück in den Adminbereich Ihres Shop und prüfen Sie ob sich der Shop im SSL-Modus befindet. Dies ist für die Verwendung von Paypal vorgeschrieben.
Sie finden die Option in "Shop-Einstellungen => Mandanten => Ihr Mandant => SSL".

Sollte sich der Shop in einem anderen Modus befinden, müssen Sie dieses anpassen. (Wichtig: Damit Ihr Shop mit SSL-Funktioniert wird natürlich ein SSL-Zertifikat benötigt, kontaktieren Sie diesbezüglich Ihren Webhoster falls Sie hierzu Fragen haben.)

Laden Sie die Dateien des Plugins in den Ordner /plugins/ in Ihren Shop und prüfen Sie ob das Plugin unter deinstalliere Plugins angezeigt wird. Falls Ja, betätigen Sie den "Installieren"-Knopf.

Wechseln Sie nun in "Installierte Plugins" und aktivieren Sie das Plugin. Laden Sie nun den Adminbereich (z.B. mit der F5 Taste Ihres Browsers) neu.

(Sollten Sie auf Probleme stoßen, finden Sie hier eine detaillierte (generelle) Anleitung zur Plugininstallation. )

Achtung!

Bitte warten Sie die Freischaltungs E-Mail von PayPal ab bevor Sie die Zahlungsweise in Ihrem Shop integrieren.

Konfiguration

Öffnen Sie danach die Zahlungsweisen-Optionen von PayPal-Plus (Einstellungen => Zahlungsweise => xt_paypal_plus (bearbeiten) ).

Aktivieren Sie das Plugin mit der Option "Status".

Was	Erklärung	Empfehlung Bestelstatus-Mapping

Was	Erklärung	Empfehlung Bestelstatus-Mapping
Testmodus (Sandbox):	Die Option entscheidet ob Sie den Test-Modus oder den Live-Modus verwenden wollen. (Im Test-Modus funktionieren nur Sandbox-Accounts, im Live-Modus nur "echte" PayPal-Accounts)
Client ID (Live):	Wie Sie diese Daten anlegen finden Sie hier: PayPal PLUS - Erstellen einer REST Applikation In einer Multishop-Installation erstellen Sie bitte für jeden Shop eine eigene REST Applikation.
Secret (Live):
Client ID (Sandbox):
Secret (Sandbox):
Bestellstatus - Zahlung abgeschlossen (Approved):	Die Zahlung war erfolgreich	Zahlung erhalten
Bestellstatus - Zahlungsforderung (ELV) erstellt (Created):	Die Zahlungsforderung (ELV) wurde gestellt. Der Betrag wird transferiert, sobald die Zahlung abgeschlossen wurde	Offen
Bestellstatus - Fehler:	Die Zahlung ist fehlgeschlagen. Dies geschieht nur, wenn die Zahlung vom Konto Ihres Kunden werden sollte	Offen
Bestellstatus - In Bearbeitung:	Die Zahlung ist bei Paypal in Bearbeitung	Offen
Bestellstatus - Abgebrochen (Canceled):	Die Zahlung wurde durch Paypal abgebrochen	Offen
Bestellstatus - Abgelaufen:	Die Zahlungsautorisierung ist abgelaufen (technischer Grund)	Offen
Bestellstatus - Zurückgezahlt:	Die Zahlung wurde zurückerstattet	Zahlung storniert
CSS-Selektoren des Next-Button auf der Seite Zahlungsweise:	Tragen Sie hier den eindeutigen CSS-Selektor des 'Weiter'-Buttons ein. Hinweise
CSS-Box-Selektoren einer einzelnen Zahlungsweise auf der Seite Zahlungsweise:	Voreinstellung für `xt_responsive grid/elevation mobile bb_bootstrap3`
New Order Status:	Eine Bestellung wurde angelegt	Offen
Status-E-Mail versenden bei IPN:	Hier legen Sie fest ob eine "update_order-admin" E-Mail bei IPNs gesendet werden soll.
Rechnungskauf in Sandbox anzeigen:	Bitte beachten Sie das der Rechnungskauf in der LIVE Umgebung für Ihr PayPal Konto erst nach Freischaltung durch PayPal verfügbar.

Es können neben PayPal PLUS nur maximal 5 weitere Zahlungsweisen eingesetzt werden.

API-Logging

Am Plugin können Sie das API-Logging aktivieren. Sie finden die Logs unter xtLogs/paypal_plus.log.

Bitte testen Sie die Anzeige auf der checkout/payment im Shop nach der Integration erst im Sandbox-Modus. Erst wenn dies erfolgreich war testen Sie bitte im Live-Modus.