Falls Sie kein xt_grid Template einsetzen empfehlen wir die kostenlose Integration/Einrichtung durch xt:Commerce.
Wenden Sie sich bitte an unseren Support.
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" sind. Es handelt sich hier um unterschiedliche Daten!
Nun wechseln Sie zurück in den Adminbereich Ihres Shop und prüfen Sie ob sich der Shop im Modus "default ssl", "full ssl" oder "ssl proxy" befindet. 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 |
|---|---|---|
| Testmodus (Sandbox): | Die Option entscheidet ob Sie den Test-Modus oder den Live-Modus verwenden wollen. | |
| Client ID (Live): | Wie Sie diese Daten anlegen finden Sie hier: PayPal PLUS - Erstellen einer 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: | ||
| CSS-Selektoren des Kommentarfelds auf der Seite Zahlungsweise: | ||
| 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. |
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.
Wichtige Hinweise:
Die API von PayPal sieht nicht vor, dass auf der Checkout-Confirmation-Seite der Artikel-Preis geändert werden kann. Daher müssen Sie "Plugins => installierte Plugins => xt_coupons (bearbeiten)" die Option "Checkout-Seite" auf false stellen.
Dieses bewirkt, dass das Feld zur Gutscheineingabe nicht mehr auf dieser Seite angezeigt wird. Stattdessen sollten Sie das Feld im Warenkorb aktivieren. Bedenken Sie, dass das Feld in dieser Position nur angezeigt wird wenn der Kunde eingeloggt ist.
Sollten Sie Plugins nutzen, die ähnliche Funktionen (z.B. Anpassungen an den Preise der Produkte) auf der Checkout-Confirmation Seite einbinden sollten Sie prüfen ob diese vielleicht deaktiviert werden müssen.
Plugin-Empfehlung
Falls Sie die Zahlungsweise für bestimmte Produkte oder Kategorien sperren müssen empfehlen wir folgendes Plugin: xt_payment_restrictions - Zahlungsweisen sperren für Produkte und Kategorien