Wo finde ich meine Stripe-Schlüssel?
Für die Online-Zahlung braucht PetWorkers drei Angaben aus deinem Stripe-Konto: den Publishable Key, den Secret Key und das Webhook-Secret. Es gibt sie zweimal: einmal für den Testbetrieb und einmal für den Livebetrieb. In PetWorkers trägst du beide Sätze unter System → Einstellungen → Stripe ein; der Schalter „Stripe Testmodus" entscheidet, welcher gerade gilt.
Wer hat Zugriff?
- Administratoren — nur sie sehen und ändern die Stripe-Einstellungen.
- Alle anderen Rollen und deine Kunden — sehen die Schlüssel nie.
- Die Schlüssel sind vertraulich. Der Secret Key darf nie in E-Mails, Screenshots oder auf deiner Website auftauchen.
Mehr dazu auf der Seite Rollen und Rechte.
Welche E-Mails werden verschickt?
Diese Seite verschickt keine E-Mails. Geht eine Online-Zahlung ein, meldet PetWorkers das an deine Firmenadresse; der Kunde bekommt Bestätigung und Rechnung aus dem jeweiligen Bereich.
Kurz gesagt: In PetWorkers steht unter jedem Schlüsselfeld der Link Wo finde ich das?. Er öffnet die richtige Stelle im Stripe-Dashboard. Dort kopierst du den Wert und trägst ihn über das Stift-Symbol ein.
So holst du die API-Schlüssel
Ein API-Schlüssel ist eine Art Passwort, mit dem PetWorkers bei Stripe anfragen darf.
- Melde dich bei dashboard.stripe.com an.
- Stell oben rechts mit dem Schalter Testmodus ein, welchen Satz du holen willst: an für die Test-Schlüssel, aus für die Live-Schlüssel.
- Öffne dashboard.stripe.com/apikeys (im Menü: Entwickler/innen → API-Schlüssel).
- Kopiere den Veröffentlichbaren Schlüssel — er beginnt mit
pk_test_bzw.pk_live_. - Klicke beim Geheimschlüssel auf „Anzeigen" und kopiere ihn — er beginnt mit
sk_test_bzw.sk_live_. Stripe zeigt ihn nur einmal vollständig; danach legst du einen neuen an. - Trage beide in PetWorkers unter System → Einstellungen → Stripe in den passenden Abschnitt ein: Testbetrieb oder Livebetrieb.
So holst du das Webhook-Secret
Der Webhook meldet PetWorkers, dass eine Zahlung eingegangen ist. Ohne ihn bleibt eine Buchung offen, bis der Kunde zurück auf deine Seite kommt.
- Öffne dashboard.stripe.com/workbench/webhooks (in der neuen Oberfläche: unten links Entwickler/innen → Reiter Webhooks bzw. Ereignisziele).
- Klicke auf Ziel hinzufügen und wähle Ihr Konto.
- Wähle als Payload-Format „Snapshot" und diese vier Ereignisse:
checkout.session.completed,checkout.session.async_payment_succeeded,checkout.session.async_payment_failed,checkout.session.expired. - Als Ziel nimm Webhook-Endpunkt und trage die Adresse ein, die in PetWorkers unter System → Einstellungen → Stripe im Kasten Webhook steht (Knopf „Kopieren").
- Speichern, dann das neue Ziel öffnen und beim Signaturgeheimnis auf „Anzeigen" klicken. Der Wert beginnt mit
whsec_. - Trag ihn in PetWorkers beim passenden Satz ein — im Testmodus des Dashboards bei Test: Webhook Secret, sonst bei Live: Webhook Secret.
Das solltest du wissen
- Beide Sätze dürfen gleichzeitig eingetragen sein. Zum Umschalten setzt oder entfernst du nur den Haken „Stripe Testmodus" — du musst nichts neu eintippen.
- PetWorkers akzeptiert beide Webhook-Secrets. Ein Umschalten braucht also keinen neuen Webhook.
- Passt ein Schlüssel nicht zu seinem Feld (zum Beispiel ein
sk_test_im Livefeld), sagt dir die Einstellungsseite das sofort. - Mit „Verbindung testen" prüfst du, ob der aktive Schlüssel funktioniert. PetWorkers fragt dabei bei Stripe nach, zu welchem Konto der Schlüssel gehört, und meldet einen Fehler, wenn das nicht zum Schalter passt — etwa ein Test-Schlüssel im Livebetrieb.
- Der Testbetrieb kostet nichts und bewegt kein echtes Geld: Wie zahle ich im Testmodus?
Wenn etwas nicht klappt
- „Verbindung testen" meldet einen Fehler. — Der aktive Secret Key ist unvollständig kopiert oder gehört zum anderen Modus. Prüfe, ob „Stripe Testmodus" zum eingetragenen Schlüssel passt.
- Der Geheimschlüssel ist im Stripe-Dashboard nicht mehr ganz zu sehen. — Stripe zeigt ihn nur einmal vollständig. Lege dort einen neuen an und trage ihn in PetWorkers ein.
- Zahlungen kommen nicht in PetWorkers an. — Das Webhook-Secret fehlt oder gehört zum anderen Modus. Prüfe im Stripe-Dashboard die Zustellungen des Webhooks.