Stripe

Im Stripe-Tab konfigurierst du alle Einstellungen fuer die Stripe-Zahlungsabwicklung. Hier gibst du deine API-Schluessel ein und waehlst zwischen Test- und Live-Modus.

Uebersicht

Der Tab zeigt:

Modus-Umschalter zwischen Test und Live
API-Schluessel-Felder fuer Publishable Key und Secret Key
Webhook Secret fuer die Zahlungsbestaetigung
Apple Merchant ID (falls Apple Pay aktiviert ist)
Verbindungstest zum Pruefen der Konfiguration

Test- vs. Live-Modus

Wann welchen Modus nutzen?

Modus	Zweck	API-Schluessel-Praefix
Testmodus	Zum Entwickeln und Testen	`pk_test_...` / `sk_test_...`
Live-Modus	Fuer echte Zahlungen	`pk_live_...` / `sk_live_...`

Testmodus aktivieren

Schalte Testmodus ein
Gib Test-API-Schluessel ein (beginnen mit pk_test_ und sk_test_)
Teste mit den Stripe-Testkartennummern

Test-Kreditkarten

Stripe stellt Testkartennummern bereit:

Karte	Nummer	Ergebnis
Erfolgreiche Zahlung	4242 4242 4242 4242	Zahlung erfolgreich
Zahlung abgelehnt	4000 0000 0000 0002	Karte abgelehnt
3D Secure	4000 0025 0000 3155	3D Secure erforderlich
Ungenuegend Deckung	4000 0000 0000 9995	Insufficient funds

Live-Modus aktivieren

Schalte Testmodus aus (Live-Modus ist aktiv)
Gib Live-API-Schluessel ein (beginnen mit pk_live_ und sk_live_)
Wichtig: Stelle sicher, dass alles im Testmodus funktioniert hat!

API-Schluessel

Publishable Key

Eigenschaft	Wert
Was es ist	Oeffentlicher Schluessel fuer die Client-Seite
Format	`pk_test_...` oder `pk_live_...`
Sicherheit	Kann in der App verwendet werden
Wo zu finden	Stripe Dashboard > API Keys

Eingabe:

Kopiere den Publishable Key aus dem Stripe Dashboard
Fuege ihn im Feld ein
Der Schluessel wird im Klartext gespeichert (ist oeffentlich)

Secret Key

Eigenschaft	Wert
Was es ist	Geheimer Schluessel fuer Server-zu-Server-Kommunikation
Format	`sk_test_...` oder `sk_live_...`
Sicherheit	Streng geheim! Nur auf Server speichern
Wo zu finden	Stripe Dashboard > API Keys

Eingabe:

Kopiere den Secret Key aus dem Stripe Dashboard
Fuege ihn im Feld ein
Der Schluessel wird verschluesselt ueber Cloud Functions gespeichert
Nach dem Speichern ist das Feld leer (der Schluessel ist sicher gespeichert)

API-Schluessel finden

Melde dich im Stripe Dashboard an
Gehe zu Developers > API keys
Waehle oben rechts zwischen Test mode und Live mode
Kopiere den Publishable key und den Secret key
Fuege sie in die entsprechenden Felder im Editor ein

Webhook Secret

Was ist ein Webhook Secret?

Das Webhook Secret authentifiziert eingehende Webhooks von Stripe. So stellt deine App sicher, dass die Zahlungsbestaetigung wirklich von Stripe kommt.

Eigenschaft	Wert
Format	`whsec_...`
Sicherheit	Geheim, wird verschluesselt gespeichert
Wo zu finden	Stripe Dashboard > Webhooks > Dein Endpoint

Webhook Secret erhalten

Gehe zum Stripe Webhooks Dashboard
Klicke auf deinen Webhook-Endpoint (den du im Setup-Tab erstellt hast)
Unter Signing secret klicke auf Reveal
Kopiere das Secret (beginnt mit whsec_)
Fuege es im Editor ein

Apple Merchant ID

Dieses Feld erscheint nur, wenn Apple Pay im Anbieter-Tab aktiviert ist.

Eigenschaft	Wert
Was es ist	Identifikator fuer Apple Pay Transaktionen
Format	`merchant.com.example.app`
Wo zu finden	Apple Developer Portal

Apple Merchant ID erstellen

Melde dich im Apple Developer Portal an
Gehe zu Certificates, IDs & Profiles
Waehle Identifiers > Merchant IDs
Klicke auf + und erstelle eine neue Merchant ID
Kopiere die erstellte ID (z.B. merchant.com.deinefirma.app)
Fuege sie im Editor ein

Verbindung testen

Nach der Eingabe aller Schluessel kannst du die Verbindung testen:

Tippe auf Jetzt testen
Warte auf das Ergebnis (wenige Sekunden)
Bei Erfolg erscheint Verbindung erfolgreich!
Bei Fehler erscheint Verbindung fehlgeschlagen

Moegliche Fehler

Fehler	Ursache	Loesung
Verbindung fehlgeschlagen	Falscher API-Schluessel	Schluessel pruefen
Ungueltig	Format stimmt nicht	Auf `pk_` bzw. `sk_` pruefen
Kein Zugriff	Cloud Functions nicht deployed	Setup-Tab pruefen

Einstellungen im Ueberblick

Einstellung	Optionen	Standard	Beschreibung
Testmodus	Ein / Aus	Ein	Test- oder Live-Schluessel verwenden
Publishable Key	Text	-	Oeffentlicher API-Schluessel
Secret Key	Text (verdeckt)	-	Geheimer API-Schluessel
Webhook Secret	Text (verdeckt)	-	Authentifiziert Webhooks
Apple Merchant ID	Text	-	Fuer Apple Pay (optional)

Haeufige Fragen

Wo finde ich meine API-Schluessel?

Im Stripe Dashboard unter Developers > API keys. Achte darauf, ob du im Test- oder Live-Modus bist!

Warum sehe ich meinen Secret Key nach dem Speichern nicht mehr?

Das ist Absicht! Der Secret Key wird sicher in Firebase gespeichert und aus Sicherheitsgruenden nicht mehr angezeigt. Du kannst jederzeit einen neuen eingeben.

Kann ich Test- und Live-Schluessel mischen?

Nein! Entweder alle Test-Schluessel (pk_test_, sk_test_, Test-Webhook) oder alle Live-Schluessel. Das Mischen fuehrt zu Fehlern.

Was passiert, wenn ich den Modus wechsle?

Du musst die entsprechenden Schluessel fuer den neuen Modus eingeben. Test-Schluessel funktionieren nicht im Live-Modus und umgekehrt.

Brauche ich das Webhook Secret?

Ja! Ohne Webhook Secret kann deine App nicht verifizieren, ob eine Zahlungsbestaetigung echt ist. Das ist ein Sicherheitsrisiko.