Erste Schritte mit Levy Cover

Diese Anleitung fuhrt durch die Aktivierung von Levy Cover auf einem Unterkonto von Grund auf. Sie setzt voraus, dass die Versicherer-Partnerschaft unterzeichnet wurde und Sie Sandbox- oder Produktions-Anmeldedaten von Cover Genius haben.

Voraussetzungen

Bevor Sie beginnen, bestatigen Sie:

• Das Unterkonto hat Stripe Connect Onboarding abgeschlossen.
• Das Unterkonto operiert in mindestens einer Jurisdiktion aus der Jurisdiktionsmatrix.
• Sie haben Cover Genius API_KEY und PARTNER_ID Werte (Sandbox oder Produktion).
• Fahrer auf diesem Unterkonto verwenden eine Mobile-App-Version, die die Levy Cover Opt-in-Karte enthalt.

Schritt 1 - Versicherer-Anmeldedaten setzen

Setzen Sie die beiden Umgebungsvariablen auf Vercel fur jede Umgebung, die Produktionsverkehr erhalt:

COVER_GENIUS_API_KEY=<aus dem Cover Genius Portal>
COVER_GENIUS_PARTNER_ID=<aus dem Cover Genius Portal>

Vollstandige Anweisungen finden Sie unter Versicherer-Anmeldedaten einrichten. Der Versicherer-Client liest diese zur Laufzeit - kein Deploy nach der Rotation notig, aber ein Redeploy ist erforderlich, wenn Sie sie zum ersten Mal setzen.

Schritt 2 - Jurisdiktionsmatrix verifizieren

Offnen Sie die Matrix unter /dashboard/insurance/settings und bestatigen Sie, dass die Entsperrorte, die Sie bedienen, als available: true mit dem Versicherer markiert sind, den Sie verwenden mochten. Anfangs unterstutzte Jurisdiktionen:

• US: Kalifornien, Texas, Florida, North Carolina, Massachusetts (Phase 1). Colorado, Arizona, Georgia, Oregon, Tennessee in Phase 2 hinzugefugt.
• EU: Deutschland, Frankreich, Niederlande, Portugal.
• Ausgeschlossen: New York, Washington (DOI-Friktion). Ausserhalb des Geltungsbereichs in v1.

Wenn Ihre Jurisdiktion fehlt, kontaktieren Sie den Support - wir fugen sie entweder zur Matrix und der insurance_offerings Tabelle hinzu, oder der Versicherer ist dort noch nicht lizenziert.

Schritt 3 - Angebot konfigurieren

Weiter unter /dashboard/insurance/settings:

1. Schalten Sie Levy Cover ein fur das Unterkonto.
2. Wahlen Sie, welche Stufen angeboten werden sollen. v1 liefert nur "Standard"; v2 schaltet "Minimal" und "Premium" frei.
3. Legen Sie den Betreiber-Provisionsprozentsatz fest. Der Standard kommt aus der globalen INSURANCE_OPERATOR_SHARE_PCT Umgebungsvariable (typischerweise 50% von Levys Bruttoprovision); Pro-Unterkonto-Werte uberschreiben das.
4. Speichern.

Die Einstellungsseite schreibt in die insurance_offerings Tabelle, die die Laufzeit-Quelle der Wahrheit fur Opt-in-Verfugbarkeit und Provisionsmathematik ist.

Schritt 4 - In Sandbox testen

Vor dem Live-Gang:

1. Konfigurieren Sie Cover Genius Sandbox-Anmeldedaten in einer Vorschau-Umgebung.
2. Entsperren Sie ein Fahrzeug auf einem Sandbox-Unterkonto. Bestatigen Sie, dass die Opt-in-Karte erscheint.
3. Akzeptieren Sie das Angebot, schliessen Sie die Fahrt ab und prufen Sie den Beleg - "Levy Cover - Standard - 1,00 USD" sollte als separater Posten erscheinen.
4. Reichen Sie einen Testschaden aus dem Fahrtverlauf ein. Laden Sie mindestens ein Foto hoch. Bestatigen Sie, dass der Schaden in der Betreiber-Liste unter /dashboard/insurance/claims landet.
5. Prufen Sie ride_insurance_policies und insurance_claims in der Datenbank - beide sollten die von Cover Genius Sandbox zuruckgegebenen Versicherer-IDs haben.

Schritt 5 - In Produktion uberfuhren

Wenn Sandbox-UAT sauber ist und Cover Genius freigegeben hat:

1. Setzen Sie Produktions-COVER_GENIUS_API_KEY und COVER_GENIUS_PARTNER_ID in der Vercel-Produktions-Umgebung.
2. Verifizieren Sie, dass die Webhook-Empfanger-URL beim Versicherer registriert ist: https://fleets.levyelectric.com/api/webhooks/insurance/cover-genius.
3. Aktivieren Sie den Unterkonto-Toggle in Produktion.
4. Beobachten Sie die ersten 10-20 versicherten Fahrten. Uberwachen Sie insurance_webhook_log auf signature_verified = true bei jedem eingehenden Ereignis.

Schritt 6 - An Operations ubergeben

Sagen Sie Levy Operations:

• Welches Unterkonto ist jetzt live.
• Welche Jurisdiktionen sind abgedeckt.
• Betreiber-Provisionsprozentsatz.
• Sandbox vs Produktions-Versicherer-Anmeldedaten in Verwendung.

Support-Tickets fur "Ich hatte einen Unfall und mochte mein Geld zuruck" werden jetzt uber den Versicherer-Schadensfluss geleitet, nicht uber Kulanz-Ruckerstattungen.

Haufige Probleme am ersten Tag

---