Kostenpflichtige Buchungen
Kostenpflichtige Buchungen ermöglichen es einer Organisation, für eine Dienstleistung zu berechnen, bevor PrimeCal die Reservierung bestätigt. Die Preisregeln liegen im Ressourcentyp, während die eigentliche Zahlungsabwicklung vom Abrechnungsstatus der Organisation abhängt.
Zeitaufwand: 10–15 Minuten
Schwierigkeitsgrad: Mittel
Übersicht
PrimeCal trennt Preisgestaltung von der Zahlungsausführung:
- Der Ressourcentyp entscheidet, ob die Preisgestaltung sichtbar ist und ob eine Zahlung erforderlich ist.
- Die Organisations-Abrechnung entscheidet, ob Stripe Checkout überhaupt laufen kann.
- Der Reservierungsstatus entscheidet, ob die Buchung bereits bestätigt ist oder noch auf Zahlung wartet.
Dadurch bleibt die Zahlungslogik mandantensicher und verhindert, dass Clients einen eigenen Betrag oder eine eigene Währung angeben.
Vor der Aktivierung kostenpflichtiger Dienste
Bestätige alle folgenden Punkte:
- Die richtige Organisation ist aktiv.
- Stripe ist verbunden und auf dem Abrechnungsbildschirm nutzbar.
- Die Standard-Abrechnungswährung der Organisation ist korrekt.
- Der Ressourcentyp hat echte Preisdaten:
pricingEnabledpriceAmountpriceCurrencypaymentRequired
Einen kostenpflichtigen Buchungstyp aktivieren
- Öffne den Reservierungs-Arbeitsbereich für die aktive Organisation.
- Gehe zur Registerkarte Ressourcentypen.
- Erstelle oder bearbeite den Ziel-Ressourcentyp.
- Aktiviere Preisgestaltung aktiviert.
- Gib den Betrag in Kleinsteinheiten ein:
2500bedeutet25,009900bedeutet99,00
- Bestätige die Währung.
- Aktiviere Zahlung vor Bestätigung erforderlich, wenn die Reservierung auf den Stripe-Erfolg warten soll.
- Speichere den Ressourcentyp.
Wenn Stripe verbunden ist, zeigt das Formular eine positive Bereitschaftsmeldung. Wenn Stripe nicht verfügbar ist, warnt das Formular den Admin, bevor er sich auf die zahlungspflichtige Bestätigung verlässt.
Übersetzungsprüfungen für kostenpflichtige Dienste
Verwende diese Beschriftungspaare als schnelle QA-Liste, wenn du den Preiseditor und die öffentliche Buchungsseite validierst:
| Englisch | Ungarisch |
|---|---|
Pricing enabled | Árazás engedélyezve |
Payment required | Fizetés szükséges |
Continue to payment | Tovább a fizetéshez |
Complete secure payment | Biztonságos fizetés befejezése |
Payment unavailable | A fizetés nem érhető el |
Was zum Buchungszeitpunkt passiert
Kostenloser oder optionaler Zahlungsdienst
- PrimeCal erstellt die Reservierung sofort.
- Die Reservierung kann direkt zu
confirmedwechseln. - Kein Stripe-Checkout-Schritt ist erforderlich.
Zahlungspflichtiger Dienst mit verfügbarem Stripe
- PrimeCal prüft die Ressourcentyp-Preisgestaltung.
- PrimeCal berechnet das Angebot serverseitig aus:
- Ressourcentyp-Preis
- Anzahl der zugewiesenen Ressourcen
- Reservierungsdauer
- ausgewählte Währung
- PrimeCal erstellt die Reservierung im Status
pending_payment. - PrimeCal erstellt eine Stripe-Checkout-Sitzung für das verbundene Konto der Organisation.
- Der Kunde sieht einen Zahlungsschritt in PrimeCal und wechselt dann zu Stripe.
- Stripe leitet den Kunden zurück zu PrimeCal weiter.
- PrimeCal wartet auf den Stripe-Webhook, um die Reservierung als
confirmedzu markieren.
Nach der Bestätigung kann PrimeCal außerdem ein Kundenkonto aus den Zahlungsdaten auflösen oder erstellen, sodass die Bestätigungsseite eine sichere Kalenderaktion anbieten und spätere Buchungsformulare bekannte Kundendaten vorausfüllen können.
Zahlungspflichtiger Dienst ohne verfügbares Stripe
- PrimeCal sollte keinen funktionierenden zahlungspflichtigen Buchungsablauf anbieten.
- Die öffentliche Buchungsseite zeigt eine klare Warnung und deaktiviert die checkout-gesteuerte Bestätigung.
- Das Backend verweigert den Ablauf weiterhin, sodass der Client die Abrechnungsanforderung nicht umgehen kann.
Kundenerfahrung
Der öffentliche Buchungsablauf für zahlungspflichtige Dienste ist:
- Dienst und Ressource wählen
- Slot wählen
- Daten eingeben
- Zahlungsschritt überprüfen
- Zu Stripe Checkout wechseln
- Zu PrimeCal zurückkehren
- Buchungsbestätigung nach erfolgreicher Zahlung sehen
Wenn der Kunde Checkout schließt oder die Zahlung fehlschlägt, kann PrimeCal die Reservierung in einem wiederholbaren pending_payment-Status belassen, anstatt so zu tun, als wäre sie bestätigt.
Für die detaillierte Post-Zahlungs-Erfahrung, einschließlich automatisch erstellter Kunden, Passwort-Setup-Anleitung und Bestätigungsseiten-Schaltflächen, sieh dir Was passiert, nachdem ich für eine Reservierung bezahlt habe? an.
Sicherheit und Compliance
- Preis und Währung kommen vom Server, nicht allein aus browserseitig berechneten Werten.
- PrimeCal speichert Angebots-Snapshots und Stripe-Kennungen, keine Rohdaten von Karten.
- Die zahlungspflichtige Bestätigung hängt vom Webhook-Signal ab, nicht allein von der Browser-Weiterleitung.
- Der Abrechnungsstatus der Organisation ist pro Organisation isoliert, sodass ein Mandant nicht über das Stripe-Konto eines anderen Mandanten belasten kann.
Fehlerbehebung
Der Buchungstyp ist als kostenpflichtig markiert, aber die Buchungsseite sagt, dass die Zahlung nicht verfügbar ist
Überprüfe zunächst den Abrechnungsstatus der Organisation. Ein zahlungspflichtiger Ressourcentyp kann den Ablauf nicht abschließen, wenn das Stripe-Konto getrennt, eingeschränkt oder noch ohne vollständige Onboarding-Daten ist.
Der Kunde hat bezahlt, aber die Buchung zeigt noch ausstehende Zahlung
Überprüfe den Stripe-Webhook-Pfad und die Protokolle. PrimeCal bestätigt kostenpflichtige Buchungen über Webhook-Ereignisse, sodass verzögerte Webhook-Zustellung die endgültige Reservierungsstate verzögern kann.
Der Preis auf der öffentlichen Seite ist falsch
Aktualisiere den Ressourcentyp. Öffentliche Buchungspreisbeschriftungen und gespeicherte Angebotswerte kommen aus den Preisfeldern des Ressourcentyps, nicht aus kundenspezifischen Überschreibungen.
Screenshot-Ziele
| Status | Datei | Zweck |
|---|---|---|
| Kostenpflichtiger Ressourcentyp-Editor | docs/assets/user-guide/enterprise-reservation-system/admin-resource-type-pricing.png | Zeigt Preisgestaltung aktiviert, Betrag, Währung und Zahlungspflicht-Steuerungen zusammen. |
| Öffentlicher Zahlungsschritt | docs/assets/user-guide/enterprise-reservation-system/customer-payment-pending-step.png | Zeigt die Buchungszusammenfassung und die Aktion „Weiter zur Zahlung" vor dem Stripe-Öffnen. |
| Checkout-Weiterleitung | docs/assets/user-guide/enterprise-reservation-system/customer-stripe-checkout-redirect.png | Zeigt die Übergabe von PrimeCal zu Stripe Checkout. |
| Zahlungsbestätigung | docs/assets/user-guide/enterprise-reservation-system/customer-payment-confirmation-actions.png | Zeigt den bestätigten Status mit beiden Post-Zahlungs-Aktionen sichtbar. |
| Vorausgefüllte nächste Buchung | docs/assets/user-guide/enterprise-reservation-system/customer-prefilled-booking-form.png | Zeigt, wie bekannte Kundendaten im nächsten Buchungsformular zurückkehren. |

