Anleitung · Allgemeines

Stripe einrichten: Schritt für Schritt von der Anmeldung bis zur ersten Zahlung

DSGVO Server & Hosting in DE BSI Allianz für Cybersicherheit BSI Allianz für Cybersicherheit ProHunde ProHunde-Kooperation BVZ Berufsverband zertifizierter Hundetrainer BVZ-Kooperation

Stripe einrichten: Schritt für Schritt von der Anmeldung bis zur ersten Zahlung

Mit Stripe bezahlen deine Kunden online, zum Beispiel per Karte. Diese Anleitung zeigt dir jeden einzelnen Klick in PetWorkers Classic: vom Stripe-Konto über die Schlüssel und den Webhook bis zur ersten Zahlung. Mach einfach einen Schritt nach dem anderen. Plane etwa 20 Minuten ein.

Du arbeitest mit PetWorkers Wave? Dann nimm die Stripe-Anleitung für Wave.

Das brauchst du

  • Eine E-Mail-Adresse und ein Passwort für Stripe.
  • Einen Login als Administrator in PetWorkers. Nur Administratoren sehen die Stripe-Seite.
  • Zwei Browser-Tabs: einen mit PetWorkers, einen mit Stripe. So kopierst du bequem hin und her.

Diese drei Werte holst du dir

  • Publishable Key – bei Stripe „Veröffentlichbarer Schlüssel“, beginnt mit pk_. Den darf man sehen.
  • Secret Key – bei Stripe „Geheimschlüssel“, beginnt mit sk_. Geheim! Nie per E-Mail schicken, nie auf ein Foto.
  • Webhook Secret – bei Stripe „Signatur-Geheimnis“, beginnt mit whsec_. Auch geheim.

Die Bilder zeigen Stripe auf Deutsch. Ist dein Stripe auf Englisch, steht der englische Name in Klammern dabei.

Der Ablauf

  1. Stripe-Konto anlegen
  2. Testmodus erkennen
  3. Die zwei Schlüssel bei Stripe holen
  4. Die Schlüssel in PetWorkers eintragen
  5. Den Webhook bei Stripe anlegen
  6. Das Webhook Secret in PetWorkers eintragen und testen
  7. Eine Testzahlung machen
  8. Auf echte Zahlungen umstellen
  9. Wenn etwas nicht klappt

Wichtig: Fang immer im Testmodus an. Da fließt kein echtes Geld. Wenn alles klappt, machst du Teil 3 bis 6 noch einmal für den Livemodus.

Teil 1: Stripe-Konto anlegen

Hast du schon ein Stripe-Konto? Dann spring zu Teil 2.

Schritt 1: Registrieren

Öffne dashboard.stripe.com/register. Den Link findest du auch in PetWorkers auf der Stripe-Seite: „Bei Stripe registrieren“.

Stripe-Registrierung mit den Feldern E-Mail, Vollständiger Name, Passwort und Land
(1) E-Mail, Vollständiger Name und Passwort eintragen. (2) Bei „Land“ das Land deines Betriebs wählen. (3) Auf „Konto erstellen“ klicken.

Was du hier siehst: das Formular „Erstellen Sie Ihr Stripe-Konto“. Was du tust: die drei Felder ausfüllen, das Land wählen, auf „Konto erstellen“ klicken.

Schritt 2: E-Mail bestätigen

Stripe schickt dir eine E-Mail. Öffne sie und klicke auf den Link darin. Damit ist deine Adresse bestätigt.

Schritt 3: Anmelden

Ab jetzt meldest du dich unter dashboard.stripe.com/login an.

Stripe-Anmeldung mit E-Mail-Adresse, Passwort und Knopf Anmelden
(1) E-Mail-Adresse, (2) Passwort, (3) „Anmelden“.

Für den Testmodus reicht das schon. Für echte Zahlungen will Stripe später mehr über deinen Betrieb wissen: Rechtsform, Adresse, Bankkonto für die Auszahlungen und einen Ausweis. Das machst du in Teil 8.

Teil 2: Testmodus erkennen

Stripe hat zwei Welten. Im Testmodus (bei Stripe „Sandbox“) ist alles Spielgeld. Im Livemodus ist das Geld echt. Jede Welt hat ihre eigenen Schlüssel und ihren eigenen Webhook.

Schritt 4: Prüfen, ob du im Testmodus bist

Stripe-Dashboard im Testmodus mit dem Balken Sandbox und dem Hinweis Test-Modus oben links
(1) Der dunkelblaue Balken „Sandbox“ ganz oben. (2) Oben links steht „Test-Modus“.

Was du hier siehst: Ganz oben ein dunkelblauer Balken mit „Sandbox“ und dem Satz „Sie führen einen Test in einer Sandbox durch. Es werden keine tatsächlichen Transaktionen verarbeitet.“ Oben links steht „Test-Modus“. Dann bist du richtig. Die Test-Schlüssel beginnen mit pk_test_ und sk_test_.

Schritt 5: Zwischen Test und Live wechseln

Klicke oben links auf deinen Kontonamen. Es öffnet sich ein Menü.

Geöffnetes Kontomenü bei Stripe mit Sandbox verlassen und Zu Sandbox wechseln
(1) „Sandbox verlassen“ bringt dich in den Livemodus. (2) „Zu Sandbox wechseln“ bringt dich zurück in den Testmodus.

Für Teil 3 bis 7 bleibst du im Testmodus.

Teil 3: Die zwei Schlüssel bei Stripe holen

Schritt 6: Die Seite „API-Schlüssel“ öffnen

Kürzester Weg: In PetWorkers steht unter jedem Schlüsselfeld der Link „Wo finde ich das?“. Er öffnet genau die richtige Stripe-Seite: beim Testbetrieb die Test-Seite, beim Livebetrieb die Live-Seite.

PetWorkers Classic: Link Wo finde ich das unter dem Feld Test: Publishable Key
(1) „Wo finde ich das?“ unter dem Feld öffnet die passende Stripe-Seite.

Oder du gehst bei Stripe selbst hin: Klicke links unter „Verknüpfungen“ auf „API-Schlüssel“ (API keys). Oder rechts auf der Startseite im Kasten „API-Schlüssel“ auf „Zu den API-Schlüsseln“. Direkt: dashboard.stripe.com/test/apikeys.

Stripe-Startseite mit dem Menüpunkt API-Schlüssel links und dem Link Zu den API-Schlüsseln rechts
(1) Links „API-Schlüssel“ oder (2) rechts „Zu den API-Schlüsseln“.

Schritt 7: Den Veröffentlichbaren Schlüssel kopieren

Stripe-Seite API-Schlüssel mit Veröffentlichbarem Schlüssel oben rechts und dem Geheimschlüssel in der Tabelle, Schlüssel unkenntlich
(1) Oben rechts: „Veröffentlichbarer Schlüssel“ mit Kopier-Symbol. (2) In der Tabelle: der Geheimschlüssel in der Spalte „Token“, ebenfalls mit Kopier-Symbol.

Was du hier siehst: die Seite „API-Schlüssel“. Oben rechts steht „Veröffentlichbarer Schlüssel“ (Publishable key) und dahinter pk_test_….

Was du kopierst: Klicke auf das kleine Kopier-Symbol (das Klemmbrett) rechts neben pk_test_…. Jetzt ist der Schlüssel in deiner Zwischenablage. Trag ihn gleich in PetWorkers ein (Teil 4), dann kommst du zurück.

Schritt 8: Den Geheimschlüssel kopieren

Was du hier siehst: Unten in der Tabelle steht eine Zeile „Geheimschlüssel“ (Secret key). In der Spalte „Token“ steht sk_test_….

Was du kopierst: Klicke auf das Kopier-Symbol rechts neben sk_test_…. Dieser Schlüssel ist geheim: Zeig ihn niemandem.

Teil 4: Die Schlüssel in PetWorkers eintragen

Schritt 9: Die Stripe-Seite in PetWorkers öffnen

Klicke links im Menü auf System und dann auf Einstellungen. Oben siehst du eine Reihe Knöpfe. Klicke auf „Stripe“. Direkt: /settings.stripe.php hinter deiner PetWorkers-Adresse.

PetWorkers Classic: Menü System, Einstellungen und Knopf Stripe
(1) Links „System“ → „Einstellungen“. (2) Oben der Knopf „Stripe“.

Schritt 10: Haken setzen und Schlüssel einfügen

PetWorkers Classic: Haken Stripe aktiv und Stripe Testmodus, Felder Test: Publishable Key und Test: Secret Key
(1) Haken bei „Stripe aktiv“ und „Stripe Testmodus“. (2) „Test: Publishable Key“ (pk_test_…). (3) „Test: Secret Key“ (sk_test_…).
  1. Setz den Haken bei „Stripe aktiv“.
  2. Setz den Haken bei „Stripe Testmodus“. Mit diesem Haken gelten die Test-Schlüssel.
  3. Klicke links im Abschnitt „Testbetrieb“ in das Feld „Test: Publishable Key“ und füge den pk_test_…-Schlüssel ein (Strg+V, am Mac ⌘+V).
  4. Füge den sk_test_…-Schlüssel in das Feld „Test: Secret Key“ ein.
  5. Klicke unten auf „Speichern“.

Gut zu wissen: Gespeicherte geheime Schlüssel zeigt PetWorkers nicht mehr an. Unter dem Feld steht dann „Hinterlegt (endet auf …)“ mit den letzten vier Zeichen. Lässt du das Feld leer und speicherst, bleibt der Schlüssel gespeichert. Mit einem „-“ im Feld löschst du ihn.

Teil 5: Den Webhook bei Stripe anlegen

Der Webhook ist eine Nachricht von Stripe an PetWorkers: „Der Kunde hat bezahlt.“ Ohne Webhook erfährt PetWorkers nicht sicher davon.

Schritt 12: Die Webhook-Adresse in PetWorkers kopieren

Ganz unten auf der Stripe-Seite in PetWorkers steht der Kasten „Webhook“. Darin steht deine Adresse. Sie endet auf /stripe.webhook.php.

PetWorkers Classic: Kasten Webhook mit der Adresse und dem Knopf Kopieren
(1) Deine Webhook-Adresse. (2) „Kopieren“. Im Bild steht eine Beispieladresse. Nimm immer die aus deinem PetWorkers.

Was du kopierst: Klicke auf „Kopieren“. Der Knopf zeigt danach „Kopiert“.

Schritt 13: Bei Stripe die Webhooks öffnen

Klicke bei Stripe ganz unten links auf „Entwickler/innen“ (Developers). Es öffnet sich die Workbench. Klicke dort oben auf den Reiter „Webhooks“. Direkt: dashboard.stripe.com/test/workbench/webhooks. Auch der Link „Wo finde ich das?“ am Feld „Test: Webhook Secret“ in PetWorkers führt dorthin.

Stripe-Startseite mit der Leiste Entwickler/innen unten links
(1) Unten links: „Entwickler/innen“.

Schritt 14: „Ziel hinzufügen“ klicken

Stripe Workbench, Reiter Webhooks mit der Liste Ereignisziele und dem Knopf Ziel hinzufügen
(1) Reiter „Webhooks“. (2) „Ziel hinzufügen“.

Was du hier siehst: die Seite „Ereignisziele“ (Event destinations). Hast du noch keinen Webhook, ist die Liste leer. Was du tust: auf „+ Ziel hinzufügen“ (Add destination) klicken. Es öffnet sich „Ereignisziel erstellen“ mit drei Schritten links: „Ereignisse auswählen“, „Zieltyp auswählen“, „Ziel konfigurieren“.

Schritt 15: „Ihr Konto“ und „Momentaufnahme“ wählen

Stripe Ereignisziel erstellen: Event-Zielbereiche Ihr Konto und Nutzlast-Stil Momentaufnahme
(1) Bei „Event-Zielbereiche“: „Ihr Konto“. (2) Bei „Nutzlast-Stil“: „Momentaufnahme“.
  1. Bei „Event-Zielbereiche“ wählst du „Ihr Konto“ (Your account). Das ist meist schon gewählt.
  2. Bei „Nutzlast-Stil“ wählst du „Momentaufnahme“ (Snapshot), nicht „Thin“. Auch das ist meist schon gewählt.
  3. Die „API-Version“ lässt du, wie sie ist.

Schritt 16: Die vier Ereignisse anhaken

Stripe: Suchfeld mit checkout.session und die vier angehakten Ereignisse
(1) Ins Suchfeld „checkout.session“ tippen. (2) Alle vier Ereignisse anhaken. (3) „Weiter“.
  1. Scroll nach unten zu „Ereignisse“.
  2. Klicke in das Suchfeld „Ereignis nach Name oder Beschreibung suchen …“ und tippe checkout.session.
  3. Setz bei allen vier einen Haken:
    • checkout.session.async_payment_failed
    • checkout.session.async_payment_succeeded
    • checkout.session.completed
    • checkout.session.expired
  4. Oben beim Reiter „Ausgewählte Ereignisse“ steht jetzt eine 4. Klicke unten rechts auf „Weiter“.

Schritt 17: „Webhook-Endpoint“ wählen

Stripe: Zieltyp Webhook-Endpoint ausgewählt
(1) „Webhook-Endpoint“ anklicken. (2) „Weiter“.

Was du hier siehst: „Wählen Sie aus, wohin Sie Ereignisse senden möchten“. Was du tust: auf „Webhook-Endpoint“ (Webhook endpoint) klicken, dann auf „Weiter“.

Schritt 18: Adresse einfügen und Ziel erstellen

Stripe Ziel konfigurieren: Felder Zielname und Endpoint-URL, Knopf Ziel erstellen
(1) „Zielname“, zum Beispiel PetWorkers. (2) Bei „Endpoint-URL“ deine Adresse aus PetWorkers einfügen. (3) „Ziel erstellen“.
  1. Bei „Zielname“ schreibst du zum Beispiel PetWorkers. Das ist nur für dich.
  2. Klicke in das Feld „Endpoint-URL“ und füge deine Webhook-Adresse aus Schritt 12 ein (Strg+V bzw. ⌘+V). Sie muss mit https:// beginnen und auf /stripe.webhook.php enden.
  3. „Beschreibung“ kannst du leer lassen.
  4. Klicke auf „Ziel erstellen“ (Create destination).

Schritt 19: Das Signatur-Geheimnis kopieren

Stripe zeigt jetzt dein neues Ziel. Rechts unter „Details zum Ziel“ steht der Kasten „Signatur-Geheimnis“ (Signing secret).

Stripe: Webhook-Ziel mit dem Kasten Signatur-Geheimnis, Wert verdeckt
(1) Das Signatur-Geheimnis (whsec_…). (2) Das Auge zeigt es an, danach kannst du es kopieren. (3) Den Kreispfeil NICHT anklicken – er erzeugt ein neues Geheimnis.
  1. Klicke auf das Auge rechts im Kasten. Jetzt siehst du den ganzen Wert. Er beginnt mit whsec_.
  2. Kopiere den ganzen Wert.
  3. Klicke nicht auf den Kreispfeil daneben. Der erzeugt ein neues Geheimnis, und das alte gilt nicht mehr.

Teil 6: Das Webhook Secret in PetWorkers eintragen und testen

Schritt 20: Webhook Secret einfügen

PetWorkers Classic: Feld Test: Webhook Secret, Knöpfe Speichern und Verbindung testen
(1) „Test: Webhook Secret“ (whsec_…). (2) „Speichern“. (3) „Verbindung testen“.
  1. Füge den whsec_…-Wert in das Feld „Test: Webhook Secret“ ein.
  2. Klicke auf „Speichern“.

Hast du den Webhook im Testmodus angelegt, gehört das Secret ins Feld „Test: Webhook Secret“. Ein Webhook aus dem Livemodus gehört später ins Feld „Live: Webhook Secret“.

Schritt 21: „Verbindung testen“ klicken

PetWorkers Classic: Meldung Verbindung erfolgreich nach dem Verbindungstest
(1) Diese Meldung erscheint oben, wenn alles passt.

Was du tust: auf „Verbindung testen“ klicken. Was du lesen musst: Steht dort „Verbindung erfolgreich — Testbetrieb, Stripe-Konto im Test-Modus.“, passt alles. Steht dort etwas anderes, schau unter Wenn etwas nicht klappt.

Oben auf der Seite steht jetzt „Aktiv: Testbetrieb“. Das heißt: PetWorkers nimmt die Test-Schlüssel, und es fließt kein echtes Geld.

Teil 7: Eine Testzahlung machen

Schritt 22: Mit der Testkarte bezahlen

  1. Buche auf deiner Website etwas, das online bezahlt werden kann, zum Beispiel einen Einzeltermin mit „Onlinezahlung aktivieren“. Oder melde dich im Kundenbereich an und klicke unter Rechnungen bei einer offenen Rechnung auf „… online bezahlen“.
  2. Nimm dafür deine eigene E-Mail-Adresse, nicht die eines Kunden. Die Bestätigungs-Mails kommen auch im Testmodus.
  3. Im Bezahlfenster von Stripe gibst du die Testkarte 4242 4242 4242 4242 ein. Dazu ein beliebiges Datum in der Zukunft, eine beliebige dreistellige Prüfnummer und, falls gefragt, eine beliebige Postleitzahl.
  4. Bezahle. Du kommst zurück auf deine Seite.

Schritt 23: Die Zahlung bei Stripe finden

Stripe Transaktionen mit dem Reiter Zahlungen im Testmodus
(1) Links „Transaktionen“. (2) Reiter „Zahlungen“: hier steht deine Testzahlung.

Klicke bei Stripe links auf „Transaktionen“ (Transactions) und oben auf „Zahlungen“ (Payments). Direkt: dashboard.stripe.com/test/payments. Was du lesen musst: Deine Testzahlung steht oben in der Liste, mit dem Betrag und dem Status „Erfolgreich“ (Succeeded).

Schritt 24: Prüfen, ob der Webhook angekommen ist

Stripe Webhook-Ziel, Reiter Ereignisübermittlungen mit Status und Antwort
(1) Reiter „Ereignisübermittlungen“. (2) Der Status jeder Zustellung. (3) Die Antwort von PetWorkers. Im Bild siehst du fehlgeschlagene Zustellungen als Beispiel.
  1. Öffne bei Stripe wieder „Entwickler/innen“ → „Webhooks“ und klicke auf dein Ziel.
  2. Klicke auf den Reiter „Ereignisübermittlungen“ (Event deliveries).
  3. Was du lesen musst: Links steht jede Nachricht mit ihrem Status. „Erfolgreich“ (Succeeded) heißt: PetWorkers hat die Nachricht bekommen. „Fehlgeschlagen“ (Failed) heißt: Es hat nicht geklappt. Rechts unter „Antwort“ steht dann der Grund.

In PetWorkers ist die Buchung jetzt fest bzw. die Rechnung bezahlt.

Teil 8: Auf echte Zahlungen umstellen

Klappt alles im Test? Dann machst du dasselbe noch einmal im Livemodus.

Schritt 25: Konto bei Stripe aktivieren

Stripe zahlt erst echtes Geld aus, wenn dein Konto aktiviert ist. Stripe fragt dafür nach Rechtsform, Adresse, Bankkonto und Ausweis. Folge dort den Hinweisen auf der Startseite.

Schritt 26: In den Livemodus wechseln und die Live-Schlüssel holen

Klicke oben links auf deinen Kontonamen und dann auf „Sandbox verlassen“ (siehe Schritt 5). Der dunkelblaue Balken „Sandbox“ ist jetzt weg. Öffne dashboard.stripe.com/apikeys.

Stripe-Seite API-Schlüssel im Livemodus, Schlüssel unkenntlich
(1) Ohne Sandbox-Balken bist du live: Der Veröffentlichbare Schlüssel beginnt mit pk_live_. (2) „Geheimschlüssel erstellen“, falls du keinen Live-Geheimschlüssel mehr kopieren kannst.
  1. Kopiere den „Veröffentlichbaren Schlüssel“ (pk_live_…) über das Kopier-Symbol.
  2. Kopiere den Geheimschlüssel (sk_live_…). Im Livemodus zeigt Stripe ihn oft nur ein einziges Mal, gleich nach dem Erstellen. Kannst du ihn nicht mehr kopieren, klicke auf „Geheimschlüssel erstellen“ und kopiere den neuen sofort. Ein eingeschränkter Schlüssel (rk_live_…) geht auch.

Schritt 27: Live-Schlüssel in PetWorkers eintragen

Trag die beiden Schlüssel rechts im Abschnitt „Livebetrieb“ ein: „Live: Publishable Key“ und „Live: Secret Key“. Dann „Speichern“.

Schritt 28: Einen eigenen Live-Webhook anlegen

Stripe Workbench Webhooks im Livemodus mit dem Knopf Ziel hinzufügen
(1) Im Livemodus legst du mit „Ziel hinzufügen“ einen eigenen Webhook an – genau wie in Schritt 14 bis 19.
  1. Öffne dashboard.stripe.com/workbench/webhooks (ohne Sandbox-Balken).
  2. Mach Schritt 14 bis 19 noch einmal: dieselbe Adresse, dieselben vier Ereignisse.
  3. Das neue Signatur-Geheimnis kommt in PetWorkers ins Feld „Live: Webhook Secret“.

Schritt 29: Testmodus in PetWorkers ausschalten

Nimm den Haken bei „Stripe Testmodus“ heraus und klicke auf „Speichern“. Dann „Verbindung testen“. Jetzt muss dort „Verbindung erfolgreich — Livebetrieb, Stripe-Konto im Live-Modus.“ stehen, und oben steht „Aktiv: Livebetrieb“.

Mach zum Schluss eine kleine echte Zahlung und prüfe sie wie in Teil 7, diesmal unter dashboard.stripe.com/payments.

Beide Schlüsselsätze dürfen gleichzeitig eingetragen sein. Zum Umschalten änderst du nur den Haken „Stripe Testmodus“. PetWorkers erkennt beide Webhook Secrets. Fürs Umschalten brauchst du also keinen neuen Webhook.

Wenn etwas nicht klappt

  • „Verbindung testen“ meldet „Der Schlüssel gehört zum Live-Konto, eingestellt ist aber Testbetrieb“ (oder umgekehrt): Der Schlüssel steht im falschen Abschnitt, oder der Schalter „Stripe Testmodus“ steht falsch. pk_test_/sk_test_ gehören zum Testbetrieb, pk_live_/sk_live_ zum Livebetrieb.
  • Gelbe Meldung „Das Feld … enthält keinen Schlüssel, der mit … beginnt“: In dem Feld steht der falsche Schlüssel. Meist ist pk_ und sk_ vertauscht.
  • Gelbe Meldung „Es ist kein Webhook Secret hinterlegt“: Teil 5 und 6 fehlen noch.
  • Stripe-Fehler beim Verbindungstest: Der Secret Key ist unvollständig kopiert oder gelöscht. Kopiere ihn neu.
  • Zahlung bei Stripe da, in PetWorkers nicht: Öffne bei Stripe dein Ziel → „Ereignisübermittlungen“ (Schritt 24).
    • Status „Fehlgeschlagen“ und Antwort mit 400: Das Webhook Secret stimmt nicht oder steht im falschen Feld (Test/Live).
    • „Timed out“ oder 404: Die Endpoint-URL ist falsch. Vergleiche sie Zeichen für Zeichen mit dem Kasten „Webhook“ in PetWorkers. Über „Ziel bearbeiten“ kannst du sie korrigieren.
    • Gar keine Übermittlungen: Es fehlt ein Ereignis. Über „Ziel bearbeiten“ ergänzt du die vier aus Schritt 16.
  • Testzahlung bei Stripe nicht zu sehen: Du bist nicht in der Sandbox. Wechsle wie in Schritt 5.
  • Webhook im Test angelegt, Live klappt nicht: Live braucht einen eigenen Webhook und ein eigenes Secret (Schritt 28).
  • Signatur-Geheimnis aus Versehen neu erzeugt: Kopiere das neue und trag es in PetWorkers ein. Das alte gilt nicht mehr.
  • Geheimschlüssel verloren: Erstelle bei Stripe einen neuen und trag ihn in PetWorkers ein.

Diese Anleitung direkt aus PetWorkers öffnen

PetWorkers Classic: Knopf Hilfe oben rechts auf der Stripe-Seite
(1) Auf der Stripe-Seite öffnet „Hilfe“ oben rechts diese Anleitung.

Siehe auch: Terminfreigabe (Onlinezahlung bei der Sofortbuchung).

Zeit für den Wechsel

Frage noch offen?

Wenn dir in der Anleitung etwas fehlt — schreib uns. Wir nehmen Themen aus Support-Tickets oft sofort als neue Anleitung auf.

Support-Ticket öffnen Zurück zu Hilfe & Support
DSGVO-konform Server in Deutschland Persönlicher Support