Cover Genius aktivieren

Cover Genius (XCover-Plattform, Gig Cover Produktfamilie) ist der primare Versicherer hinter Levy Cover. Sie versichern bereits Uber, Ola, Booking Holdings und Hopper. Sie sind in mehr als 60 Landern und allen 50 US-Bundesstaaten lizenziert und bieten eine REST-API fur Angebot -> Bindung -> Schaden -> Auszahlung mit signierten Webhooks und einer Sandbox.

Diese Seite behandelt die betreiberseitigen und technikseitigen Schritte zur Aktivierung von Cover Genius fur eine Levy Fleets Bereitstellung.

Wie Levy in das Cover Genius Modell passt

Cover Genius betreibt ein Versicherer-Vertriebspartner-Modell. Cover Genius halt die Versicherungslizenz; Levy Fleets ist als Vertriebspartner unter dieser Lizenz registriert. Das bedeutet:

• Levy ist kein Versicherer, MGA oder Versicherungsvermittler im eigenen Namen.
• Cover Genius besitzt Risikobewertung, Kapitalreserven und Schadensbearbeitung.
• Levy ist verantwortlich fur transparente Offenlegung gegenuber Fahrern, genaue KYC (uber Stripe Identity gehandhabt) und korrekte Pramienbuchhaltung.
• Die Vertriebsvereinbarung definiert Provision, abgedeckte Jurisdiktionen, Auszahlungsbedingungen und Kundigungsrechte.

Umgebungsvariablen

Levy Cover liest zwei Umgebungsvariablen zur Laufzeit:

COVER_GENIUS_API_KEY=<Ihr API-Schlussel aus dem Cover Genius Portal>
COVER_GENIUS_PARTNER_ID=<Ihre Partner-ID aus dem Cover Genius Portal>

Beide sind erforderlich. Wenn eine fehlt, wirft CoverGeniusClient CarrierNotConfiguredError und fallt in Nicht-Produktions-Umgebungen auf den Mock-Client zuruck. In Produktion fuhrt der Zustand fehlender Anmeldedaten dazu, dass jedes Angebot available: false zuruckgibt und die Opt-in-Karte den Fahrern nie erscheint.

Siehe Versicherer-Anmeldedaten einrichten fur den vollstandigen Anmeldedaten-Lebenszyklus (Rotation, Sandbox vs Produktion, Vercel-Umgebungsbereiche).

Endpunkte, die Levy verwendet

Jeder POST von Levy an Cover Genius tragt einen Idempotency-Key-Header mit Schlussel ride_id + operation. Dies schutzt vor doppelten Bindungen oder Schaden, falls eine Netzwerkwiederholung mitten im Aufruf passiert.

Webhook-Registrierung

Registrieren Sie im Cover Genius Portal die Webhook-Empfanger-URL:

https://fleets.levyelectric.com/api/webhooks/insurance/cover-genius

Levy verifiziert die Webhook-Signatur mit dem geteilten Geheimnis von Cover Genius bei jedem eingehenden Ereignis. Verifizierungsfehler landen in insurance_webhook_log mit signature_verified = false und processed_at IS NULL, wo Operations sie inspizieren kann.

Doppelte Zustellungen werden uber UNIQUE (carrier, event_id) dedupliziert - der Router fangt den Duplikat-Schlussel-Fehler ab und gibt { duplicate: true } zuruck, damit der Versicherer aufhort, Wiederholungen zu senden.

Sandbox-UAT

Cover Genius bietet eine vollstandige Sandbox. Um sie zu nutzen:

1. Setzen Sie Sandbox-COVER_GENIUS_API_KEY in einer Vorschau-Umgebung.
2. Registrieren Sie die Webhook-URL der Vorschau-Umgebung bei der Sandbox.
3. Fuhren Sie end-to-end aus:
   • Entsperren Sie ein Fahrzeug, akzeptieren Sie die Opt-in-Karte.
   • Bestatigen Sie, dass ride_insurance_policies eine Zeile mit befulltem carrier_policy_id hat.
   • Beenden Sie die Fahrt. Bestatigen Sie, dass die Quittung den Pramien-Posten zeigt.
   • Reichen Sie einen Testschaden aus dem Fahrtverlauf ein.
   • Losen Sie Sandbox-Webhooks fur claim.approved und payout.completed aus.
   • Bestatigen Sie, dass insurance_claims.status korrekt ubergeht.
   • Wenn das Auszahlungsziel levy_wallet ist, bestatigen Sie, dass die Wallet-Gutschrift auf die insurance_claims-Zeile verweist, nicht auf eine ride_refunds-Zeile.

Produktions-Umstellung

Wenn Sandbox-UAT sauber ist und Cover Genius Go-Live bestatigt hat:

1. Setzen Sie Produktions-COVER_GENIUS_API_KEY und COVER_GENIUS_PARTNER_ID in der Vercel-Produktions-Umgebung.
2. Registrieren Sie die Produktions-Webhook-URL.
3. Schalten Sie die Unterkonto-Toggles um, die Sie live haben mochten, unter /dashboard/insurance/settings.
4. Uberwachen Sie die ersten 100 versicherten Fahrten:
   • insurance_webhook_log sollte signature_verified = true bei jedem Ereignis zeigen.
   • Der nachtliche Versicherer-Abstimmungs-Cron sollte null Diskrepanzen melden.
   • Schadensliste unter /dashboard/insurance/claims sollte mit echten Schaden befullt sein.

Ausfallverhalten

Wenn die Cover Genius API beim Entsperren nicht erreichbar ist, versagt Levy offen: Die Fahrt wird als insurance_offered = false markiert, keine Pramie berechnet, und die Fahrt geht normal weiter. Das ist beabsichtigt. Das Blockieren des Entsperrens bei einem Versicherer-Ausfall ist inakzeptabel.

Weitere Informationen zum Verhalten gebundener Policen und ausstehender Schaden wahrend eines Ausfalls finden Sie unter Fehlerbehebung.

Versicherer pro Jurisdiktion wechseln

Die Jurisdiktionsmatrix kann verschiedene Regionen zu verschiedenen Versicherern leiten. v2 fuhrt Slice als Fallback ein - Jurisdiktionen, in denen Cover Genius nicht lizenziert ist oder Preise nicht wettbewerbsfahig sind, konnen ohne Code-Anderungen auf Slice umgeschaltet werden. Siehe Jurisdiktionsmatrix.

---