Zahlungen (Stripe)
Auf dieser Seite (Agenten-Menü → "Zahlungen") verbinden Sie Ihr Geschäft mit Stripe, damit Ihr Agent Anzahlungen und Zahlungen für Termine und Bestellungen direkt einziehen kann. Das Geld fließt dabei direkt auf Ihr eigenes Stripe-Konto — Prezio hält Ihre Einnahmen zu keinem Zeitpunkt und sieht Ihre Stripe-Schlüssel nicht. Die Anbindung läuft über Stripe Connect Express: Sie erledigen die Verifizierung (KYC) bequem über eine von Stripe gehostete Seite.
Wichtig zum Verständnis: Diese Seite richtet nur die Anbindung ein (Konto verbinden + Zahlungen grundsätzlich erlauben). Wie viel und wann kassiert wird (Anzahlung in Prozent, Zahlmodus, MwSt, Trinkgeld), legen Sie pro Leistung im Leistungs-/Service-Editor fest — siehe Abschnitt Buchungen/Leistungen. Beides muss zusammenpassen, sonst zeigt das Buchungs-Widget keinen Zahlungsschritt.
So richten Sie Zahlungen ein
Schritt 1: Zahlungen für diesen Agenten aktivieren.
Ganz oben finden Sie die Karte "Zahlungen annehmen" mit dem Schalter "Zahlungen aktiviert" (payments_enabled).
- Was er bewirkt: Der Hauptschalter. Ist er aktiv, darf der Agent in Gesprächen und auf den Verwaltungsseiten zur Zahlung auffordern und das Buchungs-Widget blendet den Zahlungsschritt ein. Ist er aus, wird der Zahlungsschritt übersprungen — selbst wenn eine Leistung eine Anzahlung (
deposit_percent > 0) hinterlegt hat. - Standard: Aus (deaktiviert).
- Empfehlung: Erst einschalten, nachdem Stripe verbunden und freigeschaltet ist. Den Schalter vorher umzulegen schadet nicht — solange das Stripe-Konto noch nicht zahlungsbereit ist, fällt die Buchung automatisch auf den Ablauf ohne Zahlung zurück.
Schritt 2: Stripe verbinden. Solange noch kein Konto verbunden ist, sehen Sie die Karte "Stripe verbinden" mit dem Button "Stripe verbinden".
- Ein Klick startet das Onboarding: Sie werden auf eine von Stripe gehostete Seite weitergeleitet, wo Sie Ihre Geschäfts- und Bankdaten hinterlegen und die Identitätsprüfung (KYC) durchlaufen.
- Land und Währung werden automatisch abgeleitet — und zwar aus dem Länderkürzel in Ihrem Firmenprofil (
CompanyProfile.country_code): - Deutschland (DE): Land
DE, Währung EUR, MwSt-Standard 19 %. - Großbritannien (GB): Land
GB, Währung GBP, VAT-Standard 20 %. - Ist kein Land hinterlegt, gilt das EU-/DE-Profil (EUR) als Rückfall.
- Stolperstein — nicht änderbar: Stripe fixiert Land und Währung bei der Konto-Erstellung dauerhaft. Sie lassen sich nachträglich nicht mehr umstellen. Prüfen Sie daher vor dem Verbinden, dass das Land in Ihrem Firmenprofil stimmt.
- Der Onboarding-Link ist einmalig gültig und läuft nach ca. 5 Minuten ab. Klicken Sie ihn also zeitnah an. Brechen Sie ab oder läuft der Link ab, klicken Sie einfach erneut — es wird kein zweites Stripe-Konto angelegt, Sie setzen am selben Konto fort.
Schritt 3: Onboarding abschließen. Haben Sie das Konto verbunden, aber die Prüfung noch nicht beendet, erscheint die Karte "Stripe-Onboarding abschließen".
- Darunter listet Prezio die noch offenen Anforderungen ("requirements_currently_due") auf, die Stripe von Ihnen verlangt (z. B. Ausweisdokument, Bankverbindung, Steuerangaben).
- Button "Onboarding fortsetzen": Bringt Sie zurück auf die Stripe-Seite, um die offenen Punkte zu erledigen.
- Button "Status aktualisieren": Holt den aktuellen Stand direkt von Stripe. Nutzen Sie ihn, wenn Sie gerade fertig geworden sind und nicht warten möchten — normalerweise aktualisiert sich der Status nach Ihrer Rückkehr von Stripe automatisch.
Schritt 4: Zahlungsbereitschaft prüfen. Sobald Stripe Sie freigeschaltet hat, erscheint die Karte "Zahlungen aktiv" mit Status-Plaketten:
- "Zahlungen aktiviert" (grün): Ihr Konto kann jetzt Zahlungen annehmen (
charges_enabled). Erst ab diesem Zustand zeigt das Buchungs-Widget den Zahlungsschritt. - "Auszahlungen aktiviert" (grün) bzw. "Auszahlungen ausstehend" (grau): Zeigt, ob Stripe Auszahlungen auf Ihr Bankkonto bereits freigegeben hat (
payouts_enabled). Ist hier noch "ausstehend", können Sie zwar schon kassieren, aber die Auszahlung steht noch aus — meist fehlt nur eine letzte Verifizierung bei Stripe. - "Standardwährung": Zeigt die fixierte Kontowährung (z. B. EUR oder GBP).
- Button "Stripe-Dashboard öffnen": Öffnet in einem neuen Tab Ihr persönliches Stripe-Express-Dashboard (Auszahlungen, Steuern, Bankdaten, Streitfälle). Der Zugang läuft über eine kurzlebige, von Stripe gehostete Seite — Sie sehen nie API-Schlüssel. Verfügbar erst, wenn das Onboarding abgeschlossen ist.
- Button "Status aktualisieren": Wie oben, holt den Live-Stand von Stripe.
Wann Anzahlungen / Belastungen tatsächlich greifen
Ein Zahlungsschritt erscheint im Buchungs-Widget nur, wenn alle dieser Bedingungen erfüllt sind (sonst bucht der Kunde ganz normal ohne Zahlung):
- der Schalter "Zahlungen aktiviert" am Agenten ist an, und
- Ihr Stripe-Konto ist zahlungsbereit ("Zahlungen aktiviert"-Plakette grün), und
- die gewählte Leistung hat einen Preis (
price_cents > 0) und eine Anzahlung > 0 % (deposit_percent, Standard 0 = keine Anzahlung).
Pro Leistung legen Sie im Service-Editor außerdem den Zahlmodus (payment_mode, Standard deposit) fest — das steuert, was genau passiert:
deposit(Anzahlung, Standard): Es werdenPreis × Anzahlung-%bei der Buchung eingezogen, der Rest läuft offline vor Ort.full(Vollvorkasse): Der gesamte Preis wird bei der Buchung belastet (z. B. Kurse, Events).auth_only(reine Autorisierung): Die Karte wird bei der Buchung nur vorgemerkt, aber nicht belastet. Eingezogen wird erst manuell (z. B. als No-Show-Gebühr) — sonst gibt Stripe die Vormerkung nach 7 Tagen automatisch frei.split(Anzahlung + Restbetrag): Anzahlung bei der Buchung, Restbetrag automatisch einige Stunden vor dem Termin über die gespeicherte Karte. Erfordert, dass der Kunde bei der Buchung seine Karte speichert.
Ergänzend pro Leistung: MwSt-Satz (tax_rate_percent, je nach Land vorbelegt: 19 % DE / 20 % GB), ob der Preis inkl. oder zzgl. Steuer ausgewiesen wird (price_includes_tax, Standard inklusive — EU-Vorgabe für Verbraucherpreise), und optionales Trinkgeld (allow_tip, Standard aus; Vorschläge standardmäßig 10/15/20 %). Anzahlungsbeträge werden immer kaufmännisch zugunsten des Kunden abgerundet (nie aufgerundet).
Letzte Zahlungen & Erstattungen
Sobald Ihr Konto zahlungsbereit ist, erscheint die Karte "Letzte Zahlungen" mit einer Tabelle (Spalten Datum, Betrag, Status, Methode, bis zu 50 Einträge):
- Status: z. B.
succeeded(erfolgreich, grün),failed/canceled(rot), Übrige grau. - Methode: Zahlart (z. B. Karte, Apple Pay) — sofern von Stripe gemeldet.
- Betrag: Bei (Teil-)Erstattungen wird hinter dem Betrag ergänzt, wie viel bereits erstattet wurde, z. B. "(€9,00 erstattet)".
- Button "Erstatten": Erscheint nur bei erfolgreichen Zahlungen, die noch nicht vollständig erstattet sind. Ein Klick erstattet standardmäßig den kompletten Restbetrag zurück auf die Kundenkarte.
Hinweis zur Staffel-Erstattung: Bei Storno durch den Kunden greift Ihre automatische Erstattungsregel (Agenten-Einstellungen
refund_window_hours, Standard 24 Stunden, bzw. die feinere Staffelrefund_tiers). Der manuelle "Erstatten"-Button hier ignoriert dieses Zeitfenster bewusst — Sie als Inhaber/Personal dürfen jederzeit eine Kulanz-Erstattung auslösen.
Tipps & Stolpersteine
- Reihenfolge zählt: Erst Stripe verbinden und freischalten lassen, dann den Schalter "Zahlungen aktiviert" umlegen. Andernfalls bleibt der Zahlungsschritt einfach aus, bis das Konto bereit ist.
- Land/Währung ist endgültig: Stripe fixiert beides beim Anlegen. Falsches Land im Firmenprofil = falsches Stripe-Konto, das sich nur durch ein komplett neues Konto korrigieren lässt. Vorher prüfen.
- Onboarding-Link verfällt schnell (~5 Min.). Läuft er ab: einfach den Button erneut klicken — es entsteht kein doppeltes Konto.
- "Zahlungen aktiviert" an, aber kein Zahlungsschritt? Häufigste Ursachen: das Stripe-Konto ist noch nicht "Zahlungen aktiviert" (grün), die Leistung hat keinen Preis, oder die Anzahlung steht auf 0 %. Alle drei müssen passen.
refund_window_hours = 0bedeutet "nie automatisch erstatten" (Anzahlung bei jedem Storno verfallen) — nicht "immer erstatten". Wer grundsätzlich erstatten will, trägt einen sehr großen Wert ein (z. B. 99999). Diese Verwechslung hat schon Geld gekostet.split-Modus braucht eine gespeicherte Karte: Ohne gespeicherte Kundenkarte kann der Restbetrag nicht automatisch eingezogen werden. Stellen Sie sicher, dass die Karten-Speicherung im Buchungsablauf aktiv ist.- Status hängt? Direkt nach dem Onboarding aktualisiert sich der Status meist automatisch; falls nicht, hilft der Button "Status aktualisieren". Stripe meldet Änderungen sonst zeitversetzt über Hintergrund-Benachrichtigungen.
- Stripe-Gebühren werden von Stripe prozentual aus den abgewickelten Beträgen einbehalten und tauchen daher nicht in Prezios Kosten-/Verbrauchsberichten auf — Sie finden sie in Ihrem Stripe-Dashboard unter den Saldo-/Umsatzberichten.