Tutorials

Stripe API-Keys finden: Publishable Key, Secret Key & Webhook Secret [2025 Easy Guide]

Melden

Hier ist ein aktuelles und einfach zu folgendes Tutorial für das Jahr 2025, um die benötigten Stripe-Zugangsdaten zu finden.

Um Stripe in deine Website oder App zu integrieren, benötigst du drei zentrale Identifikatoren. In dieser Anleitung zeigen wir dir Schritt für Schritt, wo du diese im neuen Stripe-Dashboard findest.

Schritt 1: Einloggen und den Entwickler-Modus aufrufen

  1. Melde dich in deinem Stripe Dashboard an.
  2. Stelle sicher, dass du oben rechts den Schalter "Test-Modus" (Test Mode) aktiviert hast, falls du erst einmal nur testen möchtest. (Die Schritte für Live-Keys sind identisch, erfordern aber ein aktiviertes Konto).
  3. Klicke oben rechts im Menü auf den Tab Entwickler (Developers).

Schritt 2: Publishable Key und Secret Key finden

Sobald du im Entwickler-Bereich bist:

  1. Klicke im linken Seitenmenü auf den Punkt API-Schlüssel (API keys).
  2. Hier siehst du nun zwei wichtige Schlüssel:
    • Veröffentlichbarer Schlüssel (Publishable Key): Dieser beginnt meist mit pk_test_... oder pk_live_.... Er ist für dein Frontend (z.B. Stripe.js) gedacht.
    • Geheimer Schlüssel (Secret Key): Dieser beginnt mit sk_test_... oder sk_live_....
  3. Klicke auf „Geheimen Schlüssel enthüllen“, um ihn kopieren zu können.
    • Wichtig: Speichere diesen Schlüssel sicher (z.B. in einer .env-Datei) und teile ihn niemals öffentlich!

Schritt 3: Webhook Signing Secret finden

Das Webhook-Geheimnis wird benötigt, um sicherzustellen, dass die Benachrichtigungen, die deine App von Stripe erhält, auch wirklich von Stripe gesendet wurden.

  1. Klicke im Menü Entwickler (links) auf den Unterpunkt Webhooks.
  2. Wenn du lokal entwickelst (Localhost):
    • Klicke auf „Lokal testen“.
    • Sobald du das Stripe CLI nutzt, wird dir dort ein Secret angezeigt, das mit whsec_... beginnt.
  3. Wenn du eine Live-URL hast (Produktion):
    • Klicke auf Endpunkt hinzufügen (Add endpoint).
    • Gib deine URL ein (z.B. https://deineseite.de/api/webhook) und wähle die Events aus, die du empfangen möchtest (z.B. checkout.session.completed).
    • Nachdem der Endpunkt erstellt wurde, siehst du im Bereich „Signierschlüssel“ (Signing secret) die Schaltfläche „Enthüllen“.
    • Dieser Key beginnt ebenfalls mit whsec_....

Zusammenfassung der Schlüssel (Checkliste)

Key Format Einsatzort
Publishable Key pk_... Frontend / Client-side Code
Secret Key sk_... Backend / Server-side Code
Webhook Secret whsec_... Backend (Validierung der Webhooks)

Sicherheitshinweise für 2025

  • Niemals Keys im Code pushen: Nutze Umgebungsvariablen (.env) und füge diese Datei zu deiner .gitignore hinzu.
  • Eingeschränkte Schlüssel (Restricted Keys): Für maximale Sicherheit empfiehlt Stripe 2025 die Verwendung von "Restricted Keys" anstatt des Master-Secret-Keys. Diese kannst du im gleichen Menü unter "Eingeschränkte Schlüssel" erstellen und ihnen nur die minimal nötigen Rechte geben.
  • Key-Rotation: Falls du vermutest, dass ein Key bekannt geworden ist, klicke neben dem Key auf die drei Punkte und wähle „Schlüssel rollieren“ (Roll key), um einen neuen zu generieren und den alten ungültig zu machen.

Glückwunsch! Du hast nun alle notwendigen Daten, um deine Stripe-Integration zu starten.

0