konfiguration.rst

Konfiguration

Machen Sie das Modul PayPal Checkout für Ihren OXID eShop betriebsbereit.

Sie haben bereits PayPal oder PayPal Plus?

Sorgen Sie für einen reibungslosen Übergang zum neuen Modul PayPal Checkout.

Beachten Sie dazu die beiden folgenden Einschränkungen:

• Sie können PayPal Checkout nicht mit Ihren PayPal Plus-Zugangsdaten betreiben. Folgen Sie den Anweisungen unter konfiguration:PayPal-Registrierung für PayPal Checkout neu durchlaufen.
• Um bereits existierende Bestellungen verwalten zu können, müssen beide Module, beispielsweise PayPal Checkout und PayPal, gleichzeitig aktiv sein. Folgen Sie den Anweisungen unter konfiguration:Existierende PayPal- oder PayPal Plus-Bestellungen verwalten.

PayPal-Registrierung für PayPal Checkout neu durchlaufen

Wenn Sie PayPal Plus haben, beachten Sie Folgendes:

Die Zugangsdaten und der Anmeldeprozess von PayPal Checkout sind äußerlich ähnlich wie bei PayPal Plus.

Lassen Sie sich dadurch jedoch nicht dazu verleiten, die Zugangsdaten von PayPal Plus wiederzuverwenden.

Dies würde zu den folgenden unerwünschten Verhalten führen:

• Die Webhooks werden nicht korrekt aktiviert, Informationen werden nicht korrekt übermittelt, ohne dass jedoch die Fehler sofort erkennbar sind.
• Zahlungsarten wie Ratenkauf stehen nicht zur Verfügung, die Zahlung mit Kreditkarte wird nicht freigeschaltet.

Tun Sie Folgendes:

1. Testen Sie PayPal Checkout in der PayPal-Sandbox mit Test-Konten wie beschrieben unter konfiguration:PayPal Checkout konfigurieren.
2. Generieren Sie für das Freischalten Ihres Live-Systems die Zugangsdaten neu. Durchlaufen Sie dazu den PayPal-Registrierungs-Prozess mit Ihren PayPal-Händlerkonto-Daten erneut.

Existierende PayPal- oder PayPal Plus-Bestellungen verwalten

Wenn Sie bereits das Modul PayPal oder PayPal Plus nutzen, beachten Sie folgende Einschränkung:

Um bereits existierende Bestellungen verwalten zu können, müssen beide Module, beispielsweise PayPal Checkout und PayPal gleichzeitig aktiv sein.

Damit jedoch in unserem Beispiel die Zahlungsart PayPal im Frontend nicht redundant angezeigt wird, müssen Sie die Zahlungsart PayPal deaktivieren.

Wir empfehlen folgendes Vorgehen.

Tip

Downtime einplanen

Planen Sie für den Schritt des Deaktivierens der zu PayPal oder PayPal Plus gehörenden Zahlungsart eine kurze Downtime ein.

1. Installieren Sie PayPal Checkout.

2. Aktivieren und konfigurieren Sie PayPal Checkout wie im Folgenden unter konfiguration:Grundsätzliches Vorgehen beschrieben. Resultat: Um Ihre Bestellungen zu verwalten, finden Sie unter Bestellungen verwalten --> Bestellungen separate Registerkarten für die Module PayPal Checkout sowie für PayPal oder PayPal Plus (je nach dem, welches der beiden Module Sie nutzen).

   Note

   Bestellungen im PayPal-Händlerkonto verwalten

   Schiefgehen kann nichts, wenn Sie wie im Folgenden beschrieben PayPal oder PayPal Plus deaktivieren.

   Sie können Bestellungen jederzeit in Ihrem PayPal-Händlerkonto verwalten.

   Technische Abhängigkeiten

   Auf der separaten Registerkarte für PayPal oder PayPal Plus können Sie Ihre alten Bestellungen so lange bearbeiten, bis Sie Ihr bisher genutztes Modul deaktivieren.

   Sobald Sie Ihr bisher genutztes Modul deaktivieren, können Sie Ihre alten Bestellungen auf der Registerkarte PayPal Checkout noch anzeigen, aber nicht bearbeiten.

   Wenn Sie nach dem Deaktivieren Ihres bisher genutzten Moduls Ihr System aufräumen und deshalb auch die Datenbank des Moduls löschen, werden Ihre alten Bestellungen auch auf der Registerkarte PayPal Checkout nicht mehr angezeigt.

   Nach dem Löschen der Datenbank können Sie Ihre alten Bestellungen weiterhin im PayPal-Händlerkonto anzeigen und verwalten.

3. Schalten Sie PayPal Checkout für den Live-Betrieb frei wie unter konfiguration:PayPal Checkout freischalten.
4. Wählen Sie Shopeinstellungen --> Zahlungsarten.

5. Identifizieren Sie die Zahlungsarten, die zu PayPal oder PayPal Plus gehören:

   • PayPal (ID: oxidpaypal)
   • PayPal Plus (ID: payppaypalplus)

   Hint

   Die ID wird in der linken unteren Ecke des Fensters angezeigt, wenn Sie mit der Maus über den Namen der Zahlungsart fahren.

6. Deaktivieren Sie die zu PayPal oder PayPal Plus gehörende Zahlungsart. Dazu deaktivieren Sie auf der Registerkarte Stamm das Kontrollkästchen Aktiv. Resultat: Das Modul PayPal oder PayPal Plus ist noch aktiv, aber die zugehörigen Zahlungsarten werden Ihren Kunden nicht mehr angeboten. Nur die Zahlungsarten von PayPal Checkout werden angeboten. Sie können bereits existierende Bestellungen unter Bestellungen verwalten --> Bestellungen auf der betreffenden Registerkarte weiterhin wie gewohnt bearbeiten.
7. Empfohlen: Sobald Sie sicher sind, dass bei bestehenden Bestellungen keine Aktionen (beispielsweise Rückerstattung) mehr nötig sein werden, deaktivieren Sie PayPal oder PayPal Plus unter Erweiterungen --> Module.

Grundsätzliches Vorgehen

1. Aktivieren Sie das Modul. Die wichtigsten Zahlungsmethoden sind damit automatisch aktiviert.

2. Stellen Sie über einen Webhook die Verbindung zu PayPal her.

   Attention

   • Benutzen Sie zum Herstellen der Verbindung nicht die Zugangsdaten für PayPal Plus.
   • Testen Sie PayPal Plus zunächst in der PayPal-Sandbox.
3. Optional: Deaktivieren Sie bei Bedarf die Express-Checkout-Funktion von PayPal Checkout.
4. Optional: Legen Sie fest, ob Sie Ihren Kunden die PayPal-Ratenzahlung anbieten wollen (siehe oxdajr08).
5. Kontaktieren Sie bei Bedarf den PayPal-Kundenservice, um das für Ihren Fall optimale Verfahren festzulegen, wie PayPal mit der 3D Secure-Authentifizierung umgeht (siehe oxdajr11).
6. Konfigurieren Sie die von PayPal Checkout bereitgestellten Zahlungsmethoden als Zahlungsarten in Ihrem eShop:
   • Aktivieren Sie die Länder, die Sie abdecken wollen.
   • Verknüpfen Sie die Zahlungsarten mit Ihren Versandarten und Versandkostenregeln.
7. Führen Sie Testzahlungen in der PayPal Checkout-Sandbox aus. und passen Sie die Konfiguration an, bis alle Zahlungsprozess nach Ihren Vorstellungen funktionieren.
8. Schalten Sie PayPal Checkout frei:
   1. Wenn Sie noch kein Händlerkonto haben, legen Sie für den Livebetrieb eins an.
   2. Wechseln Sie in den Betriebsmodus Live.

9. Bei Bedarf: Wenn Sie besonders datenschutzsensible Kunden haben, implementieren Sie ein Zustimmungsverfahren, beispielsweise mit Usercentrics.

   Weitere Informationen finden Sie unter cmp-integration:Consent Management-Platformen integrieren.

PayPal Checkout aktivieren

Stellen Sie sicher, dass PayPal Checkout in jedem Subshop aktiviert ist, in dem Sie das Modul nutzen wollen.

1. Wählen Sie Erweiterungen --> Module.
2. Wählen Sie das Modul PayPal Checkout für OXID und wählen Sie Stamm --> Aktivieren.

Unter Shopeinstellungen --> Zahlungsarten sind die Zahlungsarten PayPal sowie wichtige weitere Zahlungsarten als aktiv gekennzeichnet.

Um eine bestimmte länderspezifische Zahlungsart tatsächlich nutzen zu können, müssen Sie unter Stammdaten --> Länder das betreffende Land als aktiv markiert haben.

Um iDEAL anbieten zu können, müssen Sie sichergestellt haben, dass Sie unter Stammdaten --> Länder die Niederlande aktiv gesetzt haben.

PayPal Checkout konfigurieren

Um die Konfiguration zu starten, wählen Sie PayPal --> Konfiguration.

Note

Um das Modul konfigurieren zu können, muss dieses zunächst aktiviert werden. Nach der Aktivierung erscheint links in der Navigation der neue Menüpunkt PayPal.

API-Anmeldeinformationen

Registrieren Sie einen Webhook, um Ihren eShop mit PayPal zu verbinden.

Der Webhook erlaubt es PayPal, Ihren OXID eShop zu kontaktieren und in Echtzeit Statusmeldungen beispielsweise über abgeschlossene Transaktionen zu liefern.

Hint

Wenn die Webhooks des Moduls geprüft werden müssen, dann bietet es sich an, den Parameter $this->sLogLevel in der Datei config.inc.php auf den Wert debug zu setzen.

Auf diese Weise werden die an den Shop gesendeten Webhook Calls von PayPal im Log oxideshop.log aufgezeichnet.

Im ersten Durchgang testen Sie die mit PayPal Checkout bereitgestellten Zahlungsarten mit Test-Zugangsdaten in einer Sandbox.

Hint

Was bringt mir das Testen in der Sandbox?

sandbox.paypal.com ist ein Spiegel-System. Alle Funktionen und die API sind identisch zu sandbox.paypal.com.

Das heißt: Jeden Fehler, den Sie hier erzeugen können, wird es auch im Live-System geben. Umgekehrt: Jeder nicht erzeugte Fehler tritt auch im Produktions-System nicht auf.

Testen Sie Ihre PayPal Checkout-Integration deshalb zuerst mit einem Sandbox-System.

Es kann nichts schiefgehen:

• Testzahlungen in der Sandbox kosten nichts.
• Sie vermeiden Rückbuchungen wie sie bei Testzahlungen mit dem Live-Konto nötig wären.

Erst wenn alles nach Ihren Vorstellungen funktioniert, nutzen Sie die Zugangsdaten für den Live-betrieb.

• Sie haben auf der Entwickler-Seite von PayPal ein Sandbox-Händlerkonto und ein Sandbox-Kundenkonto eingerichtet. Weitere Informationen finden Sie unter paypal-sandbox:PayPal-Sandbox-Accounts generieren.
• Ihre Testumgebung hat SSL. Wenn Sie PayPal Checkout in einer lokalen Entwicklungs-Umgebung testen, die nur über http:// erreichbar ist (also ohne SSL über https://), dann benutzen Sie beispielsweise NGROK, um Ihre Testumgebung mit temporärem SSL auszustatten. Weitere Informationen finden Sie unter paypal-sandbox:Temporäres SSL einrichten.

Wir beschreiben den Prozess am Beispiel eines Sandbox-Kontos. Der Live-Prozess ist analog.

Hint

Verfügbarkeit aller Zahlungsarten

Damit Ihnen alle PayPal-Zahlungsarten zur Verfügung stehen, generieren Sie den Webhook wie im Folgenden beschrieben mit der Schaltfläche Anmeldung Händler PayPal-Integration (Sandbox).

Hintergrund: Technisch ist es auch möglich, bereits existierende Anmeldeinformationen manuell einzugeben, statt sie neu zu generieren. Aber das würde zu Enischränkungen führen (siehe troubleshooting:"Kreditkarte" und "Rechnungskauf" nicht verfügbar).

1. Wählen Sie unter API-Anmeldeinformationen die Schaltfläche Anmeldung Händler PayPal-Integration (Sandbox).
2. Durchlaufen Sie den Registrierungs-Prozess mit der E-Mail-Adresse des Sandbox-Händlerkontos.

   1. Melden Sie sich an (oxdajr01), und bestätigen Sie die Abfragen.

      Abb.: Registrierung des Sandbox-Händler-Kontos starten

   2. Wählen Sie zum Abschluss Zurück zu John Doe`s Test Store (oxdajr03).

      Abb.: Registrierung des Händlerkontos abschließen

      Eine Meldung zeigt den Erfolg an (oxdajr04).

      Abb.: Meldung Onboarding erfolgreich

3. Wechseln Sie zurück in Ihren OXID eShop.

   Der Webhook ist erzeugt.

   Die Client-ID und die Webhook-ID werden angezeigt (oxdajr05, Pos. 1, 2).

   Abb.: Webhook erzeugt

4. Wenn Sie Ihren Kunden die Zahlungsmethoden Rechnungskauf oder Kreditkarte anbieten wollen, prüfen Sie unter Freischaltung für besondere Zahlarten erfolgt (oxdajr05, Pos. 3), ob die Freischaltung erfolgt ist.

   Hint

   Zahlungsmethode Fallback-Kreditkarte

   Wenn die Freischaltung nicht automatisch erfolgt ist (Kreditkarte: Nein), wenden Sie sich an Ihren Ansprechpartner bei PayPal.

   Ist die Freischaltung erfolgt, steht die Zahlungsart Kreditkarte im Checkout-Schritt Versand & Zahlungsart zur Verfügung (oxdajr02, Pos. 1).

   Wenn eine Freischaltung nicht möglich ist, steht alternativ eine Fallback-Lösung bereit (:ref:`oxdajr02, Pos. 2).

   Abb.: Kreditkarten-Optionen und SEPA Lastschrift

   Hint

   Zahlungsmethode Rechnungskauf

   Die Zahlungsmethode Rechnungskauf bietet PayPal nur Shop-Betreibern aus Deutschland an.

Sobald Sie PayPal die Genehmigung erteilt haben, Ihr Sandbox-Konto mit dem PayPal-Test Store zu verbinden, werden die API-Anmeldeinformationen angezeigt, und das Modul ist aktiv oxdajr05.

Unter Shopeinstellungen --> Zahlungsarten ist die Zahlungsart PayPal (technischer Name oscpaypal) aktiv (oxdajr07).

Abb.: Zahlungsart PayPal aktiv

Die Zahlungsarten "Kreditkarte" und "Rechnungskauf" stehen nicht zur Verfügung? Folgen Sie den Anweisungen unter troubleshooting:"Kreditkarte" und "Rechnungskauf" nicht verfügbar.

Hint

Neuen Webhook generieren

Manchmal kann es nötig sein, den bestehenden Webhook zu löschen und einen neuen zu generieren.

Um einen Webhook zu löschen, löschen Sie die Anmeldedaten und wählen Speichern.

Die Schaltfläche Anmeldung Händler PayPal-Integration erscheint, und Sie können den Webhook neu generieren.

Einstellungen für die Buttonplatzierung: Schnellkauf-Funktion

Entscheiden Sie, ob Sie die Schnellkauf-Funktion von PayPal Checkout anbieten wollen

Mit der Schnellkauf-Funktion überspringen Ihre Kunden die Anmeldung in Ihrem eShop.

• Ihre Kunden haben typischerweise nur einen einzigen Artikel im Warenkorb, wenn sie eine Bestellung aufgeben? In diesem Fall ist es sinnvoll, die Kunden so schnell und barrierefrei wie möglich zum Ziel zu führen und die Schnellkauf-Funktion zu aktivieren.
• Einen bedeutenden Teil von Umsatz oder Marge erwirtschaften Sie mit Zubehörartikeln? In diesem Fall kann es sinnvoll sein, das Bezahlen hinauszuzögern und die PayPal-Schaltflächen beispielsweise nur im Warenkorb und im Checkout anzubieten.

Sie legen also fest,

• ob die Kunden Ihren Checkout-Prozess durchlaufen und sich in Ihrem eShop registrieren müssen

  oder

• ob die Kunden ohne Registrierung mit ihrem PayPal-Konto die Bestellung direkt auslösen können (Schnellkauf).

Standardmäßig ist die Schnellkauf-Funktion aktiv, und die PayPal-Schaltfläche erscheint auf folgenden Seiten:

• auf der Produkt-Detailseite
• im Warenkorb
• im Mini-Warenkorb (oxdajr09, Pos. 1)
• auf der Checkout-Seite

Ihre Kunden können also jederzeit mit ihrem PayPal-Konto die Bestellung auslösen.

Wenn Sie wollen, dass Ihre Kunden sich in Ihrem eShop registrieren müssen, deaktivieren Sie die Schnellkauf-Funktion.

Abb.: Mini-Warenkorb und Später bezahlen

1. Um die Schnellkauf-Funktion von PayPal Checkout zu deaktivieren, deaktivieren Sie die Kontrollkästchen Produktdetailseite, Warenkorb und Mini-Warenkorb (oxdajr10, Pos. 1).
2. Speichern Sie Ihre Einstellungen.

Abb.: Anzeige der PayPal-Buttons steuern

Die PayPal-Schaltfläche erscheint nur auf der Checkout-Seite.

Einstellungen für die Buttonplatzierung: Später Bezahlen

Entscheiden Sie, ob Sie die Später Bezahlen-Funktion (oxdajr09, Pos. 2) anbieten wollen

Später Bezahlen bedeutet beispielsweise, dass PayPal Kunden in Deutschland die Option "Bezahlung nach 30 Tagen" oder PayPal-Ratenzahlung anbietet.

Weitere Informationen über Länder-Abdeckung und landesspezifische Funktionen der Später Bezahlen-Funktion finden Sie unter developer.paypal.com/docs/checkout/pay-later/de.

1. Um Ihren Kunden Später Bezahlen-Funktionen anzubieten, aktivieren Sie das Kontrollkästchen "Später Bezahlen"-Button anzeigen? (oxdajr10, Pos. 2).
2. Speichern Sie Ihre Einstellungen.

Login mit PayPal

Legen Sie fest, dass Kunden automatisch in Ihrem OXID eShop angemeldet sind,

• wenn die E-Mail-Adresse des PayPal-Kontos und des eShop-Kontos identisch sind

und

• sobald Ihr Kunde in seinem PayPal-Konto angemeldet ist

Vorteil: Sie gestalten den Anmeldeprozess für Ihre Kunden bequemer.

Ihre Kunden überspringen damit den Anmeldemechanismus. Ihre Kunden melden sich in Ihrem OXID eShop an, ohne ihr Passwort eingeben zu müssen.

Nachteile:

• Oft nutzen beispielsweise Ehepartner dasselbe PayPal-Konto. Einer der Partner könnte dadurch die Bestellhistorie oder andere Kundendaten des Partner im OXID eShop einsehen. Potenziell besteht also ein Datenschutz-Risiko.
• Müssen sich Ihre Kunden nicht in Ihrem eShop anmelden, gehen Ihnen Daten zur Bestellhistorie der Kunden verloren. Solche Daten könnten Sie andernfalls für statistische Auswertungen zur gezielten Ansprache Ihrer Kunden nutzen.

Wenn Sie Login mit PayPal nicht aktivieren, passiert Folgendes:

• Wenn die PayPal-E-Mail-Adresse des Kunden bekannt ist, wird der PayPal-Bezahlvorgang unterbrochen, und der Kunde muss sich in Ihrem eShop anmelden. Die PayPal-Session ist erstellt, und Ihr Kunde ist in Ihrem eShop angemeldet. Die Identität des Kunden steht eindeutig fest, und die aktuelle Bestellung wird zur Bestellhistorie des Kunden hinzugefügt.
• Wenn die PayPal-E-Mail-Adresse des Kunden nicht bekannt ist, führt Ihr Kunde die Bestellung mit einem Gast-Konto aus. Ihr Kunde landet mit den PayPal-Adressdaten auf der Checkout-Seite. Die Daten werden nur für die aktuelle Bestellung einmalig gespeichert, es wird kein Kundenkonto im eShop angelegt.

Attention

Die Funktion Login mit PayPal ist standardmäßig aktiviert.

1. Prüfen Sie, was im schlimmsten Fall schiefgehen kann, wenn mehrere Benutzer dasselbe PayPal-Konto nutzen und in Ihrem eShop die Daten der anderen Benutzer einsehen können.
2. Es besteht kein ernstes Risiko darin, wenn Ihre Kunden sich in Ihrem eShop bequem automatisch mit ihren PayPal-Konten anmelden? Dann lassen Sie das Kontrollkästchen Im Shop beim Kauf automatisch einloggen aktiviert. Andernfalls deaktivieren Sie das Kontrollkästchen.
3. Speichern Sie Ihre Einstellungen.

Geldeinzug festlegen

Legen Sie für die Zahlungsart PayPal fest, ob Zahlungen sofort oder verzögert eingezogen werden sollen.

Sie können den Geldeinzug für maximal 30 Tage aufschieben.

Typischerweise wird der Rechnungsbetrag sofort eingezogen.

In bestimmten Fällen ist es jedoch sinnvoll, dass die Zahlung erst verzögert durch die Auslieferung ausgelöst wird:

• Sie vertreiben bestimmte individualisierte Produkte, die Sie erst nach Eingang der Bestellung herstellen, in Auftrag geben oder bestellen.
• Sie haben einen eShop für Geschäftskunden. Hier sind die Liefermengen und Zahlungsbeträge größer als bei Privatkunden. Im Fall eines Fehlers wäre das Retourenmanagement entsprechend schwieriger. Deshalb wollen Sie sicherstellen, dass die Zahlung nur ausgelöst wird, wenn die Ware da oder auf dem Weg zum Versand ist.

1. Sie haben unter PayPal Standard - Geldeinzug (oxdajr12) folgende Möglichkeiten:

   • Damit Zahlungen immer direkt ausgelöst werden, wählen Sie Direkt.
   • Um die Zahlung nur zu reservieren und verzögert auszulösen, haben Sie folgende Möglichkeiten:
     • automatisch bei Lieferung: Die Zahlung wird ausgelöst, sobald Sie in Ihrem eShop den bestellten Artikel auf den Status Geliefert gesetzt haben.
     • manuell: Die Zahlung wird ausgelöst, wenn Sie unter Bestellungen verwalten --> Bestellungen die Bestellung wählen und auf der Registerkarte PayPal Checkout die Schaltfläche Einziehen wählen.

   Für die Schnellkauf-Funktion von PayPal Checkout (Zahlungsart PayPal Express) ist das Reservieren nicht möglich. Der Rechnungsbetrag wird bei der Zahlungsart PayPal Express immer sofort eingezogen.

   Abb.: Verzögerte Zahlung konfigurieren
2. Speichern Sie Ihre Einstellungen.

3. Ordnen Sie den individualisierten Produkten in Ihrem eShop die Zahlungsart PayPal zu.

   Es ist technisch nicht möglich, bestimmten Artikeln bestimmte Zahlungsarten ausschließlich zuzuweisen. Wir schlagen folgenden Workaround vor:

   1. Legen Sie eine dedizierte Versandkostenregel an und ordnen Sie ihr die betreffenden Artikel zu. Achten Sie darauf, dass die Bedingung Menge richtig spezifiziert ist.
   2. Legen Sie eine dedizierte Versandart an und ordnen Sie ihr die Zahlungsart PayPal sowie die Versandkostenregel für individualisierten Produkte zu.

   3. Weisen Sie Ihre Kunden im Beschreibungstext des Artikels an, zum Bezahlen ausschließlich die dedizierte Versandart zu wählen (oxdajr06, Pos. 1).

      Abb.: Dedizierte Versandart im Checkout wählen

Bei verzögertem Geldeinzug ziehen Sie die Rechnungsbeträge unter Bestellungen verwalten --> Bestellungen wie folgt ein (siehe betrieb:Reservierte Zahlung manuell auslösen):

• Wenn Sie automatisch bei Lieferung gwählt haben: Sie lösen die Zahlung aus, sobald Sie die Schaltfläche Jetzt versenden wählen und damit den bestellten Artikel auf den Status Geliefert gesetzt haben.
• Wenn Sie manuell gewählt haben: Sie lösen die Zahlung aus, indem Sie unter Bestellungen verwalten --> Bestellungen die Bestellung wählen und auf der Registerkarte PayPal Checkout die Schaltfläche Einziehen wählen.

3D Secure für Debit- und Kreditkarten konfigurieren

Um die gesetzlichen Anforderungen an Online-Zahlungen mit Kreditkarte zu erfüllen, nutzen Sie die 3D Secure-Authentifizierung.

Dabei wird der Kunde während der Transaktion von der ausstellenden Bank aufgefordert, sich durch Eingabe eines Passworts als rechtmäßiger Karteninhaber zu identifizieren.

Diese Authentifizierung durch die ausstellende Bank ist in bestimmten Situationen europaweit vorgeschrieben – etwa beim Hinterlegen einer Kreditkarte in ein E-Wallet (z.B. PayPal) oder bei riskanten Transaktionen.

Weitere Informationen über die die 3D Secure-Authentifizierung finden Sie unter paypal.com/de/webapps/mpp/3dsecure-faqs.

Sie haben folgende Möglichkeiten:

• Um die höchstmögliche Sicherheit zu erreichen, erzwingen Sie eine 3D Secure-Abfrage für jede Kreditkartentransaktion.
• Lassen Sie PayPal sicherstellen, dass 3D Secure nur im Bedarfsfall eingesetzt wird. PayPal sorgt dafür, dass der Großteil Ihrer Kunden ungestört einkaufen kann.
• 3D Secure-Ergebnis ignorieren: Um zu erfahren, in welchen Fällen diese Einstellung für Sie sinnvoll sein kann, wenden Sie sich an den PayPal-Kundenservice unter paypal.com/de/webapps/helpcenter/helphub/home/.

1. Bei Bedarf: Um die für Ihre Zwecke optimale Einstellung zu bestimmen, kontaktieren Sie den PayPal-Kundenservice unter paypal.com/de/webapps/helpcenter/helphub/home/.
2. Wählen Sie die gewünschte Einstellung (oxdajr11).
3. Speichern Sie Ihre Einstellungen.

Abb.: 3D Secure-Authentifizierung konfigurieren

Behandlung nicht beendeter Bestellungen festlegen

Legen Sie fest, ob Sie unvollständige Bestellungen automatisch oder manuell löschen wollen.

---

Aus technischen Gründen erzeugt PayPal Bestellungen, auch wenn die Bestellungen am Ende nicht abgeschlossen werden.

Das ist der Fall, wenn der Kunde im Checkout die Schaltfläche Zahlungspflichtig bestellen wählt, sich dann aber nicht bei PayPal anmeldet und den Bezahlvorgang abschließt.

Weitere Informationen finden Sie unter betrieb:Unvollständige Bestellungen manuell löschen.

---

• Das automatische Löschen ist beispielsweise empfohlen, wenn Sie beispielsweise niedrigpreisige Massenartikel vertreiben. Es wäre unbequem für Sie, zahlreiche unabgeschlossene Bestellungen einzeln manuell zu löschen.

• Das manuelle Löschen kann beispielsweise sinnvoll sein, wenn Sie hochpreisige Waren mit kleinen Absatzzahlen vertreiben.

  Springen Kunden während des Bestellprozesses ab, können Sie durch das manuelle Löschen feststellen, ob es eventuell Schwierigkeiten bei bestimmten PayPal-Zahlungsarten gibt.

1. Wenn das System unvollständige Bestellungen automatisch löschen soll, markieren Sie das Kontrollkästchen Nicht beendete Bestellungen automatisch löschen? (oxdajr13, Pos. 1).

   Passen Sie bei Bedarf die standardmäßige Rückhaltezeit von 60 Minuten an oxdajr13, Pos. 2).

2. Speichern Sie Ihre Einstellungen.

Wenn Sie das automatische Löschen deaktiviert lassen, müssen Sie unvollständige Bestellungen regelmäßig manuell löschen.

Weitere Informationen finden Sie unter betrieb:Unvollständige Bestellungen manuell löschen.

Abb.: Automatisches Löschen unvollständiger Bestellungen konfigurieren

Banner-Einstellungen übernehmen

Optional: Wenn Sie bereits das Modul PayPal nutzen, übernehmen Sie bequem die Bannereinstellungen für PayPal Checkout.

Alternativ: Legen Sie die Bannereinstellungen manuell fest wie beschrieben unter konfiguration:Banner-Einstellungen.

PayPal ist aktiviert.

1. Um die bestehende Einstellungen für die PayPal-Bannerwerbung zu übernehmen, wählen Sie die Schaltfläche Einstellungen aus dem klassischen PayPal-Modul übernehmen`. Die Schaltfläche erscheint nur, wenn das Modul PayPal installiert ist.
2. Speichern Sie Ihre Einstellungen.

Banner-Einstellungen

Legen Sie fest, ob Sie mit Bannern für die PayPal-Ratenzahlung (oxdajr08) werben wollen.

Wenn Sie die Vorteile des Werbens für die PayPal-Ratenzahlung nutzen wollen, legen Sie fest, wo die Banner erscheinen sollen, beispielsweise auf der Startseite, auf der Detailseite von Artikeln, auf den Kategorieseiten, in den Suchergebnissen und/oder im Bestellprozess.

Abb.: Beispiel: Ratenzahlungs-Banner auf einer Kategorieseite

Attention

Datenschutz

Um die Banner erscheinen zu lassen, ist eine permanente Kommunikation mit den Servern von PayPal nötig.

Dazu werden bei jedem Seitenaufruf Skripte gestartet, die das Nutzerverhalten beobachten und die die für den PayPal-Bezahlprozess nötigen Informationen sammeln und an PayPal übermitteln.

Diese Kommunikation kann unerwünscht sein, beispielsweise aus Gründen

• des Datenschutzes
• der Performance

Stellen Sie in diesem Fall sicher, dass die Funktion deaktiviert ist.

Standardmäßig ist die Funktion eingeschaltet.

1. Um das Ausführen von Skripten für die PayPal-Bannerwerbung auszuschalten, deaktivieren Sie das Kontrollkästchen Ratenzahlung-Banner aktivieren. Wenn Sie das Kontrollkästchen nicht markieren, dann werden die Skripte nicht ausgeführt.
2. Wenn Sie das Ausführen von Skripten für die PayPal-Bannerwerbung zulassen, legen Sie fest, auf welchen Seiten das Banner erscheinen soll. Markieren Sie dazu das entsprechende Kontrollkästchen.
3. Wenn Sie ein individuelles Theme oder ein angepasstes OXID-Theme verwenden, tun Sie Folgendes:
   1. Identifizieren Sie den CSS-Selektor der Seite, hinter dem Sie den Banner platzieren wollen.
   2. Geben Sie den CSS-Selektor in entsprechende Eingabefeld ein.
4. Legen Sie unter Farbe des Ratenzahlung-Banners auswählen die gewünschte Farbe des Banners fest.
5. Speichern Sie Ihre Einstellungen.

Optional: Länderzuordnung von PayPal Checkout-Zahlungsmethoden konfigurieren

Stellen Sie sicher, dass bestimmte PayPal Checkout-Zahlungsmethoden ausschließlich in den von Ihnen gewünschten Ländern zur Verfügung stehen.

Bei der Erstinstallation sind den PayPal Checkout-Zahlungsmethoden automatisch die entsprechenden Länder zugeordnet.

Die meisten PayPal Checkout-Zahlungsmethoden decken mehrere Länder ab. Die Zahlungsmethode Kreditkarte beispielsweise ist Kunden weltweit zugänglich, die Zahlungsmethode Pay Later steht Ihren Kunden beispielsweise in Ländern in Europa, den USA und Australien zur Verfügung.

Weitere Informationen über die Länderabdeckung der einzelnen PayPal Checkout-Zahlungsmethoden finden Sie unter einfuehrung:Marktabdeckung nach Zahlungsmethoden.

Grundsätzlich gilt dabei: Die Rechnungsadresse und nicht die Lieferadresse eines Kunden bestimmt, ob eine PayPal Checkout-Zahlungsmethode dem Kunden zur Auswahl steht. Beispiel: Nur Kunden mit einer Rechnungsadresse in Polen erhalten die Zahlungsmethode Przelewy24 angeboten.

Um bei Bedarf die Zugänglichkeit einer PayPal Checkout-Zahlungsmethode auf bestimmte Länder einzuschränken, wählen Sie Shopeinstellungen --> Zahlungsarten --> <Zahlungsart> --> Länder --> Länder zuordnen.

PayPal Checkout testen

Konfigurieren Sie PayPal Checkout nach Ihren Wünschen und testen Sie das Ergebnis.

1. Stellen Sie sicher, dass unter Stammdaten --> Länder die Märkte aktiv sind, die Sie abdecken wollen.
2. Tun Sie unter Shopeinstellungen --> Zahlungsarten Folgendes:
   1. Ordnen Sie den gewünschten PayPal Checkout-Zahlungsarten (beispielsweise iDEAL (über PayPal) jeweils mindestens eine Benutzergruppen zu.
   2. Stellen Sie sicher, dass Sie für die PayPal Checkout-Zahlungsarten auf der Registerkarte Stamm den jeweils gewünschten minimalen und maximalen Einkaufswert festgelegt haben. Beispiel: Der maximale Einkaufswert für die Zahlungsart PayPal ist standardmäßig auf 10.000 € begrenzt. Der Mindest-Einkaufswert ist 10 €.

3. Tun Sie unter Shopeinstellungen --> Versandarten Folgendes:

   1. Weisen Sie die gewünschten PayPal Checkout-Zahlungsarten den jeweiligen Versandarten zu.
   2. Stellen Sie sicher, dass mindestens eine Versandart für die Bezahlung mit der Zahlungsart PayPal angelegt ist. Typischerweise ist das die Standard-Zahlungsart.

   Weitere Informationen finden Sie unter Zahlungsarten der Anwenderdokumentation des OXID eShop. Ändern Sie ggf. den Einkaufswert (€) in 0 bis 99999.

PayPal Checkout freischalten

Schalten Sie PayPal Checkout nach dem Testen frei.

Attention

Keine PayPal Plus-Zugangsdaten verwenden

Sie haben bereits PayPal Plus? Verwenden Sie in diesem Fall nicht die Zugangsdaten für PayPal Checkout.

Generieren Sie die Zugangsdaten für PayPal Checkout wie im Folgenden beschrieben mit Ihrem PayPal-Händlerkonto neu.

• Sie haben die gewünschten Zahlungsarten konfiguriert und mit Testzahlungen in der PayPal-Sandbox erfolgreich getestet (siehe konfiguration:PayPal Checkout testen).

1. Wählen Sie unter API-Anmeldeinformationen den Betriebsmodus Live.
2. Wählen Sie die Schaltfläche Anmeldung Händler PayPal-Integration (Live). Sie gelangen in ein Dialogfenster zum Anmelden bei PayPal.
3. Melden Sie sich mit Ihrem bestehenden PayPal-Händlerkonto an. Wenn Sie noch keine Zugangsdaten für den Live-Betrieb haben, legen Sie ein PayPal-Händlerkonto neu an.
4. Speichern Sie Ihre Einstellungen.
5. Wenn Sie PayPal oder PayPal Plus nutzen, folgen Sie den Empfehlungen unter konfiguration:Existierende PayPal- oder PayPal Plus-Bestellungen verwalten.

Die PayPal API-Anmeldeinformationen werden eingefügt.

Das Modul PayPal Checkout ist aktiv und steht für Bestellungen Ihrer Kunden bereit.