Primeiros Passos com Levy Cover

Este guia orienta a ativacao do Levy Cover em uma subconta do zero. Pressupoe que a parceria com a seguradora foi assinada e voce tem credenciais sandbox ou de producao da Cover Genius.

Pre-requisitos

Antes de comecar, confirme:

• A subconta concluiu o onboarding do Stripe Connect.
• A subconta opera em pelo menos uma jurisdicao na Matriz de Jurisdicao.
• Voce tem os valores API_KEY e PARTNER_ID da Cover Genius (sandbox ou producao).
• Ciclistas nesta subconta estao usando uma build do aplicativo mobile que inclui o cartao opt-in Levy Cover.

Passo 1 - Definir as credenciais da seguradora

Defina as duas variaveis de ambiente no Vercel para cada ambiente que vai receber trafego de producao:

COVER_GENIUS_API_KEY=<do portal Cover Genius>
COVER_GENIUS_PARTNER_ID=<do portal Cover Genius>

Instrucoes completas em Configuracao de Credenciais da Seguradora. O cliente da seguradora le isso em tempo de execucao - sem deploy necessario apos rotacao, mas e necessario um redeploy na primeira vez que voce os define.

Passo 2 - Verificar a matriz de jurisdicao

Abra a matriz em /dashboard/insurance/settings e confirme que os locais de desbloqueio que voce atende estao marcados como available: true com a seguradora que voce pretende usar. Jurisdicoes inicialmente suportadas:

• EUA: California, Texas, Florida, Carolina do Norte, Massachusetts (Fase 1). Colorado, Arizona, Georgia, Oregon, Tennessee adicionados na Fase 2.
• UE: Alemanha, Franca, Holanda, Portugal.
• Excluidos: Nova York, Washington (friccao DOI). Fora do escopo na v1.

Se sua jurisdicao estiver faltando, contate o suporte - nos a adicionamos a matriz e a tabela insurance_offerings, ou a seguradora ainda nao esta licenciada la.

Passo 3 - Configurar a oferta

Ainda em /dashboard/insurance/settings:

1. Ative o Levy Cover on para a subconta.
2. Escolha quais niveis oferecer. v1 entrega apenas "Standard"; v2 desbloqueia "Minimal" e "Premium".
3. Defina o percentual de comissao do operador. O padrao vem da variavel de ambiente global INSURANCE_OPERATOR_SHARE_PCT (tipicamente 50% da comissao bruta da Levy); valores por subconta substituem isso.
4. Salve.

A pagina de configuracoes grava na tabela insurance_offerings, que e a fonte de verdade em tempo de execucao para disponibilidade de opt-in e calculo de comissao.

Passo 4 - Testar em sandbox

Antes de ir ao ar:

1. Configure as credenciais sandbox da Cover Genius em um ambiente de preview.
2. Desbloqueie um veiculo em uma subconta sandbox. Confirme que o cartao opt-in aparece.
3. Aceite a oferta, conclua a viagem e verifique o recibo - "Levy Cover - Standard - 1,00 USD" deve aparecer como item de linha separado.
4. Apresente um sinistro de teste do historico de viagens. Carregue pelo menos uma foto. Confirme que o sinistro chega a lista do operador em /dashboard/insurance/claims.
5. Inspecione ride_insurance_policies e insurance_claims no banco de dados - ambos devem ter os IDs de seguradora retornados pelo sandbox da Cover Genius.

Passo 5 - Promover para producao

Quando o UAT sandbox estiver limpo e a Cover Genius tiver aprovado:

1. Defina COVER_GENIUS_API_KEY e COVER_GENIUS_PARTNER_ID de producao na env de producao do Vercel.
2. Verifique se a URL do receptor de webhook esta registrada com a seguradora: https://fleets.levyelectric.com/api/webhooks/insurance/cover-genius.
3. Ative o toggle da subconta em producao.
4. Observe as primeiras 10-20 viagens seguradas. Monitore insurance_webhook_log para signature_verified = true em cada evento de entrada.

Passo 6 - Entregar para operacoes

Diga a operacoes Levy:

• Qual subconta esta agora ao vivo.
• Quais jurisdicoes estao cobertas.
• Percentual de comissao do operador.
• Credenciais sandbox vs producao em uso.

Tickets de suporte para "Tive um acidente e quero meu dinheiro de volta" agora sao roteados atraves do fluxo de sinistro da seguradora em vez de reembolsos de cortesia.

Problemas comuns no primeiro dia

---