> 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/stripe.md).

# Stripe

Online-Zahlungsanbieter, E-Commerce Zahlungsanbieter

{% hint style="success" %}
*Modul: Payment Stripe*
{% endhint %}

> *Konfiguration -> E-Commerce -> Zahlungsanbieter -> Stripe*

{% hint style="warning" %}
*Für das Verwenden dieser Zahlungsmethode muss eine Aufschaltung beim Vertrieb angefragt werden.*
{% 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%2FoY3xUQaP3Sj3MeTZpXPC%2Fimage.png?alt=media&amp;token=65c03b5a-b407-483b-9edb-1c7435aab35b" alt="Konfiguration -> E-Commerce -> Zahlungsanbieter -> Stripe"><figcaption><p><em>Konfiguration -> E-Commerce -> Zahlungsanbieter -> Stripe</em></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 Stripe

### Zahlungsanbieter Stripe, 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%2FBxV404PGgzar00wBpC6L%2Fimage.png?alt=media&amp;token=013eed5a-610e-463c-8b47-77a3779d22b9" alt="Zahlungsanbieter Stripe, Reiter: Anmeldedaten"><figcaption></figcaption></figure></div>

### 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.

### 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öffentlichbarer Schlüssel

Der Veröffentlichbare Schlüssel (Publishable Key) aus dem Stripe-Account wird hier eingetragen.

### Geheimer Schlüssel

Der Geheime Schlüssel (Secret Key) aus dem Stripe-Account wird hier eingetragen.

{% hint style="info" %}
*Der **Secret** und **Publishable Key** sind* [*hier*](https://dashboard.stripe.com/account/apikeys) *zu finden. Angezeigt werden sie nur, wenn der Entwicklermodus eingeschalten wird.*

<img src="https://4122668342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs4jXYu4QaEYCte4gphc6%2Fuploads%2FhadgiPXYrPu5265N6W8K%2Fimage.png?alt=media&#x26;token=034df9cf-8bf8-4a04-a0fc-40bc48024d48" alt="" data-size="original">

*Der Button ist im* [*Stripe Dashboard*](https://dashboard.stripe.com/account/apikeys) *oben rechts zu finden.*
{% endhint %}

### Webhook Signing Secret

Jede eingehende Webhook-Nachricht wird anhand des **Webhook Signing Secret** auf ihre Signatur geprüft. Nachrichten mit falscher oder fehlender Signatur sowie Nachrichten mit einem zu alten Zeitstempel (älter als 10 Minuten) werden zurückgewiesen. Ohne ein hinterlegtes Webhook Signing Secret wird jede eingehende Nachricht abgelehnt, der Webhook ist dann faktisch wirkungslos.

<details>

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

Nach einer Zahlung wird zwar durch Stripe auf eine Rückkehr-URL umgeleitet. Über diese URL wird der Zahlungsstatus abgefragt. Nicht alle Fälle einer nachträglichen Statusänderung werden dadurch abgedeckt. Dies betrifft insbesondere folgende Fälle:

* Eine Zahlungsmethode wird **asynchron** bestätigt. Dies betrifft beispielsweise Bank-Lastschriften oder Überweisungsverfahren. Die Seite wurde bereits verlassen, bevor die endgültige Bestätigung eingetroffen ist.
* Eine **Rückerstattung direkt im Stripe-Dashboard** wird ausgelöst. Die Auslösung erfolgt nicht in onRetail.
* Der Status einer bereits ausgelösten Rückerstattung ändert sich nachträglich. Dies kann beispielsweise eintreten, wenn die ursprüngliche Zahlungsmethode nicht mehr gültig ist.

Für diese Fälle wird durch Stripe eine Benachrichtigung an eine feste, öffentlich erreichbare Adresse in onRetail (`/payment/stripe/webhook`) gesendet. Diese Adresse wird als Webhook bezeichnet. Ohne eingerichteten Webhook bleiben Transaktionen, deren Status sich ausschließlich über diesen Weg ändert, in onRetail auf dem letzten bekannten Stand.

**Welche Ereignisse verarbeitet werden** Stripe schickt grundsätzlich viele Arten von Ereignissen; onRetail verarbeitet davon gezielt nur:

* Zahlungsvorgänge (`payment_intent.*`): reservierbarer Betrag verfügbar, Zahlung erfolgreich, Zahlung fehlgeschlagen, Zahlung storniert.
* Validierungsvorgänge (`setup_intent.succeeded`): erfolgreiche Hinterlegung einer Zahlungsmethode ohne sofortige Abbuchung, z. B. beim Speichern einer Karte.
* Rückerstattungen (`charge.refunded`, `charge.refund.updated`): eine Rückerstattung wurde erstellt bzw. ihr Status hat sich geändert.

Alle anderen Ereignistypen, die Stripe an den Webhook sendet, werden von ETRON onRetail ignoriert.

</details>

#### Einrichtung des Stripe Webhooks

<details>

<summary>Automatisch über die Schaltfläche in ETRON onRetail</summary>

Der Button ![Generieren Sie Ihren Webhook](https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2F0XGphmW7L7mUYWwEyJ0K%2Fimage.png?alt=media\&token=5beb672e-a47b-48cc-b5b8-b2fff08d0e3c) wird nur angezeigt, wenn der **Geheime Schlüssel (Secret Key)** bereits hinterlegt ist. Der Button wird ausgeblendet, sobald ein **Webhook Signing Secret** gesetzt ist.

Bei Auswahl des Buttons wird bei Stripe automatisch ein Webhook-Endpunkt angelegt. Dieser verweist auf die Adresse der jeweiligen ETRON onRetail-Instanz. Der Endpunkt wird direkt mit der vollständigen, für ETRON onRetail relevanten Ereignisliste verknüpft. Das erzeugte Signaturgeheimnis wird automatisch im Feld **Webhook Signing Secret** eingetragen.

Ist bereits ein Signaturgeheimnis hinterlegt, wird angezeigt, dass der Webhook bereits eingerichtet ist. Ein zweiter Webhook wird nicht angelegt.

Im Unterschied zur manuellen Einrichtung kann keine Beschreibung hinterlegt werden. Die Ereignisauswahl kann nicht vorab eingesehen werden.

</details>

<details>

<summary>Manuell im Stripe-Dashboard</summary>

Dieser Weg wird verwendet, wenn genau festgelegt werden soll, welche Ereignisse überwacht werden, oder wenn zusätzlich eine Beschreibung zum Endpunkt hinterlegt werden soll.

Wird der Webhook manuell auf dem Stripe Account eingerichtet, wird dabei das Webhook Signing Secret geriert, dass dann in onRetail eingetragen werden muss, um die von Stripe an ETRON onRetail gesendeten Nachrichten zu authentifizieren.

\
Einrichtung des [Webhook ](https://dashboard.stripe.com/test/webhooks)auf Stripe:\
In Stripe in der Ansicht "Wehooks"den Button **Endpoint hinzufügen** auswählen:

<div data-with-frame="true"><figure><img src="https://4122668342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs4jXYu4QaEYCte4gphc6%2Fuploads%2F5cBe1EfMjQTMOvbc43Wf%2Fimage.png?alt=media&#x26;token=43970e20-98a8-4d64-bf0a-8f9eb1a12e52" alt="Webhook-Endpunkt in Stripe hinzufügen"><figcaption></figcaption></figure></div>

Nach der Auswahl erscheint die Ansicht **Stripe-Ereignisse überwachen.** Hier wird der Webhook konfiguriert.

<div data-with-frame="true"><figure><img src="https://4122668342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs4jXYu4QaEYCte4gphc6%2Fuploads%2FdSs4qrdt3XoIRu27Skwh%2Fimage.png?alt=media&#x26;token=2fc8182d-ac34-415c-a476-27291008ba6b" alt="Stripe-Ereignisse für einen Webhook überwachen"><figcaption></figcaption></figure></div>

Den Link der Webseite, mit der Stripe verbunden werden soll, kopieren und unter **Endpoint-URL** einfügen.

Stripe hat die Funktion viele Informationen zu überwachen und Ereignisse als Logeinträge abzuspeichern. Die gewünschten Daten auswählen, die bei Auswahl des Produktes bis hin zum Bezahlen überwacht werden sollen. Anschließend **Endpoint hinzufügen** auswählen, um den Webhook Secret zu generieren. Der Webhook kann jederzeit bearbeitet werden.

<div data-with-frame="true"><figure><img src="https://4122668342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs4jXYu4QaEYCte4gphc6%2Fuploads%2FE9ozrx0Njaaw9p8dYVZF%2Fimage.png?alt=media&#x26;token=8713cb42-8766-46ce-8d6a-f42e95009325" alt="Ereignisse für den Stripe-Webhook auswählen"><figcaption></figcaption></figure></div>

Durch Auswahl von **Einblenden** wird der Geheimschlüssel eingeblendet. Dieser wird kopiert und im Feld **Stripe Webhook Secret** eingegeben. Damit wird die Konfiguration für Stripe im Webshop abgeschlossen.

</details>

### Zahlungsanbieter Stripe, 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%2FrMYa9ZwQ2AEqgkZCQWWH%2Fimage.png?alt=media&amp;token=a5728755-3b54-4b22-b5fe-cc340e7c5e94" alt="Zahlungsanbieter Stripe, Reiter: Konfiguration"><figcaption></figcaption></figure></div>

{% hint style="info" %}
*Im Reiter **Konfiguration** wird festgelegt, wie Stripe im Checkout angezeigt wird. Außerdem werden verfügbare Zahlungsfunktionen eingeschränkt oder aktiviert.*
{% endhint %}

### Angezeigt als

Ein frei wählbarer Text wird im Checkout anstelle von „Stripe“ angezeigt. Beispielsweise kann „Kreditkarte“ eingetragen werden. Bleibt das Feld leer, wird „Stripe“ angezeigt.

### Unterstützte Zahlungssymbole

Es können Zahlungssymbole wie Visa, Mastercard, Amex usw. hinzugefügt werden. Dadurch wird beim Zahlunganbieter Stripe festgelegt, welche Zahlungsmethoden beim Checkout über diesen Zahlungsanbieter angeboten werden.

Ist ein Symbol nicht verknüpft, wird diese Zahlungsmethode nicht angeboten. Dies gilt auch, wenn die Zahlungsmethode im Stripe-Konto aktiviert ist.

### Speicherung der Zahlungsmethoden zulassen

Es wird festgelegt, ob Zahlungsmethoden als Zahlungstoken gespeichert werden können. Das Token verweist anonym auf die bei Stripe hinterlegten Zahlungsdaten. Kartendaten verbleiben bei Stripe.

### Betrag manuell erfassen

Bei aktivierter Option wird der Betrag zunächst bei Stripe reserviert. Die Abbuchung wird erst nach Abschluss der Lieferung manuell durchgeführt.

Dies kann verwendet werden, wenn die Warenverfügbarkeit bei der Bestellung nicht gesichert ist.

### Express-Kassiervorgang erlauben

Es wird festgelegt, ob die Express-Zahlungsmethode Apple Pay verfügbar ist. Adressdaten werden dabei direkt aus der Zahlungsmethode übernommen.

Bei aktivierter Option wird zusätzlich **Apple Pay aktivieren** angezeigt. Darüber wird die Webdomain bei Stripe verifiziert. Die Verifizierung ist nur mit produktiven Zugangsdaten möglich. Mit Testzugangsdaten wird eine Fehlermeldung angezeigt.

### Höchstbetrag

Der maximale Zahlungsbetrag wird festgelegt, bis zu dem Stripe im Checkout angeboten wird. Bleibt das Feld leer, wird keine Obergrenze angewendet.

### Länder

Die Länder werden festgelegt, in denen Stripe als Zahlungsoption verfügbar ist. Bleibt das Feld leer, ist Stripe in allen Ländern verfügbar.

## Zahlungsanbieter Stripe testen

Um Stripe zu testen, kann ein Testeinkauf über den Onlineshop getätigt werden.

Dafür muss die Zahlungsmethode den Status "Testmodus" haben.

Als Zahlungsmethode wird im Checkout Stripe ausgewählt und Test-Zahlungsdaten verwendet, um einen Einkauf zu simulieren.

{% hint style="info" %}
*Test Kreditkarte:*

*Kartennummer:* [*4242 4242 4242 4242*](https://stripe.com/docs/testing?numbers-or-method-or-token=card-numbers#visa)*​*

*Ablaufdatum: 12/34*

*CVC: eine beliebige dreistellige Zahl (Für American Express vierstellig)*
{% endhint %}


---

# 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/stripe.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.