Welchen Stripe-Schlüssel muss ich für den Web-Shop erstellen?
Welchen Stripe-Schlüssel muss ich für den Web-Shop erstellen?
Kurze Antwort
Du brauchst zwei Schlüssel aus deinem Stripe-Konto:
den Publishable Key (beginnt mit pk_live_ )
einen Restricted Key (beginnt mit rk_live_ )
Einen Geheimschlüssel (sk_live_) brauchst du nicht mehr. Stripe empfiehlt für Integrationen wie 442 neu ausdrücklich den Restricted Key, weil dieser nur genau die Rechte hat, die 442 tatsächlich benötigt.
Früher gab es bei Stripe praktisch nur den Geheimschlüssel. Inzwischen bietet Stripe mehrere Schlüsseltypen an. Für 442 ist der Restricted Key der richtige.
Klick-Tutorial: Alle Schritte unten gibt es auch als bebilderte Anleitung direkt aus dem Stripe-Dashboard (Stand Oktober 2026, DE/EN/FR): Stripe: API-Schlüssel für 442 erstellen
Schritt 1: Publishable Key kopieren
Melde dich in deinem Stripe-Konto an und achte darauf, dass du nicht im Testmodus bist (kein orangefarbener Balken oben).
Öffne links unter Verknüpfungen den Punkt API-Schlüssel – alternativ unten links über Entwickler/innen .
Kopiere den Publishable Key ( pk_live_... ) über das Kopier-Symbol daneben.
Dieser Schlüssel darf öffentlich sein. Er wird im Browser deiner Käufer verwendet, damit das Stripe-Bezahlfenster erscheint.
Schritt 2: Eingeschränkten Schlüssel erstellen
Stripe führt dich seit Herbst 2026 durch einen Assistenten; den Knopf «Restricted Key erstellen» gibt es nicht mehr.
Klicke auf derselben Seite auf Geheimschlüssel erstellen .
Verwendung: wähle Mit einem Drittanbieter-Service teilen , Anbietername 442hz , URL https://442hz.com , dann Weiter .
Berechtigungen: wähle Benutzerdefinierte Berechtigungen (nicht Standard), dann Weiter .
Suche im Feld «Nach Ressource oder Endpoint suchen» nacheinander diese sechs Berechtigungen und setze sie; alles andere bleibt auf Keine :
Charges and Refunds (Gruppe Core): Schreiben
Customers (Gruppe Core): Schreiben
Balance Transaction Sources (Gruppe Core): Lesen
Accounts (Gruppe Connect – nicht «Connect Accounts» und nicht «Vault … Bank Accounts»): Lesen
Checkout Sessions : Schreiben
Webhook Endpoints, Event Destinations : Schreiben
Kontrolle: Filter Nur ausgewählte Berechtigungen anzeigen – es müssen genau sechs sein (2 Lesen, 4 Schreiben). Dann Weiter .
Name: 442hz (den Vorschlag «API-Schlüssel für 442hz» kürzen), optional ein Hinweis. Klicke Schlüssel erstellen und bestätige die Verifizierung (Passkey, Code oder E-Mail).
Klicke Kopieren und schließen – der Schlüssel beginnt mit rk_live_... .
Stripe zeigt dir den eingeschränkten Schlüssel nur ein einziges Mal an. Kopiere ihn sofort und lege ihn sicher ab, zum Beispiel in deinem Passwort-Manager.
Hinweis: Das Recht «Schreiben» schliesst «Lesen» automatisch mit ein. In der Schlüssel-Liste erscheint der Schlüssel mit Berechtigungen «Beschränkt».
Schritt 3: Schlüssel an 442 senden
Schicke uns die beiden Schlüssel per E-Mail an info@442hz.com – am besten in zwei getrennten Mails oder über den sicheren Teilen-Link deines Passwort-Managers. Bitte nicht über das Feedback-Tool.
Wir hinterlegen die Schlüssel anschliessend bei deinem Ensemble. Die Verknüpfung selbst kann nur der 442 Support vornehmen.
Wofür 442 die einzelnen Rechte braucht
Charges and Refunds : Anmelde-Gebühren belasten sowie Stornos und Rückerstattungen auslösen
Customers: den Käufer in Stripe anlegen, damit die Zahlung eindeutig zuordenbar ist
Checkout Sessions: das Stripe-Bezahlfenster für eine Bestellung erzeugen
Webhook Endpoints: die automatische Rückmeldung von Stripe an 442 einrichten und pflegen
Balance Transaction Sources: Stripe-Gebühren und Auszahlungen für deine Buchhaltung abgleichen
Accounts: prüfen, welche Zahlungsarten in deinem Konto freigeschaltet sind, zum Beispiel Karte, TWINT, PayPal oder Klarna
Falls etwas nicht funktioniert
Fehlt dem Restricted Key ein Recht, meldet Stripe einen Fehler mit dem Hinweis, welches Recht fehlt. Du kannst die Rechte jederzeit nachträglich anpassen: bei API-Schlüssel auf das Menü neben dem Schlüssel, dann Schlüssel bearbeiten. Der Schlüssel selbst bleibt dabei derselbe, du musst uns also nichts Neues schicken.
Zugriff zusätzlich einschränken
Stripe bietet neu Access Policies an. Damit kannst du einen Schlüssel auf bestimmte IP-Adressen oder Länder begrenzen. Wenn du das nutzen möchtest, melde dich bei uns, wir geben dir die IP-Adressen unserer Server.