> For the complete documentation index, see [llms.txt](https://helpcenter.etron.info/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.etron.info/verwaltungsoberflache/konfiguration/e-commerce/zahlung/zahlungsanbieter/paypal.md).

# PayPal

Zahlungsanbieter PayPal

{% hint style="success" %}
M*odul: ETRON onRetail v2 PayPal*
{% endhint %}

> *Konfiguration -> E-Commerce -> Zahlungsanbieter -> PayPal*

<div data-with-frame="true"><figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2Fb10hICk729UcNIT9Z7ya%2Fimage.png?alt=media&amp;token=6be4db5b-a349-4447-be74-1a339ec13be7" alt="Konfiguration -> E-Commerce -> Zahlungsanbieter -> PayPal"><figcaption><p>Konfiguration -> E-Commerce -> Zahlungsanbieter -> PayPal</p></figcaption></figure></div>

Mit dem Zahlungsanbieter PayPal können Zahlungen via PayPal, eps Sofortüberweisung und Debit-/Kreditkarte durchgeführt werden.

{% hint style="info" %}
*Für die Zahlung via eps Sofortüberweisung und Debit-/Kreditkarte benötigt der Kunde kein PayPal-Konto.*
{% endhint %}

<div data-with-frame="true"><figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FmjaTOHbDvor59yN6Ctfm%2Fimage.png?alt=media&amp;token=9df45693-923d-4bb8-b288-a3892c5826c3" alt="" width="547"><figcaption><p>Zahlungsanbieter PayPal im Checkout des Onlineshops:<br>unterstützt die Zahlung über PayPal, eps uind Debit-/Kreditkarte</p></figcaption></figure></div>

{% hint style="info" %}
*Die über einen Zahlungsanbieter durchgeführten Zahlungen sind unter*[ *E-Commerce -> Onlineshop - Zahlungstransaktionen*](/verwaltungsoberflache/e-commerce/onlineshop/zahlungstransaktionen.md) *protokolliert.*
{% endhint %}

## Konfiguration des Zahlungsanbieters PayPal

### Zahlungsanbieter Paypal, Reiter: Anmeldedaten

<div data-with-frame="true"><figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FUIbdhZIiV3dBzP2FTV81%2Fimage.png?alt=media&amp;token=996a7752-5247-4ec6-983f-c483a68aa878" alt="Zahlungsanbieter Paypal, Reiter: Anmeldedaten"><figcaption></figcaption></figure></div>

​Um die Zahlungsmethode PayPal einzurichten, müssen im Reiter **Anmeldedaten** folgende Felder ausgefüllt werden:

{% hint style="info" %}
*Die PayPal Client ID und das PayPal Client Secret können im PayPal-Geschäftskonto im PayPal Developer Dashboard eingesehen werden:*\
*Den Bereich „Apps & Credentials“ öffnen, App auswählen oder neue App erstellen. In der App werden Client ID und Client Secret angezeigt.*
{% endhint %}

### **Paypal E-Mail**

Die E-Mail-Adresse des PayPal-Kontos wird in diesem Feld eingegeben.

### **PayPal Client-ID**

Die PayPal Client-ID des PayPal-Kontos wird in diesem Feld eingegeben.

### PayPal Client-Secret

Das PayPal Client-Secret des PayPal-Kontos wird in diesem Feld eingegeben.

### PayPal Webhook ID / Webhook generieren

Eine eingehende Webhook-Nachricht wird nur akzeptiert, wenn eine **PayPal Webhook ID** hinterlegt ist. Ohne diese wird die Nachricht grundsätzlich verworfen, ohne die betroffene Transaktion zu ändern. Ist eine Webhook-ID vorhanden, wird die Nachricht zusätzlich direkt bei PayPal zur Bestätigung eingereicht (Signaturprüfung). Bestätigt PayPal die Echtheit nicht, wird die Nachricht ebenfalls verworfen.

<details>

<summary>Wofür wird beim Zahlungsanbieter PayPal ein Webhook benötigt?</summary>

Bei PayPal wird der Zahlungsvorgang bereits direkt im Checkout abgeschlossen: Sobald der Kunde die Zahlung im PayPal-Fenster bestätigt, ruft ETRON onRetail synchron die PayPal-API auf, um die Zahlung einzuziehen, und aktualisiert die Transaktion sofort. Für den normalen Kaufvorgang ist der Webhook daher **nicht** erforderlich.

Der Webhook dient ausschließlich als Absicherung für den Fall, dass diese synchrone Bestätigung PayPal-seitig verzögert oder nachträglich anders ausfällt – etwa wenn eine Bestellung bei PayPal als abgeschlossen (`COMPLETED`) oder genehmigt (`APPROVED`) markiert wird, ohne dass ETRON onRetail dies über den regulären Weg mitbekommen hat. Ohne eingerichteten Webhook fehlt diese zusätzliche Absicherung.

**Welche Ereignisse verarbeitet werden**

Von den vielen Ereignistypen, die PayPal grundsätzlich versendet, verarbeitet diese Instanz gezielt nur zwei Ereignisse, die sich auf eine Bestellung beziehen:

* Bestellung abgeschlossen.
* Bestellung genehmigt.

Alle anderen Ereignistypen, die PayPal an den Webhook sendet, werden ignoriert.

</details>

#### Einrichtung des PayPal Webhooks

Der PayPal Webhook kann über den Button ![Webhook generieren](https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FqMmYKZF73URScql8KXXv%2Fimage.png?alt=media\&token=753f03ae-dca4-4dfb-9661-821102e2a2ed) erstellt werden. Der Button wird nur angezeigt, wenn **PayPal Client ID** und **PayPal Client Secret** bereits hinterlegt sind.

Bei Auswahl des Buttons wird bei PayPal ein Webhook registriert, der auf die Adresse der ETRON onRetail-Instanz zeigt. Die von PayPal vergebene Webhook-ID wird automatisch in das Feld **PayPal Webhook ID** eingetragen. Ist bereits eine Webhook-ID hinterlegt, wird angezeigt, dass der Webhook bereits eingerichtet ist. Ein zweiter Webhook wird nicht angelegt.

### Status

Legt den Status der Zahlungsmethode fest:

* **Deaktiviert**

Der Zahlungsanbieter ist nicht für die Zahlung verfügbar.

* **Aktiviert**

Der Zahlungsanbieter ist für die Zahlung verfügbar.

{% hint style="info" %}
*Die Zahlungsmethode muss zusätzlich veröffentlicht werden, damit sie im Onlineshop sichtbar ist.*
{% endhint %}

* **Testmodus**

Der Zahlungsanbieter ist im Testmodus verfügbar.\
Wenn die PayPal-Integration mit einem[ PayPal-Sandbox-Account](https://developer.paypal.com/tools/sandbox/) getestet werden soll, sollte der Status der Bezahlmethode auf Testmodus gestellt werden.

### Veröffentlichen

Der Zahlungsanbieter kann durch Auswahl des Buttons ![Unveröffentlicht](https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2F9BBLNWrOYuJqMJXAkpXl%2Fimage.png?alt=media\&token=ed578cb1-4da8-4671-b61c-e0769f2f6a39) auf die Sichtbarkeit ![Veröffentlicht](https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2F4O40iiO69Mz4bihIg1Fr%2Fimage.png?alt=media\&token=c0f3b18d-41f8-4d25-9fc2-f5b49ae63b38) umgeschalten werden und umgekehrt.

Nur veröffentlichte Zahlungsmethoden werden im Onlineshop angezeigt.

### Zahlungsanbieter Paypal, Reiter: Konfiguration

<div data-with-frame="true"><figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FIkXFJjxAbhuPwsLvEZ1T%2Fimage.png?alt=media&amp;token=2af2f245-c933-473d-8392-063fbd4a9eb4" alt="Zahlungsanbieter Paypal, Reiter: Konfiguration"><figcaption></figcaption></figure></div>

### Angezeigt als

Ein frei wählbarer Text, der dem Kunden im Checkout anstelle des Anbieternamens „PayPal" angezeigt wird. Bleibt das Feld leer, erscheint der Anbietername selbst.

### Unterstützte Zahlungssymbole

<div align="left" data-with-frame="true"><figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FUmvukoAnFDdbnAQwnlSz%2Fimage.png?alt=media&amp;token=9d53c323-2354-4c4a-b935-b804d5dba8cd" alt="Unterstützte Zahlungssymbole"><figcaption></figcaption></figure></div>

Es können diverse Symbole hinterlegt werden, die im Checkout unter der PayPal-Option angezeigt werden, um dem Kunden zu zeigen, welche Karten/Zahlungsarten darüber akzeptiert werden.

<div align="left" data-with-frame="true"><figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2F6i5iXsl9zxqBUuv4KxNU%2Fimage.png?alt=media&amp;token=436fdc9d-edfd-4f05-902d-0b895a440608" alt=""><figcaption><p>Zahlungsmethode mit Anzeige der Zahlungsymbole im Checkout des Onlineshops</p></figcaption></figure></div>

Beim Zahlungsanbieter PayPal ist dieses Feld **rein informativ für die Anzeige**: es wird nicht automatisch mit dem tatsächlichen Funktionsumfang des PayPal-Kontos abgeglichen. Die Liste ist manuell an das zu pflegen, was das Konto wirklich akzeptiert. Ein Symbol zu entfernen oder hinzuzufügen ändert nichts daran, welche Karten das hinterlegte PayPal-Konto tatsächlich abwickelt, sondern nur, was im Checkout angezeigt wird.

### Höchstbetrag

Der maximale Zahlungsbetrag, für den PayPal im Checkout als Option angeboten wird. Bleibt das Feld leer, gilt keine Obergrenze.

### Länder

Die Länder, in denen PayPal als Zahlungsoption zur Verfügung steht. Bleibt das Feld leer, ist PayPal in allen Ländern verfügbar.

## Wichtige PayPal Einstellungen

Im PayPal-Konto müssen unter **Menü -> Kontoeinstellungen -> Produkte und Dienstleistungen/Website-Zahlungslösungen -> Website-Einstellungen -> Aktualisieren** die folgenden Einstellungen vorgenommen werden:

* **Automatische Rückleitung für Websitezahlungen**: **Ein**\
  Die **Rückleitungs-URL** muss auf *https\://\<Shop-Domain>/shop/confirmation* gesetzt werden.
* Übertragung der Zahlungsdaten: **Ein**

### Verschlüsselte Websitezahlungen

> *PayPal -> Kontoeinstellungen -> Website-Zahlungslösungen -> Website-Einstellungen*

Die Funktion "Verschlüsselte Websitezahlungen" muss deaktiviert werden.

<div data-with-frame="true"><figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FPkB01KA5RdOmOgOApa0R%2Fimage.png?alt=media&amp;token=a04716fc-1480-4f71-9af2-c431456edd53" alt="Verschlüsselte Websitezahlungen in PayPal deaktivieren"><figcaption></figcaption></figure></div>

### Zeichencodierung für die Website einstellen

Damit die Kommunikation zwischen PayPal und onRetail reibungslos funktioniert, muss im PayPal-Business-Konto das Encoding von „Windows-1252” auf „UTF-8” geändert werden!

#### Schritte im PayPal-Business-Konto

1. Anmeldung im **PayPal-Business-Konto** unter [paypal.com](https://www.paypal.com/).
2. Den **Profilnamen oben rechts** und anschließend **Kontoeinstellungen** auswählen.
3. Öffnen des Bereichs **Verkaufstools** (je nach Ansicht auch **Tools für den Verkauf** genannt).
4. Zu **Weitere Verkaufstools** scrollen und\
   **PayPal-Schaltflächen – Sprach- und Zeichencodierung** auswählen.\
   Die Seite **Sprache und Zeichencodierung** wird geöffnet.
5. Überprüfung, ob die Einstellung **Sprache der Website** korrekt gesetzt ist.
6. **Weitere Optionen** auswählen.
7. Im Dropdown "UTF-8" für die Daten auswählen, die von der Website an PayPal gesendet werden.
8. Festlegung der Zeichencodierung auf "Ja" für Daten,\
   die von PayPal an die Website zurückgesendet werden.
9. **Speichern** auswählen, um die Einstellungen zu übernehmen.

{% hint style="info" %}
*Die Auswahl von **Abbrechen** führt zurück zur vorherigen Seite.*\
*Änderungen an den Zeichencodierungsoptionen werden dabei nicht gespeichert.*
{% endhint %}

> *Quelle:* [*https://developer.paypal.com/*](https://developer.paypal.com/api/nvp-soap/paypal-payments-standard/admin/checkout-settings/#change-the-encoding-used-by-your-website)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://helpcenter.etron.info/verwaltungsoberflache/konfiguration/e-commerce/zahlung/zahlungsanbieter/paypal.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.