Zum Hauptinhalt springen
Was this helpful?

Organisations-Abrechnung und Stripe-Einstellungen

Verwende diese Seite, wenn du eine Organisation mit Stripe verbinden, sicherstellen möchtest, dass PrimeCal kostenpflichtige Buchungs-Checkouts erstellen kann, und die Abrechnungsstandards für neue kostenpflichtige Dienste festlegen möchtest.

Zeitaufwand: 10–15 Minuten
Schwierigkeitsgrad: Mittel

Übersicht​

Die Organisations-Abrechnung ist die reine Admin-Schicht hinter kostenpflichtigen Buchungen. Sie steuert:

  • ob die Organisation mit Stripe Connect verbunden ist
  • ob Belastungen und Auszahlungen aktuell nutzbar sind
  • die Standard-Abrechnungswährung für neue kostenpflichtige Ressourcentypen
  • ob zahlungspflichtige Buchungstypen tatsächlich Checkout starten können

PrimeCal fungiert als Plattform. Jede Organisation verbindet ihr eigenes Stripe-Konto und hat eine eigene Auszahlungsbeziehung mit Stripe.

Voraussetzungen​

  • Du musst ein Organisations-Admin sein.
  • Deine Organisation muss bereits existieren und als aktive Organisation ausgewählt sein.
  • Du benötigst ein Stripe-Konto, das das Stripe-Connect-Onboarding abschließen kann.
  • Für lokale oder Staging-Tests sollte deine Umgebung Folgendes definieren:
    • STRIPE_SECRET_KEY
    • STRIPE_WEBHOOK_SECRET
    • FRONTEND_URL
    • BACKEND_URL

Wo du den Abrechnungsbildschirm findest​

PrimeCal zeigt die Abrechnungsoberfläche im Reservierungs-Arbeitsbereich:

  • Hauptroute: /app/reservations/billing
  • Stripe-Rückgaberoute: /settings/billing/stripe
  • Stripe-Aktualisierungsroute: /settings/billing/stripe/refresh

Dieser Bildschirm zeigt:

  • Stripe-Verbindungsstatus
  • Belastungen, Auszahlungen und Onboarding-Bereitschaft
  • die Standard-Abrechnungswährung
  • Aktionen zum Verbinden, Dashboard öffnen und Trennen

Stripe für eine Organisation verbinden​

  1. Wechsle zur richtigen aktiven Organisation.
  2. Öffne die Registerkarte Abrechnung im Reservierungs-Arbeitsbereich.
  3. Überprüfe den aktuellen Stripe-Status:
    • Nicht verbunden
    • Onboarding läuft
    • Verbunden
    • Eingeschränkt
    • Deaktiviert
  4. Wähle Mit Stripe verbinden.
  5. Schließe den von Stripe gehosteten Onboarding-Ablauf ab oder setze ihn fort.
  6. Kehre zu PrimeCal zurück und bestätige, dass der Status aktualisiert wird.

Wenn Stripe erfolgreich verbunden ist, speichert PrimeCal nur sichere Metadaten auf Kontoebene, wie z. B.:

  • stripeAccountId
  • stripeConnectStatus
  • Bereitschaft für Belastungen/Auszahlungen
  • die Standard-Währung der Organisation

PrimeCal speichert keine Rohdaten von Kartennummern, CVC-Werten oder Bankverbindungen.

Abrechnungsstandards konfigurieren​

Im Abschnitt Abrechnungsstandards können Admins die Standard-Dreistellige-Währung für neue kostenpflichtige Ressourcentypen festlegen.

Empfohlener Ablauf:

  1. Prüfe die in der Organisation bereits verwendete Währung.
  2. Gib einen von Stripe unterstützten Code ein, z. B. usd oder eur.
  3. Speichere die Abrechnungseinstellungen.
  4. Öffne einen kostenpflichtigen Ressourcentyp erneut und bestätige, dass die Währung wie erwartet vorausgefüllt ist.

Ressourcentypen können den Standard weiterhin überschreiben, wenn für einen bestimmten Dienst eine gültige Stripe-unterstützte Währung benötigt wird.

Lokalisierte Abrechnungsbezeichnungen​

Der Abrechnungsbildschirm ist jetzt vollständig für die unterstützten App-Sprachen lokalisiert, anstatt übersetzte Inhalte mit fest codierten englischen Texten zu mischen.

Wichtige Beschriftungspaare zur Validierung:

EnglischUngarisch
Billing and StripeSzámlázás és Stripe
Connect with StripeKapcsolódás a Stripe-hoz
Default billing currencyAlapértelmezett számlázási pénznem
Save billing settingsSzámlázási beállítások mentése
Security notesBiztonsági megjegyzések

Stripe trennen​

Das Trennen von Stripe ist ein operativer Stopp-Schalter für neue zahlungspflichtige Buchungen.

Wenn du trennst:

  • löscht PrimeCal die gespeicherte Stripe-Kontenreferenz in der Organisation
  • starten kostenpflichtige öffentliche Buchungsabläufe keinen Checkout mehr
  • verbleiben bestehende Stripe-seitige Datensätze in Stripe für Audits und Support
  • funktionieren kostenlose Buchungen weiterhin normal

Verwende die Trennung, wenn du die Zahlungserfassung pausieren oder die Organisation durch einen neuen Onboarding-Zyklus führen möchtest.

Sicherheit und Compliance​

  • Nur Organisations-Admins können den Stripe-Verbindungsstatus oder Abrechnungsstandards verwalten.
  • Zahlungspflichtige Buchungstypen sollten deaktiviert bleiben, bis Stripe eine nutzbare Verbindung meldet.
  • Kartendaten erreichen niemals PrimeCal-Server; Stripe verwaltet das Checkout-Formular und die Kartenerfassung.
  • PrimeCal setzt weiterhin Organisations-Isolation auf Abrechnungsrouten durch. Das Frontend liest die Organisations-ID aus dem aktuellen Route und dem authentifizierten Kontext, aber das Backend bleibt die einzige Wahrheitsquelle.

Fehlerbehebung​

Der Abrechnungsbildschirm sagt, Stripe ist verbunden, aber kostenpflichtige Buchungen sind weiterhin blockiert​

Öffne den Statusabschnitt und überprüfe:

  • chargesEnabled
  • payoutsEnabled
  • detailsSubmitted
  • currentlyDue
  • disabledReason

Die Organisation kann verbunden aussehen, während Stripe noch zusätzliche Verifizierungen benötigt, bevor Checkout verwendet werden sollte.

Ich sehe die Abrechnungsregisterkarte, kann aber keine Änderungen speichern​

Bestätige, dass deine Organisations-Rolle noch admin ist. Editoren können Ressourcen und Preise verwalten, aber Abrechnungsstandards und Stripe-Lifecycle-Steuerungen bleiben nur für Admins zugänglich.

Das Trennen war erfolgreich, aber alte Reservierungen zeigen noch Stripe-Kennungen​

Das ist beabsichtigt. Das Trennen betrifft zukünftige Zahlungsabläufe. Bestehende Reservierungs-Audit- und Zahlungsreferenzen bleiben für Abstimmung und Support verfügbar.

Screenshot-Ziele​

Verwende diese Dateinamen, damit Benutzerhandbuch, Runbook und Automatisierung aufeinander abgestimmt bleiben.

StatusDateiZweck
Getrenntdocs/assets/user-guide/enterprise-reservation-system/admin-stripe-disconnected-state.pngZeigt den Admin-Ausgangspunkt vor Beginn des Onboardings.
Verbundendocs/assets/user-guide/enterprise-reservation-system/admin-stripe-connected-state.pngZeigt eine gesunde Stripe-Verbindung mit sichtbaren Belastungen und Auszahlungen.
Abrechnungsstandardsdocs/assets/user-guide/enterprise-reservation-system/admin-billing-settings.pngZeigt das Standard-Abrechnungswährungsfeld und die Speicheraktion.

Verbundener Stripe-Abrechnungsstatus

Abrechnungsstandards auf Ungarisch

Die vollständige Aufnahmesequenz findest du unter docs/DEVELOPER-GUIDE/mcp-server/enterprise-reservation-screenshot-runbook.md.

Verwandte Ressourcen​