Versicherer-Anmeldedaten einrichten

Levy Cover liest Versicherer-Anmeldedaten zur Laufzeit aus Umgebungsvariablen. Diese Seite beschreibt die Anmeldedaten, die jeder Versicherer erwartet, wo Sie sie setzen, wie Sie sie rotieren und wie Sie verifizieren, dass sie korrekt verdrahtet sind.

Cover Genius (primar)

Zwei Variablen, beide erforderlich:

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

• COVER_GENIUS_API_KEY authentifiziert jeden API-Aufruf. Bearer-Style.
• COVER_GENIUS_PARTNER_ID identifiziert Levy Fleets gegenuber Cover Genius und wird verwendet, um Angebote an den korrekten Vertriebsvertrag zu leiten.

Beide Werte kommen aus dem Cover Genius Partner-Portal. Sandbox und Produktion haben separate Schlussel; teilen Sie Schlussel nie zwischen Umgebungen.

Wenn eine Variable fehlt, wirft CoverGeniusClient CarrierNotConfiguredError. In Dev und Test fallt die Registry auf den Mock-Versicherer zuruck. In Produktion geben Angebote available: false zuruck und die Opt-in-Karte ist verborgen.

Slice (Phase-2-Fallback)

Slice wird in Phase 2 als Fallback-Versicherer fur Jurisdiktionen geliefert, die Cover Genius nicht abdecken kann. Bei Aktivierung setzen Sie:

SLICE_API_KEY=<aus dem Slice Partner-Portal>
SLICE_PARTNER_ID=<aus dem Slice Partner-Portal>

Die Form der Variablen entspricht Cover Genius. Die Jurisdiktionsmatrix leitet den richtigen Versicherer pro Region (siehe Jurisdiktionsmatrix).

Mock-Versicherer (Entwicklung und Tests)

Der Mock-Versicherer benotigt keine Anmeldedaten. Er wird automatisch ausgewahlt, wenn NODE_ENV !== 'production' und die echten Versicherer-Anmeldedaten fehlen. Er generiert synthetische Policen-IDs und Schadens-IDs, sodass der vollstandige Code-Pfad ausgeubt werden kann, ohne einen echten Versicherer zu erreichen.

Tests konnen die Registry mit setCarrierRegistryForTests an den Mock-Client binden, der in den Test-Helfern unter src/lib/insurance/__tests__/ dokumentiert ist.

Vercel-Umgebungsbereiche

Setzen Sie Anmeldedaten unter Vercel Projekteinstellungen > Umgebungsvariablen:

Ein Redeploy ist beim ersten Setzen der Variablen erforderlich. Danach werden Rotationswerte beim nachsten Aufruf wirksam (Vercel liest Umgebungsvariablen pro Anfrage).

Webhook-Geheimnis

Das Cover Genius Webhook-Signaturgeheimnis ist eine separate Variable:

COVER_GENIUS_WEBHOOK_SECRET=<aus dem Cover Genius Portal>

Der Webhook-Router verwendet dies, um die HMAC-Signatur bei jedem eingehenden Ereignis zu verifizieren. Wenn das Geheimnis fehlt, schlagt die Signaturverifizierung fehl und Ereignisse landen in insurance_webhook_log mit signature_verified = false. Setzen Sie dies pro Umgebung neben dem API-Schlussel.

Rotation

Cover Genius unterstutzt Schlusselrotation uber das Partner-Portal. Das Rotationsverfahren:

1. Generieren Sie einen neuen Schlussel im Cover Genius Portal.
2. Setzen Sie den neuen Wert in Vercel fur die entsprechende Umgebung.
3. Losen Sie einen Redeploy aus (oder warten Sie auf den nachsten Deploy - Anderungen werden beim nachsten Kaltstart wirksam).
4. Bestatigen Sie, dass ein frisches Angebot erfolgreich ist.
5. Widerrufen Sie den alten Schlussel im Cover Genius Portal.

Widerrufen Sie den alten Schlussel nicht, bevor der neue Schlussel verifiziert ist. Cover Genius stagiert zukunftige Anmeldedaten nicht voraus; die einzige sichere Reihenfolge ist neu setzen -> verifizieren -> alt widerrufen.

Verifizierung

Nach dem Setzen der Anmeldedaten verifizieren Sie die Verdrahtung:

1. Aus einer authentifizierten Sitzung im Dashboard rufen Sie /api/admin/insurance/carriers auf. Es sollte cover_genius mit configured: true auflisten.
2. Losen Sie ein Sandbox-Entsperren aus und inspizieren Sie die Antwort von /api/mobile/insurance/cover/quote. Ein korrekt konfigurierter Versicherer gibt mindestens eine Stufe mit einer Pramie ungleich null zuruck.
3. Inspizieren Sie Vercel-Logs auf CarrierNotConfiguredError. Jedes Vorkommen weist auf eine falsch konfigurierte Umgebung hin.

Was nie in Umgebungsvariablen gehort

• Pro-Unterkonto-Provisionsprozentsatze. Diese leben in insurance_offerings und sind betreiberbearbeitbar.
• Stufenpreise. Preise werden vom Versicherer bestimmt und vom Angebots-Endpunkt pro Fahrt zuruckgegeben.
• Fahrer-PII. PII wird pro Bindung uber die API mit dem Versicherer geteilt, nicht in Umgebungsvariablen gespeichert.

Die globalen Provisions-Stellhebel INSURANCE_LEVY_GROSS_PCT (Standard 25) und INSURANCE_OPERATOR_SHARE_PCT (Standard 50) sind Umgebungsvariablen, aber sie sind Provisions-Richtlinienwerte, keine Geheimnisse - Rotationsregeln gelten nicht.

---