O que você vai precisar
- A integração sandbox funcionando de ponta a ponta.
- O domínio real do seu site, ou o identificador do app publicado na loja.
- Um endpoint de webhook em produção, com HTTPS.
Passo a passo
1
Crie a integração de produção
Em Integrações, clique em Criar integração e
escolha Produção.Como criar uma integração
2
Confirme o fluxo com a Legitimuz
O fluxo de produção é montado e publicado pela Legitimuz junto com você. Confirme com o time
quais etapas ele terá e quais delas são cobradas.Como os fluxos funcionam
3
Cadastre a origem de produção
O domínio real ou o app bundle. A origem fica Aguardando validação até a Legitimuz confirmar
a posse. Cadastre com antecedência.Autorizar origens
4
Crie uma chave nova
A chave de sandbox não funciona em produção. Conceda só a permissão de criar verificação e
guarde no cofre de segredos do seu servidor.Chaves de API
5
Aponte o webhook para o endpoint de produção
Com segredo próprio. Dispare a entrega de teste pelo dashboard e confirme que a assinatura
confere nesse endpoint.Configurar webhooks
6
Troque as variáveis de ambiente
Chave,
integration_origin_public_id e segredo do webhook. As três mudam juntas.Antes de liberar
O seu handler trata review?
O seu handler trata review?
“Em revisão” não é recusa. Se o seu código só trata aprovada e reprovada, uma pessoa legítima
fica presa sem ninguém perceber.E ele precisa aceitar
verification.decided duas vezes: a segunda chega quando um analista
decide no dashboard.A assinatura do webhook é conferida?
A assinatura do webhook é conferida?
Um endpoint que processa qualquer
POST aceita um desfecho forjado. Confira antes de confiar.Segurança dos webhooksA chave está só no servidor?
A chave está só no servidor?
Procure
lz_ no bundle do seu front e no código do app. Se aparecer, crie outra chave e
revogue essa antes de subir.Você guarda o vínculo antes de responder?
Você guarda o vínculo antes de responder?
O webhook chega com o
ref_id que você mandou na criação. Se a associação não foi gravada, o
evento chega e não há a quem atribuí-lo.A pessoa sabe o que está sendo coletado?
A pessoa sabe o que está sendo coletado?
A jornada captura biometria e documento. O aviso à pessoa é responsabilidade sua, antes de a
verificação abrir.Dados e privacidade
Depois de subir
Mantenha a sandbox viva. É onde qualquer mudança é testada antes de alcançar pessoas reais.Acompanhe o funil
A página inicial mostra onde as pessoas desistem.
Boas práticas
O que separa uma integração que funciona de uma que gera chamado.