Auto-Auflade-Konfiguration

Die Auto-Aufladung fullt Kunden-Wallet-Guthaben automatisch auf, wenn es unter einen konfigurierbaren Schwellenwert fallt. Dies stellt sicher, dass Kunden Fahrten immer starten und abschliessen konnen, ohne manuell Guthaben hinzuzufugen.

Ubersicht

Wenn aktiviert, uberwacht das System Wallet-Guthaben und belastet automatisch die gespeicherte Zahlungsmethode des Kunden, wenn sein Guthaben zu niedrig wird. Dies schafft ein nahtloses Fahrerlebnis, bei dem sich Kunden keine Sorgen machen mussen, mitten in der Fahrt kein Guthaben mehr zu haben.

Hauptfunktionen

• Automatische Abbuchung - Belastet gespeicherte Zahlungsmethode bei niedrigem Guthaben
• Konfigurierbarer Schwellenwert - Legen Sie den Auslosepunkt fur automatische Aufladungen fest
• Konfigurierbarer Betrag - Legen Sie fest, wie viel jedes Mal hinzugefugt wird
• Duale Zustimmung erforderlich - Sowohl Betreiber als auch Kunde mussen aktivieren
• Stripe-Integration - Sichere Off-Session-Zahlungen uber Stripe
• Nebenlaufigkeitsschutz - Datenbanksperren verhindern doppelte Abbuchungen

Funktionsweise

Wallet-Guthaben: 4,50 $
Schwellenwert: 5,00 $
Aufladebetrag: 15,00 $

1. Kunde startet Fahrt
2. System pruft: 4,50 $ ≤ 5,00 $ Schwellenwert
3. Auto-Aufladung ausgelost
4. Stripe belastet Standardkarte mit 15,00 $
5. Neues Guthaben: 19,50 $
6. Fahrt verlauft normal

Anforderungen

Auto-Aufladung erfordert ALLE der folgenden Punkte:

Betreiber-Konfiguration

Auto-Aufladung aktivieren

Konfigurationsoptionen

Auslosestufe (Schwellenwert)

Das Wallet-Guthaben, bei dem Auto-Aufladung aktiviert wird.

Empfehlungen:

• Schwellenwert leicht hoher als durchschnittliche Fahrtkosten setzen
• Entsperrgebuhr + typische Fahrtdauer berucksichtigen
• Hohere Schwellenwerte = haufigere kleine Abbuchungen

Aufladebetrag

Wie viel jedes Mal zum Wallet hinzugefugt wird.

Empfehlungen:

• Sollte 2-4 typische Fahrten abdecken
• Balance zwischen Bequemlichkeit und Transaktionsgebuhren
• Hohere Betrage = weniger Transaktionen

Bewahrte Praktiken

1. Schwellenwert uber Fahrtkosten setzen - Sicherstellen, dass Kunden mindestens eine Fahrt abschliessen konnen
2. Betrag vs. Frequenz ausbalancieren - Hohere Betrage bedeuten weniger Stripe-Gebuhren
3. An Kunden kommunizieren - Sicherstellen, dass Kunden wissen, dass Auto-Aufladung verfugbar ist
4. Abgelehnte Abbuchungen uberwachen - Regelmasig auf fehlgeschlagene Auto-Aufladungen prufen

Kundenerlebnis

Auto-Aufladung aktivieren

Kunden aktivieren Auto-Aufladung in der mobilen App:

1. Wallet-Bildschirm offnen
2. Auto-Aufladung-Schalter antippen
3. Aktivierung bestatigen
4. Sicherstellen, dass eine Standard-Zahlungsmethode gespeichert ist

Was Kunden sehen

• Schalter zum Aktivieren/Deaktivieren der Auto-Aufladung
• Benachrichtigung, wenn Auto-Auflade-Abbuchungen erfolgen
• Transaktionshistorie zeigt "Auto-Aufladung"-Eintrage
• Aktuelles Wallet-Guthaben immer sichtbar

Wann Auto-Aufladung auslost

Auto-Aufladung wird zu diesen Zeitpunkten gepruft:

Fahrtstart-Ablauf

1. Kunde tippt auf "Entsperren" am Fahrzeug
2. System pruft Wallet-Guthaben
3. Wenn Guthaben ≤ Schwellenwert UND Auto-Aufladung aktiviert:
   a. Sperre erworben, um doppelte Abbuchungen zu verhindern
   b. Stripe PaymentIntent erstellt
   c. Standard-Zahlungsmethode belastet
   d. Wallet-Guthaben aktualisiert
   e. Sperre freigegeben
4. Fahrt startet normal

Fahrtende-Ablauf

1. Fahrt endet, Kosten berechnet: 8,50 $
2. Aktuelles Wallet: 4,00 $
3. Wallet unzureichend, Auto-Aufladung ausgelost
4. 15,00 $ hinzugefugt -> Neues Guthaben: 19,00 $
5. Fahrtkosten abgezogen: 19,00 $ - 8,50 $ = 10,50 $
6. Kunde sieht Endguthaben: 10,50 $

Technische Details

Datenbankfelder

Subaccounts-Tabelle:

Customers-Tabelle:

Nebenlaufigkeitsschutz

Das System verwendet Datenbanksperren, um Kunden nicht mehrfach zu belasten:

1. Vor der Abbuchung Sperre uber acquire_auto_topup_lock RPC erwerben
2. Sperre hat 2-Minuten-TTL (lauft automatisch ab, wenn Prozess fehlschlagt)
3. Wenn Sperre bereits gehalten, warten und prufen, ob Guthaben gestiegen ist
4. Nach der Abbuchung Sperre uber release_auto_topup_lock RPC freigeben
5. Idempotenzschlussel verhindert Stripe-Doppelabbuchungen

Fehlerbehandlung

Fehlerbehebung

Auto-Aufladung funktioniert nicht

1. Unterkonto-Einstellung prufen - Uberprufen, ob auto_topup_enabled in Einstellungen true ist
2. Kundeneinstellung prufen - Uberprufen, ob Kunde in der App aktiviert hat
3. Zahlungsmethode prufen - Kunde benotigt gespeicherte Standardkarte
4. Stripe-Kunden prufen - Kunde benotigt stripe_customer_id
5. Guthaben prufen - Konnte bereits uber Schwellenwert sein

Doppelte Abbuchungen

Das System verhindert Duplikate durch:

• Datenbanksperre auf Kundendatensatz
• Stripe-Idempotenzschlussel
• Guthaben-Neuprufung nach Sperrerwerb

Wenn Duplikate auftreten, prufen Sie:

1. Sperrfreigabe-Fehler in Protokollen
2. Stripe-Webhook-Verarbeitung
3. Datenbankverbindungsprobleme

Fehlgeschlagene Abbuchungen

Haufige Grunde fur fehlgeschlagene Auto-Aufladung:

Testmodus

Fur interne Tests verwendet das System automatisch den Stripe-Testmodus fur @levyelectric.com-E-Mail-Adressen. Dies ermoglicht das Testen von Auto-Aufladeablaufen ohne echte Abbuchungen.

Kunden-E-Mail: test@levyelectric.com
-> Verwendet STRIPE_TEST_SECRET_KEY
-> Testkarten funktionieren (4242 4242 4242 4242)
-> Keine echten Abbuchungen verarbeitet

API-Referenz

Auto-Auflade-Fahigkeit prufen

import { canProcessAutoTopup } from '@/lib/auto-topup'

const canTopup = await canProcessAutoTopup(customerId, vehicleId)
// Ruckgabe: boolean

Auto-Aufladung verarbeiten

import { processAutoTopup } from '@/lib/auto-topup'

const result = await processAutoTopup(customerId, vehicleId, skipThresholdCheck)
// Ruckgabe: { success, amountCents, error?, newWalletBalance? }

Kundenpraferenz umschalten (Mobile API)

POST /api/mobile/payment
{
  "action": "toggle-auto-topup",
  "enabled": true
}