# Stripe

Mit dem Stripe-Plugin bezahlen Ihre Kunden per Kreditkarte, Apple Pay, Google Pay, SEPA-Lastschrift, Klarna und weiteren Zahlarten, die Stripe anbietet. Stripe ist ein Zahlungsanbieter unter mehreren – gleichberechtigt neben PayPal und Ihren manuellen Zahlarten. Das Plugin ist in jedem Shop vorinstalliert und kostenlos. Einen Überblick über alle Zahlarten gibt [Zahlungsarten](doc:zahlungsarten).

## Was das Plugin kann

- **Eine Zahlart im Checkout:** Kunden sehen „Kreditkarte, Apple Pay, Google Pay & weitere“. Das eingebettete Zahlungsformular von Stripe zeigt automatisch alle Zahlarten, die in Ihrem Stripe-Konto aktiviert sind. Welche das sind, legen Sie im Stripe-Dashboard fest.
- **Abonnements:** Produkte mit Abo laufen als Stripe-Abonnement; Verlängerungen und Kündigungen werden in den Shop übernommen.
- **Erstattungen:** Voll- und Teilerstattungen starten Sie direkt in der Bestellung. Erstattungen, die Sie im Stripe-Dashboard vornehmen, übernimmt der Shop automatisch.
- **Zahlungsanfechtungen:** Eröffnet ein Kunde eine Anfechtung (Dispute), erscheint ein Hinweis an der Bestellung – beantworten Sie sie im Stripe-Dashboard.
- **Details an der Bestellung:** Die Stripe-Zahlung (bzw. das Stripe-Abo) steht mit Link zum Stripe-Dashboard an der Bestellung.
- **Datenschutz:** Stripe wird automatisch als Zahlungsdienstleister in Ihrer Datenschutzerklärung genannt, sobald Sie Stripe anbieten (mit dem Plugin [Datenschutz (DSGVO)](doc:dsgvo)).

## Einrichtung

Sie richten Stripe unter **Einstellungen → Zahlungen → Stripe** ein. Was die Seite verlangt, hängt von Ihrer Edition ab.

### Plazello Cloud: Stripe Connect

Im gehosteten Plazello verbinden Sie Ihr Stripe-Konto über Stripe Connect – Schlüssel müssen Sie nicht eintragen.

1. Klicken Sie auf **Mit Stripe verbinden**. Sie werden zu Stripe weitergeleitet und hinterlegen dort Ihre Unternehmens- und Bankdaten. Stripe prüft Ihre Identität.
2. Danach kehren Sie automatisch zurück. Der Status zeigt den Stand: **Verifizierung ausstehend**, **Zahlungen aktiv, Auszahlungen ausstehend** oder **Aktiv – Zahlungen & Auszahlungen**.
3. Fehlen noch Angaben, setzen Sie mit **Onboarding fortsetzen / Daten aktualisieren** fort. **Status aktualisieren** liest den aktuellen Stand von Stripe; **Stripe-Dashboard** öffnet Ihr Konto bei Stripe.

Ihre Kunden bezahlen direkt an Ihr Stripe-Konto; Sie sind der Verkäufer und erscheinen auf dem Kontoauszug. Ihr Konto wird von Stripe verwaltet, Sie haben Zugriff auf das vollständige Stripe-Dashboard. Je nach Tarif behält die Plattform pro Bestellung eine Gebühr ein – den Satz sehen Sie auf der Einrichtungsseite unter **Wie funktioniert das?**.

### Selbst gehostet: eigene Schlüssel

In einer selbst gehosteten Installation verbinden Sie Ihr eigenes Stripe-Konto mit Ihren API-Schlüsseln. Zahlungen gehen direkt auf Ihr Stripe-Konto.

1. Öffnen Sie im Stripe-Dashboard **Entwickler → API-Schlüssel**.
2. Tragen Sie unter **Schlüssel (eigenes Stripe-Konto)** den **Publishable Key** (`pk_…`) und den **Secret Key** (`sk_…` oder eingeschränkter Schlüssel `rk_…`) ein.
3. Legen Sie im Stripe-Dashboard unter **Entwickler → Webhooks** einen Endpunkt mit der **Webhook-URL** an, die Ihnen die Seite im Abschnitt **Webhook** anzeigt (mit Kopier-Button). Wählen Sie die dort aufgeführten Ereignisse: `payment_intent.succeeded`, `payment_intent.processing`, `payment_intent.payment_failed`, `charge.refunded`, `charge.dispute.created`, `invoice.paid`, `customer.subscription.updated` und `customer.subscription.deleted`.
4. Tragen Sie das Signing-Secret des Endpunkts (`whsec_…`) als **Webhook-Secret** ein.
5. Klicken Sie auf **Speichern und prüfen**. Plazello prüft die Schlüssel direkt bei Stripe und meldet den Namen des verbundenen Kontos.

Gespeicherte Secrets werden nicht wieder angezeigt – lassen Sie das Feld leer, um den bisherigen Wert zu behalten. Mit **Schlüssel entfernen** trennen Sie die Verbindung; Stripe erscheint dann nicht mehr im Checkout, bestehende Bestellungen bleiben erhalten.

:::warning
Ohne Webhook-Secret werden Zahlungen nur bestätigt, wenn der Kunde nach der Zahlung in den Shop zurückkehrt. Erstattungen im Stripe-Dashboard und Abo-Verlängerungen kommen dann nicht im Shop an.
:::

## Testmodus

Mit Test-Schlüsseln (`pk_test_…` / `sk_test_…`) zeigt die Seite **Testmodus** – es fließt kein echtes Geld, und die Zahlart ist in der Übersicht unter **Einstellungen → Zahlungen** als **Aktiv – Testmodus** gekennzeichnet. Stellen Sie vor dem Start auf Live-Schlüssel um. Publishable und Secret Key müssen zum selben Modus gehören; sonst weist Sie die Seite darauf hin.

## Reihenfolge und Regeln im Checkout

Unter **Einstellungen → Zahlungen** legen Sie fest, an welcher Stelle Stripe im Checkout erscheint, ob die Zahlart angeboten wird und für wen – etwa nur für bestimmte Länder oder Bestellwerte. Details dazu unter [Zahlungsarten](doc:zahlungsarten).