Estamos revisando estes procedimentos. Pessoas técnicas podem encontrar ajustes em códigos de erro ou mapeamentos de payload; valide com os logs e o OpenAPI mais recente. Pessoas não técnicas podem continuar usando o passo a passo e acionar o time de suporte caso algo pareça diferente do descrito.
🔐 Motor de Biometria
Bem-vindo à documentação do Motor de Biometria! Esta seção contém guias completos sobre como integrar a solução de biometria em diferentes plataformas e tecnologias.
Documentos Disponíveis
1. Acordos WebView Biometria
Documentação fundamental que descreve os acordos e padrões para integração da WebView de biometria. Este documento é essencial para entender:
- Tipos de eventos (OnInit, OnFinished, OnError)
- Padrões de comunicação via postMessage
- Estrutura de dados e retornos
- Configurações de inicialização
Leia este documento primeiro para compreender os conceitos básicos antes de implementar em uma plataforma específica.
2. WebView em Janela Popup (Web)
Guia para implementação da biometria utilizando janela popup em aplicações web. Inclui:
- Configuração de popup window
- Comunicação entre janela principal e popup
- Tratamento de eventos em desktop e mobile
- Polling para detecção de fechamento (mobile)
Ideal para: Aplicações web SPA (Single Page Application) e sistemas baseados em navegador.
3. WebView no Android Nativo
Documentação completa para integração em aplicações Android nativas usando Kotlin e Jetpack Compose:
- Configuração do AndroidX Webkit
- Implementação com Jetpack Compose
- Interface JavaScript com código nativo
- Gerenciamento de permissões
- Injeção de código JavaScript
Ideal para: Aplicativos Android nativos desenvolvidos em Kotlin.
4. WebView no React Native
Guia de implementação para aplicações React Native:
- Configuração do react-native-webview
- Injeção de JavaScript
- Tipagem TypeScript
- Tratamento de eventos
- Compatibilidade entre plataformas (iOS e Android)
Ideal para: Aplicativos mobile cross-platform desenvolvidos em React Native.
Fluxo de Integração Recomendado
- Leia o documento de Acordos para entender os conceitos básicos
- Escolha sua plataforma e siga o guia específico
- Implemente o evento OnInit com os tokens necessários
- Implemente os handlers para OnFinished e OnError
- Teste todos os cenários (aprovação, negação, fechamento, erros)
Conceitos Importantes
Eventos Principais
- OnInit: Inicialização da WebView com tokens e configurações
- OnFinished: Conclusão do processo (com decisão: APPROVED, DENIED ou CLOSE)
- OnError: Erro durante o processo
Tokens Obrigatórios
- authorization: Token de autorização da API
- token: Token com informações do cliente
Configurações Opcionais
- theme: Personalização de cores (primaryColor, buttonTextColor)
- isOperador: Flag para alterar textos da interface
Suporte
Para dúvidas ou problemas na integração, consulte a documentação específica da sua plataforma ou entre em contato com o suporte técnico.