Opt-In Por Viagem - Fluxo do Ciclista

O cartao opt-in do Levy Cover e o unico ponto de contato entre o ciclista e o produto de seguro. Ele fica na tela de desbloqueio, apos a aceitacao da renuncia e antes do engajamento do motor. Esta pagina descreve exatamente o que o ciclista ve, como a decisao e registrada e o que acontece depois.

Quando o cartao aparece

O cartao opt-in aparece quando todas as seguintes condicoes sao verdadeiras:

1. O local de desbloqueio do veiculo resolve para uma jurisdicao marcada como available: true na matriz.
2. A subconta tem o Levy Cover ativado em /dashboard/insurance/settings.
3. A seguradora retornou uma cotacao bem-sucedida dentro do orcamento de 2 segundos no desbloqueio.
4. O ciclista aceitou a renuncia do aluguel.

Se alguma dessas for falsa, o cartao nunca aparece. Levy falha aberto - a ausencia de seguro nunca bloqueia um desbloqueio.

O que o cartao mostra

O cartao e renderizado por LevyCoverOptInCard no aplicativo mobile. Usa bibliotecas ja presentes no aplicativo - sem novos modulos nativos.

Idiomas

O cartao suporta todos os cinco idiomas Levy: Ingles, Alemao, Espanhol, Frances, Portugues. O texto da apolice e exibido no idioma do ciclista quando a seguradora suporta. Se a seguradora nao tiver texto no idioma do ciclista, o cartao recorre ao Ingles e mostra uma divulgacao explicita de que o texto esta em Ingles.

Como a aceitacao e registrada

Quando o ciclista toca em Adicionar cobertura:

1. O aplicativo mobile chama POST /api/mobile/insurance/cover/bind com o nivel escolhido.
2. O backend Levy chama Cover Genius POST /bookings com payload chaveado por idempotencia.
3. A seguradora retorna um ID de apolice, que a Levy armazena em ride_insurance_policies:
   • carrier_policy_id
   • tier
   • premium_amount e premium_currency
   • levy_commission_amount e operator_commission_amount
   • policy_wording_version - a versao exata do texto que o ciclista viu, armazenada literalmente
   • timestamp bound_at
4. O veiculo desbloqueia. A viagem comeca. A apolice esta ativa.

O carimbo de versao do texto e importante. Se o texto mudar no meio do trimestre, cada apolice vinculada existente ainda referencia a versao que o ciclista realmente viu.

O que "Recusar" faz

Quando o ciclista toca em Recusar:

1. O aplicativo mobile chama o endpoint de desbloqueio sem payload de seguro.
2. A viagem e marcada como insurance_offered = true e insurance_accepted = false.
3. Nenhum premio e cobrado. Nenhuma apolice e vinculada.
4. Se "Lembrar minha escolha" estiver ligado, a preferencia do ciclista e registrada em seu perfil. Viagens futuras em subcontas ativadas pulam o cartao ate que ele mude a preferencia.

Recusas sao armazenadas. Isso e necessario para relatorios DOI em jurisdicoes que exigem que demonstremos opt-in transparente (vs inscricao forcada).

Tempo de cotacao e TTL

Cotacoes sao buscadas no desbloqueio. Sao validas por 5 minutos. Se o ciclista mantiver a tela de desbloqueio por mais de 5 minutos, a proxima chamada de vinculacao recotacao automaticamente antes de vincular. Isso evita precos desatualizados se fatores de risco do lado da seguradora mudarem (por ex. clima, hora do dia, zona).

Se a chamada de vinculacao falhar - timeout de API da seguradora, cartao recusado na cobranca do premio, etc. - veja Solucao de Problemas.

Cenarios de multiplos ciclistas e familia

v1 cobre apenas o titular da conta. Se um ciclista abrir um veiculo para um amigo ou membro da familia, apenas o titular da conta e nomeado na apolice. Cobertura de passageiros nao esta no escopo da v1 e a UX deve dizer isso explicitamente no texto da apolice.

Para viagens de car-share com varios ocupantes, a mesma regra se aplica. O motorista e o segurado nomeado.

Viagens cross-jurisdicao

A cobertura e determinada pelo local de desbloqueio. Uma viagem que comeca em uma jurisdicao coberta e termina em uma nao coberta ainda esta vinculada sob a apolice do local de desbloqueio. O texto da apolice da seguradora especifica o escopo geografico da cobertura e o que acontece se a viagem sair dele.

Atualmente nao revinculamos no meio da viagem. v1 se compromete com uma apolice por viagem, decidida no desbloqueio.

Preferencia persistente do ciclista

O toggle "Lembrar minha escolha" armazena a decisao do ciclista em seu perfil mobile. Tres estados:

• Sem preferencia - cartao e mostrado a cada viagem.
• Sempre aceitar Standard - cartao mostra brevemente com uma confirmacao "voce ativou o Cover", entao auto-vincula.
• Sempre recusar - cartao nao aparece de jeito nenhum.

O ciclista pode mudar isso em qualquer lugar no menu de configuracoes do aplicativo. Orientacao DOI em alguns estados exige que "sempre recusar" seja re-solicitado periodicamente; a cadencia da solicitacao e configuravel por jurisdicao.

Apresentacao do recibo

No final da viagem, o premio aparece no recibo como um item de linha separado:

Levy Cover - Standard          1,00 USD

O premio e parte do total da viagem, mas isolado para fins fiscais - rides.tax_amount exclui o premio porque o imposto sobre premio de seguro e tratado pela seguradora na maioria das jurisdicoes. A divisao de comissao (rede da seguradora, comissao da Levy, comissao do operador) nao e divulgada ao ciclista.

---