Fahrtpakete

Fahrtpakete sind einmalige vorausbezahlte Bundles, die Kunden Fahrtguthaben einschliesslich Zeit, Entsperrungen und Strecke bieten. Im Gegensatz zu Abonnements, die automatisch verlaengert werden, werden Fahrtpakete einmal gekauft und bis zur Erschoepfung verbraucht.

Ueberblick

Fahrtpakete ermoeglichen es Kunden, im Voraus fuer ein Bundle von Fahrtguthaben zu zahlen, das sie ueber eine oder mehrere Fahrten nutzen koennen. Dies ist ideal fuer Gelegenheitsfahrer, die aus Bequemlichkeit vorausbezahlen oder im Vergleich zur Einzelfahrt-Abrechnung sparen moechten.

Hauptfunktionen

• Einmalkauf - Keine wiederkehrenden Kosten oder Auto-Verlaengerung
• Flexibler Verbrauch - Guthaben ueber mehrere Fahrten bis zur Erschoepfung nutzen
• Enthaltene Zeit - Enthaltene Fahrtminuten (konfigurierbare Einheiten: Minuten, Stunden, Tage)
• Gratis-Entsperrungen - Optionaler Entsperrgebuehr-Erlass
• Streckenkontingent - Optionale enthaltene Kilometer
• Pausenminuten - Optionale enthaltene Pausenzeit
• Gruppenfahrt-Unterstuetzung - Pakete koennen mehrere Fahrer unterstuetzen (max_riders)
• Standort-Einschraenkung - Pakete koennen standortspezifisch oder global sein
• Guthaben- oder Kartenzahlung - Kunden koennen vom Guthaben oder per Kreditkarte zahlen

Fahrtpakete vs. Abonnements

Zugang zu Fahrtpaketen

Paketkonfiguration

Basisinformationen

Titel (i18n)

Der Anzeigename fuer Kunden, mit Uebersetzungen fuer mehrere Sprachen.

Best Practices:

• Hauptvorteil (Zeit/Entsperrungen) im Titel enthalten
• Titel kurz halten (2-4 Woerter)
• Konsistente Benennung ueber Pakete hinweg

Beschreibung (i18n)

Optionale erweiterte Beschreibung der Paketvorteile.

Schrittnummer

Kontrolliert die Anzeigereihenfolge in der mobilen App.

Niedrigere Zahlen erscheinen zuerst. Heben Sie Ihre Pakete mit dem besten Wert oder beliebtesten zuerst hervor.

Preisgestaltung

Preis (Cent)

Der Betrag, den Kunden fuer das Paket zahlen, in Cent gespeichert.

Preis-Tipps:

• Ersparnis gegenueber Einzelfahrt-Zahlung berechnen
• Klares Wertversprechen bieten
• Psychologische Preispunkte beruecksichtigen ($X,99)

Enthaltene Vorteile

Enthaltene Zeit

Der Hauptvorteil - enthaltene Fahrzeit im Paket.

Beispiele:

• 60 Minuten = 1 Stunde Fahrt
• 2 Stunden = 120 Minuten Fahrt
• 1 Tag = 24 Stunden Fahrt

Entsperrgebuehr enthalten

Ob das Paket die Entsperrgebuehr abdeckt.

Wenn aktiviert, bestimmt das max_riders-Feld, wie viele Gratis-Entsperrungen enthalten sind.

Enthaltene Strecke (Optional)

Im Paket enthaltene Kilometer.

Enthaltene Pausenminuten (Optional)

Enthaltene Minuten pausierter Zeit.

Gruppenfahrt-Unterstuetzung

Max. Fahrer

Anzahl gleichzeitiger Fahrer, die das Paket unterstuetzt.

Visuelle Anpassung

Badge-Text

Optionaler Badge zur Hervorhebung des Pakets.

Symbol

Optionale Symbol-Kennung fuer das Paket.

Ist beliebt

Flag zur Kennzeichnung als beliebte Wahl, kann Anzeigestil beeinflussen.

Geschwindigkeitslimits

Max. Geschwindigkeit (km/h)

Optionales Geschwindigkeitslimit waehrend Fahrten mit diesem Paket.

Nuetzlich fuer Anfaengerpakete oder sicherheitsorientierte Angebote.

Erstellen eines Fahrtpakets

Schritt 1: Basis-Setup

1. Navigieren Sie zu Preisgestaltung → Fahrtpakete
2. Klicken Sie auf Paket hinzufuegen
3. Schrittnummer fuer Anzeigereihenfolge festlegen
4. Titel in unterstuetzten Sprachen eingeben

Schritt 2: Preisgestaltung

1. Preis in Cent eingeben (z.B. 999 fuer 9,99 $)
2. Waehrung auswaehlen (typischerweise Unterkonto-Standard)

Schritt 3: Zeitkontingent

1. Enthaltene Zeit Menge eingeben (z.B. 60)
2. Enthaltene Zeit Einheit auswaehlen (Minuten, Stunden oder Tage)

Schritt 4: Zusaetzliche Vorteile

1. Entsperrgebuehr enthalten aktivieren, wenn Paket Entsperrungen abdeckt
2. Max. Fahrer festlegen, wenn Gruppenfahrten unterstuetzt werden
3. Enthaltene Strecke hinzufuegen, falls zutreffend
4. Enthaltene Pausenminuten hinzufuegen, falls zutreffend

Schritt 5: Anpassen & Aktivieren

1. Optionalen Badge-Text hinzufuegen
2. Aktiviert umschalten fuer Verfuegbarkeit
3. Klicken Sie auf Speichern

Wie Pakete funktionieren

Kaufablauf

Nutzung waehrend Fahrten

Wenn ein Kunde mit aktivem Paket eine Fahrt startet:

1. System prueft auf aktive Paketkaufe
2. Vorteile angewendet - Entsperrgebuehr erlassen (falls enthalten), Zeit wird vom Paket abgezogen
3. Waehrend der Fahrt - Zeit/Strecke wird von Paketkontingenten abgezogen
4. Fahrt endet - Verbleibendes Guthaben aktualisiert, Ueberschuss normal berechnet

Paketverbrauch

Paket: 60 Minuten
├── Fahrt 1: 15 Minuten → 45 Minuten verbleibend
├── Fahrt 2: 20 Minuten → 25 Minuten verbleibend
├── Fahrt 3: 30 Minuten → Paket erschoepft (5 Min normal berechnet)
└── Status: Verbraucht

Wenn ein Paket erschoepft ist, gilt fuer jede Uebernutzung die regulaere Preisgestaltung.

Mobile-App-Integration

Paketanzeige

Der /packages-Bildschirm der mobilen App zeigt:

• Verfuegbare Pakete fuer den Standort des Kunden
• Pakettitel (lokalisiert)
• Preis in Waehrung formatiert
• Enthaltene Dauer/Zeit
• Gruppenfahrt-Anzeige (wenn max_riders > 1)
• Kauf-Button

Aktive Pakete

Kunden koennen ihre aktiven Pakete sehen:

• Paketname und Kaufdatum
• Verbleibende Zeit/Entsperrungen
• Standort, wo Paket gilt
• Nutzungshistorie

Standortaufloesung

Pakete sind standortspezifisch:

1. App sendet GPS-Koordinaten des Kunden
2. System prueft, welche Zonen den Standort enthalten
3. Pakete des passenden Unterkontos werden angezeigt
4. Falls mehrdeutig, muss Kunde moeglicherweise Standort waehlen

API-Referenz

GET /api/mobile/packages

Verfuegbare Pakete fuer einen Standort abrufen.

Query-Parameter:

• lat - Breitengrad (optional)
• lng - Laengengrad (optional)
• subaccount_id - Direkte Unterkonto-ID (optional)

Antwort:

{
  "data": {
    "purchases": [...],
    "available_packages": [...],
    "has_active_package": false,
    "location": {
      "subaccount_id": "uuid",
      "subaccount": { "name": "Stadtname" }
    }
  }
}

POST /api/mobile/packages

Ein Paket kaufen.

Request-Body:

{
  "package_id": "uuid",
  "payment_method": "wallet"
}

Antwort (Guthaben-Zahlung):

{
  "data": { ... Kaufeintrag ... },
  "payment": {
    "method": "wallet",
    "amount_cents": 999,
    "new_wallet_balance_cents": 1501
  }
}

Antwort (Kartenzahlung erforderlich):

{
  "requires_payment": true,
  "client_secret": "pi_..._secret_...",
  "payment_intent_id": "pi_...",
  "amount_cents": 999
}

Datenbankschema

Tabelle: ride_pricing_packages

Tabelle: ride_pricing_package_purchases

Haeufige Szenarien

Szenario 1: Basis-Zeitpaket

Ziel: Einfaches 1-Stunden-Fahrtpaket

Einrichtung:

• Titel: "1-Stunden-Paket"
• Preis: 9,99 $ (999 Cent)
• Zeit: 60 Minuten
• Entsperrung enthalten: Ja
• Max. Fahrer: 1

Kundenwert: Ersparnis gegenueber Entsperrgebuehr + Stundentarif

Szenario 2: Gruppen-Tagespass

Ziel: Familie/Freunde Tagesausflug

Einrichtung:

• Titel: "Gruppen-Tagespass"
• Preis: 29,99 $ (2999 Cent)
• Zeit: 4 Stunden
• Entsperrung enthalten: Ja
• Max. Fahrer: 4
• Badge: "IDEAL FUER GRUPPEN"

Kundenwert: 4 Personen koennen zusammen fahren und die Zeit teilen

Szenario 3: Streckenpaket

Ziel: Tour/Erkundungspaket

Einrichtung:

• Titel: "Explorer 50km"
• Preis: 24,99 $ (2499 Cent)
• Zeit: 2 Stunden
• Strecke: 50 km
• Entsperrung enthalten: Ja

Kundenwert: Gut fuer Touren mit Streckenbegrenzung

Best Practices

Paketdesign

1. Klares Wertversprechen - Ersparnis offensichtlich machen
2. Gestufte Optionen - Klein, mittel, gross Pakete
3. Anwendungsfaelle abgleichen - Pendeln, Freizeit, Tourismus
4. Gruppenoptionen - Familien, Freunde, Touristen

Preisstrategie

1. Break-Even berechnen - Ab wann spart das Paket Geld?
2. Ankerpreise - Minutenpreis-Aequivalent zeigen
3. Bundle-Wert - Zeit + Entsperrungen + Pause kombinieren

Anzeigeoptimierung

1. Bester Wert zuerst - step_number strategisch nutzen
2. Badges verwenden - Beliebte/empfohlene hervorheben
3. Klare Beschreibungen - Erklaeren, was enthalten ist

Fehlerbehebung

Paket nicht sichtbar

1. Pruefen, dass activated wahr ist
2. Verifizieren, dass deleted_at null ist
3. Korrektes Unterkonto ausgewaehlt bestaetigen
4. Standort des Kunden stimmt mit Paket-Unterkonto ueberein

Guthaben werden nicht angewendet

1. Kaufstatus ist 'active' verifizieren
2. Verbleibendes Guthaben ist nicht null pruefen
3. Paket-Unterkonto stimmt mit Fahrtstandort ueberein bestaetigen
4. Fahrtpreis-Berechnungslogs ueberpruefen

Gruppenfahrt-Probleme

1. max_riders-Einstellung pruefen
2. Gruppenfahrten in Unterkonto-Einstellungen aktiviert verifizieren
3. Paket hat verbleibende Entsperrungen bestaetigen