Aktionscodes und Kautionen

Dieser Leitfaden behandelt zwei der meistgenutzten Anpassungen: Rabattcodes fuer Kunden und erstattbare Kautionen gegen Schaden und Diebstahl.

Aktionscodes

Aktionscodes sind Subaccount-gescopte Rabatte, die Kunden bei Bezahlung eingeben. System validiert, wendet Rabatt an und erhoeht Einloesungszahl atomar.

Aktionscode anlegen

1. Dashboard > Bookings > Aktionscodes.
2. Neuer Aktionscode.
3. Felder:

Rabatt-Typen

• Prozent. "SOMMER25 = 25% Rabatt."
• Fest. "BIKE10 = 10 USD Rabatt."
• Kostenloses Add-on. "GRATISHELM = ein kostenloser Helm."

Feste Rabatte sind auf Zwischensumme begrenzt (kein Negativbetrag). Prozent gilt vor Steuer.

Wie Kunden einloesen

Im Zahlungsschritt: Aktionscode? Link tippen, Code eintippen, Preis aktualisiert live.

Bei ungueltigen / abgelaufenen / aufgebrauchten Codes: "Dieser Code ist nicht gueltig" ohne weitere Details (gegen Code-Guessing).

Missbrauchspraevention

Endpoint ist IP- und E-Mail-rate-limited. 5 ungueltige Versuche -> Cooldown.

Bei Code-Leak: Aktiv = nein. Bereits bestaetigte Buchungen behalten Rabatt, neue koennen ihn nicht mehr nutzen.

Reporting

Pro Code: Einloesungen, gewaehrter Rabatt, daran haengender Buchungs-Umsatz, Buchungsliste.

Erstattbare Kautionen

Kautionen schuetzen vor Schaden und Diebstahl. Werden gehalten (nicht verrechnet) via Stripe Pre-Auth und nach sauberer Rueckgabe freigegeben.

Wann Kaution nutzen

Nutzen:

• Hochpreisige Flotte (1,500+ USD Retail).
• Frueherer Schaden / "Diebstahl" als Kosten verbucht.
• Kunden koennten Stadt/Land verlassen.
• Unverifizierte Erstkunden.

Ueberspringen:

• Low-Cost Flotte (unter 500 USD), Schaden als Kosten.
• Stammkunden vertraut.
• Friction wuerde Conversion zerstoeren.

Kautions-Defaults

1. Dashboard > Bookings > Widgets > {Widget}.
2. Kautions-Defaults.
3. Setzen:
   • Kautionsbetrag (Cent) - z.B. 20000 fuer 200 USD.
   • Capture-Fenster - wie lange Stripe haelt (Standard 7 Tage, max 7).
   • Auto-Release bei sauberer Rueckgabe - ja standardmaessig.

Pro-Modell-Ueberschreibung in Dashboard > Fahrzeuge > Modelle > {Modell} > Kaution.

Was der Kunde sieht

Mietsumme: 80,00 USD
Erstattbare Kaution: 200,00 USD (freigegeben innerhalb 7 Tage)
Gesamt autorisiert: 280,00 USD

Stripe zieht 80 USD ein und pre-autorisiert 200 USD. Auf Karten-Auszug erscheint Pending 280 USD, faellt auf 80 USD nach Release.

Kaution freigeben

Auf iPad POS bei Rueckgabe: Kaution freigeben. Pre-Auth wird storniert, Hold verschwindet, deposit_status = released.

Auch im Web-Dashboard moeglich.

Kaution einziehen (bei Schaden)

1. Reservierung oeffnen.
2. Kaution einziehen > Voll oder Teilweise.
3. Betrag eingeben (<= Original-Kaution).
4. Grund + Fotos.
5. Bestaetigen.

Stripe zieht angegebenen Betrag ein. Rest wird freigegeben. Einzug ist separate deposit_capture Transaktion - nicht mit Miete vermischt.

Automatischer Release

Ohne manuelle Aktion: Stripe gibt nach Ablauf des Capture-Fensters (Default 7 Tage) automatisch frei. Halten Sie Customer-Hold kurz - selber-Tag-Release bei sauberer Rueckgabe.

Erstattungen mit Kautionen

Bei Storno vor Abholung:

• Miete wird nach Policy erstattet.
• Kautions-Pre-Auth sofort freigegeben.

Bei Disput nach Capture: Standard Stripe-Dispute-Flow.

Aktionscodes + Kautionen kombiniert

Aktionscodes gelten nur fuer Miet-Zwischensumme - nicht fuer Kaution. 80 USD Miete + 200 USD Kaution + SOMMER25 = 60 USD Miete + 200 USD Pre-Auth.

Immer ueber die Reservierung erstatten

Die wichtigste Regel in Levy Bookings: immer ueber Reservierung erstatten, niemals direkt aufs Wallet.

Wenn Kunde ueberzahlt hat:

• Erstatten auf Reservierungsdetail (Web/iPad).
• Tarif anpassen fuer Preisreduktion.

Niemals:

• Direkt customers.wallet_balance aktualisieren.
• Direkt in wallet_transactions einfuegen.
• Wallet-Credit-Helper ausserhalb des Refund-Flows aufrufen.

Reservierung ist Source of Truth fuer Nettoumsatz, Steuerabfuehrung und Partner-Auszahlungen. Wallet-Direkt-Credit korrumpiert alle drei.

Verwandte Anleitungen

• Gehostete Buchungsseite
• Widget einbetten
• Fehlerbehebung