Billing, Workspace und Admin: Stripe-Setup, Pläne und Zugriffskontrollen
Stripe verbinden, Abonnementplan verwalten und Workspace-Berechtigungen konfigurieren. Das Stripe-Setup ist Pflicht, bevor Execution- und Zahlungsflow funktioniert.
High-Level-Seite, die Struktur und Entscheidungsgrenzen erklärt.
In diesem Guide
Ownership und Review-Disziplin
Änderungssignale im Blick behalten
- send modal behavior changes
- buyer signing flow updates
- deal room experience changes
- plan architecture updates
- workspace permissions changes
- billing and subscription policy updates
Operator-Guidance
Was das in QuoterAgent bedeutet
Nutzen Sie diesen Guide als operative Referenz für Billing, Workspace und Admin: Stripe-Setup, Pläne und Zugriffskontrollen. Er erklärt, welche Fläche hier gesteuert wird, woran gute Ausführung erkennbar ist und welche Teams diese Inhalte dauerhaft belastbar halten müssen.
- Dieser Guide deckt die drei administrativen Bereiche ab, die den Betrieb von QuoterAgent beeinflussen: Stripe-Zahlungsintegration, QuoterAgent-Abonnementplan und Workspace-Zugriffskontrollen. Das Stripe-Setup ist dabei am kritischsten — ohne es kann das Execution-Panel zwar Payment-Sessions erstellen, aber Clients erhalten keine Checkout-Links und Zahlungen werden nicht bestätigt.
- Der Stripe-Webhook ist der Mechanismus, der Zahlungen in QuoterAgent bestätigt. Wenn ein Client den Checkout abschließt, sendet Stripe ein 'checkout.session.completed'-Ereignis an den Webhook-Endpoint. Ist dieser Endpoint nicht konfiguriert oder aktiv, bleibt der Zahlungsstatus in QuoterAgent unbegrenzt auf 'pending' — das Aktivierungs-Gate öffnet sich nicht und das Projekt kann nicht fortschreiten. Dies ist der häufigste Setup-Fehler bei neuen Nutzern.
- Primäre Owner für diesen Bereich sind aktuell: Support.
Was zu tun ist
Behandeln Sie diesen Guide als Arbeitscheckliste, nicht als Hintergrundtext. Nutzen Sie ihn, bevor Einstellungen geändert, externe Inhalte veröffentlicht oder Aufgaben an andere Operatoren übergeben werden.
- Den Stripe-Verbindungsschritt vor dem ersten Angebots-Versand durchführen — er kann nicht abgeschlossen werden, nachdem ein Client bereits unterzeichnet hat. Zu diesem Guide zurückkehren bei Stripe-Konto-Wechsel, Plan-Upgrade oder Hinzufügen von Teammitgliedern.
- Wenn Stripe noch nicht verbunden ist, jetzt tun — vor dem Erstellen oder Versenden von Angeboten. Die Verbindung dauert zwei Minuten in Einstellungen → Integrationen. Nach der Verbindung ein Test-Webhook-Ereignis vom Stripe-Dashboard senden, um zu bestätigen, dass der Endpoint Ereignisse korrekt empfängt.
- Zu Einstellungen → Integrationen → Stripe → Konto verbinden gehen. Die nach der Verbindung angezeigte Webhook-URL kopieren.
- Im Stripe-Dashboard zu Entwickler → Webhooks → Endpoint hinzufügen gehen. QuoterAgent-Webhook-URL einfügen und 'checkout.session.completed' abonnieren.
Wo das im Workflow auftaucht
Dieser Guide ist am wichtigsten, wenn Arbeit zwischen Setup, Authoring, buyer-facing Zustellung und Post-Sign-Execution wechselt. Folgen Sie den verlinkten Guides, damit nicht nur eine einzelne Fläche isoliert optimiert wird.
- Die Stripe-Integration speist direkt das Execution-Panel. Wenn eine Kickoff- oder Abschlusszahlung initiiert wird, erstellt QuoterAgent eine Stripe-Checkout-Session über das verbundene Konto. Die Zahlungsbestätigung erfolgt per Webhook, nicht per Redirect-URL — selbst wenn ein Client den Browser nach der Zahlung schließt, kommt die Bestätigung per Webhook, solange der Endpoint aktiv ist.
- Prüfen Sie den verwandten Guide "Erste Schritte: Workspace-Setup und erste Zahlung", wenn dieser Schritt von einer anderen Fläche abhängt.
- Prüfen Sie den verwandten Guide "Sending und Signing: buyer-facing Flow und Acceptance-Vertrauen", wenn dieser Schritt von einer anderen Fläche abhängt.
Häufige Fehlerbilder und Risiken
Die meisten Qualitätsprobleme hier entstehen durch Drift: veraltetes Setup, schwache kommerzielle Grenzen oder Teams, die den Review-Moment vor customer-visible Zustellung überspringen. Diese Signale helfen, Probleme vor dem Buyer zu erkennen.
- send modal behavior changes
- buyer signing flow updates
- deal room experience changes
- Webhook-URL: die QuoterAgent-Webhook-URL wird in Einstellungen → Integrationen → Stripe nach der Kontoverbindung angezeigt.
- Benötigtes Stripe-Ereignis: mindestens 'checkout.session.completed' abonnieren. Ohne dies funktioniert die Zahlungsbestätigung nicht.
Was das ist
Dieser Guide deckt die drei administrativen Bereiche ab, die den Betrieb von QuoterAgent beeinflussen: Stripe-Zahlungsintegration, QuoterAgent-Abonnementplan und Workspace-Zugriffskontrollen. Das Stripe-Setup ist dabei am kritischsten — ohne es kann das Execution-Panel zwar Payment-Sessions erstellen, aber Clients erhalten keine Checkout-Links und Zahlungen werden nicht bestätigt.
- Stripe-Integration: Stripe-Konto verbinden und Webhook-Endpoint in Einstellungen → Integrationen konfigurieren.
- Abonnementplan: steuert verfügbare Funktionen, einschließlich Execution-Panel-Zugang und Angebots-Volumenlimits.
- Workspace-Zugang: verwalten, wer Angebote erstellen und versenden, wer auf das Execution-Panel zugreifen und wer Admin-Rechte haben kann.
Wann einsetzen
Den Stripe-Verbindungsschritt vor dem ersten Angebots-Versand durchführen — er kann nicht abgeschlossen werden, nachdem ein Client bereits unterzeichnet hat. Zu diesem Guide zurückkehren bei Stripe-Konto-Wechsel, Plan-Upgrade oder Hinzufügen von Teammitgliedern.
- Vor dem ersten Angebots-Versand: Stripe verbinden und Webhook verifizieren.
- Wenn eine Zahlung in 'pending' feststeckt: Stripe-Webhook-Konfiguration neu prüfen.
- Beim Hinzufügen eines Teammitglieds: Rolle zuweisen, bevor es versucht, Angebote zu versenden oder auszuführen.
Warum es wichtig ist
Der Stripe-Webhook ist der Mechanismus, der Zahlungen in QuoterAgent bestätigt. Wenn ein Client den Checkout abschließt, sendet Stripe ein 'checkout.session.completed'-Ereignis an den Webhook-Endpoint. Ist dieser Endpoint nicht konfiguriert oder aktiv, bleibt der Zahlungsstatus in QuoterAgent unbegrenzt auf 'pending' — das Aktivierungs-Gate öffnet sich nicht und das Projekt kann nicht fortschreiten. Dies ist der häufigste Setup-Fehler bei neuen Nutzern.
- Webhook-URL: die QuoterAgent-Webhook-URL wird in Einstellungen → Integrationen → Stripe nach der Kontoverbindung angezeigt.
- Benötigtes Stripe-Ereignis: mindestens 'checkout.session.completed' abonnieren. Ohne dies funktioniert die Zahlungsbestätigung nicht.
- Test- vs. Live-Modus: Stripe hat separate Webhook-Endpoints für Test- und Live-Modus. Sicherstellen, dass die QuoterAgent-Umgebung dem Stripe-Modus entspricht.
Wie es verbunden ist
Die Stripe-Integration speist direkt das Execution-Panel. Wenn eine Kickoff- oder Abschlusszahlung initiiert wird, erstellt QuoterAgent eine Stripe-Checkout-Session über das verbundene Konto. Die Zahlungsbestätigung erfolgt per Webhook, nicht per Redirect-URL — selbst wenn ein Client den Browser nach der Zahlung schließt, kommt die Bestätigung per Webhook, solange der Endpoint aktiv ist.
- Stripe-Konto → Execution-Panel → Checkout-Session → Client zahlt → Webhook bestätigt → Status aktualisiert → Aktivierungs-Gate öffnet.
- Plan-Stufe → steuert Execution-Panel-Verfügbarkeit und Angebots-Sendelimits.
- Workspace-Rollen → bestimmen, wer auf das Execution-Panel zugreifen und Zahlungen initiieren kann.
Nächste Schritte
Wenn Stripe noch nicht verbunden ist, jetzt tun — vor dem Erstellen oder Versenden von Angeboten. Die Verbindung dauert zwei Minuten in Einstellungen → Integrationen. Nach der Verbindung ein Test-Webhook-Ereignis vom Stripe-Dashboard senden, um zu bestätigen, dass der Endpoint Ereignisse korrekt empfängt.
- Zu Einstellungen → Integrationen → Stripe → Konto verbinden gehen. Die nach der Verbindung angezeigte Webhook-URL kopieren.
- Im Stripe-Dashboard zu Entwickler → Webhooks → Endpoint hinzufügen gehen. QuoterAgent-Webhook-URL einfügen und 'checkout.session.completed' abonnieren.
- Ein Test-Ereignis vom Stripe-Webhook-Dashboard senden und bestätigen, dass das QuoterAgent-Execution-Panel das Ereignis widerspiegelt.
Verwandte Guides
Erste Schritte: Workspace-Setup und erste Zahlung
QuoterAgent so einrichten, dass Ihr Team vom Start zum ersten Angebot — und zur ersten Zahlung — mit Klarheit kommt.
Guide öffnen
Sending und Signing: buyer-facing Flow und Acceptance-Vertrauen
Publish, Teilen und Acceptance steuern, damit Buyer-Experience klar bleibt und Lifecycle-Grenzen intakt bleiben.
Guide öffnen
Referenz und Glossar: kanonische Proposal- und Workflow-Terminologie
Gemeinsame Definitionen für Scope, Pricing, Lifecycle und buyer-facing Operations in QuoterAgent.
Guide öffnen
