Skip to main content
Todos. O mount() é agnóstico: precisa só de um elemento para renderizar. O guia da web traz o exemplo pronto em Vanilla JS, React, Next.js, Vue e Angular. Para React existe o wrapper @legitimuz/websdk-react, que publica no lançamento; até lá, use o CDN e os eventos DOM quando quiser escutar no template.
Sim. Os guias estão em Android, iOS e React Native. O app recebe do seu backend a credencial da jornada e abre a verificação com ela; a chave de API nunca sai do servidor.O SDK iOS está em preview, fale com o suporte antes de usá-lo em produção.
Sim. O widget renderiza no elemento que você passar em target, seja dentro de um modal, de uma rota ou de qualquer container. Garanta altura ao container: o iframe ocupa 100% dele.
Não. A comunicação entre a sua página e o widget passa por um handshake do Web SDK. Um iframe manual até renderiza para origens autorizadas, mas você não recebe eventos, desfecho nem erros. Use o mount().
Não necessariamente, e não é isso que ele diz. onComplete informa que o fluxo terminou no navegador, e result.status pode ser "abandoned". A decisão da verificação (aprovada, reprovada, em análise) nunca chega ao navegador: ela é entregue ao seu backend. Veja como a decisão chega ao seu backend.
Por webhook, no seu backend, a página do titular não é lugar para o resultado. O evento é verification.decided, e ele chega assinado.
Português do Brasil e inglês. O idioma vem da opção locale do mount(), e valores não suportados caem para pt-BR. Veja as opções da SDK.
Sim, pela opção colorScheme do mount(): passe "light", "dark", ou deixe o default "auto" resolver pela preferência do navegador no momento do mount. Trocar o tema depois do mount não remonta o widget, porque remontar destruiria a sessão em andamento.
Não. O próprio fluxo pede a permissão ao titular na etapa de captura. A sua página precisa apenas não bloquear: se ela define o header Permissions-Policy, a política não pode negar camera para a origem do widget.
Não: ela é credencial de uma verificação de uma pessoa real. Não registre em log, não persista e não envie a tag manager. Veja segurança.
recoverable: true significa que vale tentar de novo, e o widget já orienta o titular na tela. Reserve a sua reação para os não recuperáveis: encerre a tela e ofereça um novo começo. O catálogo completo está em tratamento de erros.
Não achou a resposta? Veja a solução de problemas.