Mit der Stripe-Anbindung bezahlen Ihre Kunden Buchungen direkt online — je nach Konfiguration per Kreditkarte, PayPal, SEPA-Lastschrift und weiteren Methoden. Die Buchung wird erst nach Zahlungseingang verbindlich; Rechnung, Zahlungsverbuchung und Bestätigungsmails erledigt PetWorkers Wave automatisch. Diese Anleitung führt von der Kontoeröffnung bis zur ersten Testbuchung.

1. Was die Stripe-Anbindung leistet

• Unterstützte Buchungsstrecken: Terminfreigaben (einzeln freigegebene Termine), Terminbuchung über Mitarbeiter-Verfügbarkeiten und die Platzvermietung.
• Ablauf für den Kunden: „Verbindlich buchen“ klicken, auf der sicheren Stripe-Bezahlseite zahlen, automatisch zurückkehren. Kartendaten sieht und speichert nur Stripe — nie PetWorkers.
• Automatik nach Zahlungseingang: Buchung wird bestätigt, die Rechnung erstellt, die Zahlung darauf verbucht (Rechnung sofort „bezahlt“, Zahlungsart „Stripe“) und Bestätigung samt Rechnung per E-Mail zugestellt.
• Reservierung während der Zahlung: Der gewählte Termin bzw. Zeitraum ist während des Bezahlvorgangs für andere gesperrt und wird bei Abbruch automatisch wieder frei.
• Kosten: Stripe berechnet je Transaktion eine Gebühr (stripe.com/de/pricing); PetWorkers erhebt keinen Aufschlag.

2. Stripe-Konto anlegen

1. Unter https://dashboard.stripe.com/register kostenlos registrieren und die E-Mail-Adresse bestätigen.
2. Unternehmensangaben vervollständigen (Rechtsform, Anschrift, vertretungsberechtigte Person) — ohne vollständige Verifizierung bleibt das Konto im eingeschränkten Modus.
3. Unter Einstellungen → Bankkonten und Währungen das Geschäftskonto (IBAN) für die Auszahlungen hinterlegen.
4. Zwei-Faktor-Authentifizierung aktivieren.

Die komplette PetWorkers-Einrichtung lässt sich bereits im Testmodus durchführen, während die Verifizierung läuft — nur für den Livegang muss das Konto verifiziert sein.

3. API-Schlüssel finden & verstehen

PetWorkers spricht mit Stripe über zwei Schlüssel, die es je einmal für den Test- und den Livemodus gibt (Umschalter oben rechts im Stripe-Dashboard):

• Publishable Key (pk_test_… / pk_live_…) — öffentlicher Schlüssel, unkritisch.
• Secret Key (sk_test_… / sk_live_…) — wie ein Passwort behandeln, niemals weitergeben.

Fundort: Stripe-Dashboard → Entwickler → API-Schlüssel. Test- und Live-Schlüssel dürfen nie gemischt werden.

4. Schlüssel in PetWorkers eintragen

1. In PetWorkers als Administrator anmelden → System → Einstellungen → Button Stripe.
2. Felder ausfüllen: Stripe aktiv = Ja, Stripe Testmodus = Ja (solange Test-Schlüssel verwendet werden), Publishable Key und Secret Key einfügen.
3. Unten Verbindung testen klicken — PetWorkers meldet den Modus des Stripe-Kontos und warnt bei vertauschten Test-/Live-Schlüsseln.

Die Währung übernimmt PetWorkers aus der Grundeinstellung Währungscode (Finanz-Einstellungen); eine eigene Stripe-Währungseinstellung ist nicht nötig.

5. Webhook einrichten

Über den Webhook meldet Stripe eingegangene Zahlungen an PetWorkers zurück — erst damit werden Buchungen automatisch verbucht.

1. In PetWorkers unter Einstellungen → Stripe die im Kasten Webhook angezeigte Endpunkt-Adresse kopieren (https://<Ihre-Domain>/stripe.webhook.php).
2. Im Stripe-Dashboard: Entwickler → Webhooks → Endpunkt hinzufügen, die Adresse einfügen.
3. Ereignisse abonnieren: checkout.session.completed (Pflicht) sowie empfohlen checkout.session.async_payment_succeeded, checkout.session.async_payment_failed und checkout.session.expired.
4. Das angezeigte Signatur-Geheimnis (whsec_…) in PetWorkers als Stripe Webhook Secret eintragen.

Webhook-Endpunkte gelten je Modus: Für den Livegang den Endpunkt im Livemodus erneut anlegen und das neue Geheimnis eintragen.

6. Zahlungsmethoden bei Stripe aktivieren

Welche Zahlungsarten Kunden auf der Stripe-Bezahlseite sehen, steuern Sie im Stripe-Dashboard unter Einstellungen → Zahlungen → Zahlungsmethoden. Empfohlen für den deutschsprachigen Raum: Karten, PayPal (einmalig mit dem PayPal-Geschäftskonto verknüpfen) und SEPA-Lastschrift (Zahlungen gelten erst nach einigen Bankarbeitstagen als bestätigt — PetWorkers verbucht die Buchung dann automatisch mit der Bestätigung).

7. Stripe in den Buchungsmodulen anbieten

Stripe wird je Angebot einzeln freigeschaltet — per Häkchen „Online-Zahlung über Stripe anbieten“ im Abschnitt Zahlungsmöglichkeiten:

• Terminfreigaben: im Formular der Freigabe bzw. Serie (Terminverwaltung → Terminfreigabe).
• Mitarbeiter-Verfügbarkeiten: im Verfügbarkeits-Formular (Terminverwaltung → Verfügbarkeiten).
• Platzvermietung: im Formular der Platz-Verfügbarkeit (Terminverwaltung → Platzvermietung).

Der Text neben dem Häkchen (Standard: „Stripe (Paypal, SEPA, Kreditkarte)“) erscheint wörtlich in der Zahlungsart-Auswahl des Kunden und kann frei angepasst werden — genau wie die Texte für Barzahlung und Rechnung. Stripe erscheint dem Kunden nur, wenn zusätzlich die Anbindung unter Einstellungen → Stripe aktiv ist.

8. Testbuchung im Testmodus

1. Voraussetzungen: Test-Schlüssel eingetragen, Stripe aktiv, Testmodus an, Webhook (Testmodus) eingerichtet, Stripe-Häkchen an einem Angebot.
2. Als Kunde buchen und auf der Stripe-Seite mit der Testkarte 4242 4242 4242 4242 zahlen (beliebiges zukünftiges Ablaufdatum, beliebige Prüfziffer). Weitere Testkarten: docs.stripe.com/testing.
3. Erwartung: grüne Bestätigung auf der Website; im Admin-Bereich ist die Buchung „gebucht“, die Rechnung erstellt und bezahlt (Zahlungsart „Stripe“) und per E-Mail zugestellt.
4. Gegenprobe: eine Buchung auf der Stripe-Seite abbrechen — der Termin wird nach kurzer Zeit automatisch wieder frei.

9. Livegang

1. Stripe-Konto vollständig verifiziert, Auszahlungskonto hinterlegt.
2. Im Stripe-Dashboard den Testmodus ausschalten und die Live-Schlüssel kopieren.
3. In PetWorkers beide Schlüssel ersetzen, den Webhook im Livemodus neu anlegen und das neue whsec_… eintragen.
4. Stripe Testmodus in PetWorkers auf Nein stellen und Verbindung testen (Meldung: LIVE-Modus).
5. Eine kleine echte Buchung als Schlusstest durchführen (bei Bedarf im Stripe-Dashboard zurückerstatten).

10. Störungen beheben

• Verbindungstest schlägt fehl: Secret Key prüfen (vollständig kopiert? richtiger Modus?). Die Seite benennt Modus-Konflikte ausdrücklich.
• Stripe erscheint dem Kunden nicht: (1) Anbindung aktiv und Schlüssel eingetragen? (2) Häkchen am konkreten Angebot gesetzt?
• Kunde hat gezahlt, Buchung bleibt offen: Im Stripe-Dashboard unter Entwickler → Webhooks die Zustellungen prüfen. Status 400 bedeutet fast immer ein falsches Webhook-Geheimnis; nach der Korrektur lässt sich die Zustellung erneut senden und die Buchung wird nachträglich verbucht.
• Doppelte Meldungen: unkritisch — bereits verarbeitete Zahlungen werden erkannt und nie doppelt verbucht.
• Betragsabweichung: Bei abweichendem Betrag verbucht PetWorkers bewusst nicht automatisch und protokolliert den Vorfall — in diesem Fall den Support kontaktieren.