Integração e UX Dinâmica: Personalizar o iFrame da Didit com JavaScript (PT-PT)
Descubra como usar JavaScript para personalizar dinamicamente o iFrame de verificação incorporado da Didit, garantindo uma experiência de utilizador fluida e alinhada à sua marca.

Integração PerfeitaIntegre a robusta verificação de identidade da Didit diretamente na sua aplicação web usando o método InContext iFrame, oferecendo uma configuração rápida e uma experiência incorporada.
Personalização DinâmicaUtilize a API
postMessagedo JavaScript para comunicar e estilizar dinamicamente o iFrame incorporado, garantindo que a imagem da sua marca seja consistentemente mantida durante todo o processo de verificação.Experiência de Utilizador MelhoradaLide com eventos em tempo real do iFrame, como a conclusão ou cancelamento da verificação, para fornecer feedback imediato e guiar os utilizadores através de uma jornada suave e alinhada à marca.
Arquitetura Flexível da DiditA abordagem modular e focada no programador da Didit, incluindo o InContext iFrame e o SDK JavaScript, capacita os programadores a construir fluxos de verificação de identidade altamente personalizados e eficientes com KYC Core Gratuito.
Integrar o iFrame InContext da Didit para Verificação de Identidade
No panorama digital atual, a verificação robusta de identidade é primordial para a segurança, conformidade e prevenção de fraude. A Didit oferece uma gama de métodos de integração, e para empresas que procuram uma configuração rápida com uma experiência incorporada, o iFrame InContext destaca-se. Este método permite-lhe incorporar as poderosas capacidades de Verificação de Identidade da Didit diretamente na sua aplicação web, mantendo os utilizadores no seu domínio. Embora simples de implementar, o verdadeiro poder do iFrame reside na sua capacidade de ser dinamicamente personalizado usando JavaScript, transformando um fluxo de verificação padrão numa jornada de utilizador perfeitamente alinhada à marca.
O iFrame InContext é ideal para cenários onde se pretende um processo de verificação contido sem redirecionar os utilizadores. Suporta tanto UniLink (sem necessidade de backend para configuração rápida) como API Session (para personalização completa com um backend). Ao incorporar o iFrame, pode aproveitar as funcionalidades avançadas da Didit, incluindo OCR, análise de MRZ e descodificação de códigos de barras para verificação de documentos, mantendo o controlo sobre a interface de utilizador envolvente.
Personalização Dinâmica com a API postMessage do JavaScript
Embora um iFrame proporcione uma experiência incorporada, manter a consistência da marca em toda a jornada do utilizador é crucial. É aqui que a API postMessage do JavaScript se torna inestimável. Uma vez que o iFrame carrega conteúdo de uma origem diferente (o serviço de verificação da Didit), a manipulação direta do DOM é bloqueada pela política de mesma origem. No entanto, postMessage permite uma comunicação segura entre origens diferentes entre a sua página principal e o iFrame da Didit incorporado.
Ao ouvir eventos ou mensagens específicas do iFrame e enviar mensagens para ele, pode ajustar dinamicamente a sua aparência ou comportamento. Por exemplo, pode querer:
- Alterar a altura ou largura do iFrame com base no conteúdo carregado.
- Desencadear ações específicas na sua página principal quando um passo de verificação é concluído dentro do iFrame.
- Passar parâmetros de estilo para o iFrame para corresponder ao tema da sua aplicação, se suportado pela configuração do iFrame da Didit.
Uma configuração típica envolve:
- Incorporar o iFrame da Didit com o seu atributo
srca apontar para o URL de verificação (por exemplo,https://verify.didit.me/u/YOUR_WORKFLOW_ID_BASE64). - Adicionar um ouvinte de eventos à sua janela principal para capturar mensagens do iFrame:
window.addEventListener('message', (event) => {
// Certifique-se de que a mensagem é de uma origem fidedigna (domínio da Didit)
if (event.origin !== 'https://verify.didit.me') return;
const data = event.data;
if (data.type === 'didit-verification-event') {
console.log('Evento do iFrame da Didit:', data.payload);
// Lidar com eventos como 'verification_completed', 'verification_failed', etc.
}
});
Isto permite que a sua aplicação reaja inteligentemente ao estado do iFrame, guiando a experiência do utilizador de forma mais eficaz.
Melhorar a Experiência do Utilizador e a Gestão de Eventos
Uma experiência de utilizador verdadeiramente perfeita vai além da simples incorporação. Envolve fornecer feedback claro, gerir estados e lidar graciosamente com diferentes resultados do processo de verificação. A integração do iFrame da Didit, especialmente quando combinada com JavaScript, permite uma gestão sofisticada de eventos que pode melhorar significativamente a UX.
Por exemplo, após uma verificação bem-sucedida (que o seu backend confirmaria via webhooks), pode fechar programaticamente o modal que contém o iFrame, exibir uma mensagem de sucesso e integrar o utilizador. Se uma verificação falhar ou for cancelada, pode fornecer opções para tentar novamente ou contactar o suporte.
Considere um cenário em que está a usar a Verificação de Identidade da Didit para integrar novos utilizadores. Depois de o utilizador concluir a captura e submissão do documento dentro do iFrame, a Didit processa os dados, incluindo a realização de verificações de Vida Passiva e Ativa para prevenir fraudes de deepfake. O seu backend recebe um webhook com os resultados da verificação. Pode então usar JavaScript para:
- Esconder um indicador de carregamento assim que o iFrame envia um evento 'verification_submitted'.
- Atualizar a UI para mostrar 'Verificação Pendente' enquanto o seu backend processa o webhook.
- Exibir 'Verificação Aprovada' ou 'Verificação Recusada' com base no estado final recebido pelo seu backend e comunicado de volta ao frontend.
Este nível de interação dinâmica garante que os utilizadores estão sempre informados e envolvidos, reduzindo as taxas de abandono e construindo confiança na sua plataforma.
Escolher a Integração Certa: iFrame vs. SDK JavaScript
Embora o iFrame InContext ofereça uma configuração rápida e conveniência incorporada, a Didit também fornece um poderoso SDK JavaScript para aqueles que exigem o máximo controlo programático. O SDK, recomendado para aplicações de produção, oferece gestão de sessão, callbacks de eventos e suporte completo a TypeScript, tornando-o ideal para aplicações complexas construídas com React, Vue, Angular ou JS puro.
O iFrame é excelente para um tempo de configuração mínimo, muitas vezes inferior a 1 minuto, e para cenários onde é necessário um fluxo de verificação contido e pronto a usar. No entanto, para callbacks de eventos em tempo real e controlo programático completo sobre o fluxo do utilizador, o SDK JavaScript oferece flexibilidade superior. Ambos os métodos suportam verificação entre dispositivos e personalização (white-labeling), garantindo a consistência da marca.
O compromisso da Didit com uma abordagem focada no programador significa que tem opções para integrar a verificação de identidade da forma que melhor se adapta à sua pilha tecnológica e objetivos de experiência do utilizador. Seja através da simplicidade do iFrame ou do poder do SDK, pode aproveitar a plataforma nativa de IA da Didit para construir fluxos de trabalho de identidade seguros e eficientes.
Como a Didit Ajuda
A Didit fornece os blocos de construção fundamentais para criar experiências de verificação de identidade altamente personalizáveis e seguras. A nossa arquitetura modular permite-lhe "plug-and-play" verificações de identidade como Verificação de Identidade, Vida Passiva e Ativa, e Correspondência Facial 1:1 e Pesquisa Facial, todas alimentadas por IA de ponta. Para soluções incorporadas, o iFrame InContext oferece uma configuração incrivelmente rápida, permitindo-lhe implementar uma verificação robusta com o mínimo esforço. Para aqueles que exigem uma integração mais profunda e controlo dinâmico, o nosso SDK JavaScript fornece as ferramentas para construir jornadas de utilizador personalizadas, gerir eventos em tempo real e manter uma continuidade completa da marca.
A plataforma da Didit foi concebida para ser "developer-first", oferecendo um sandbox instantâneo, documentação pública abrangente e APIs limpas. Eliminamos taxas de configuração e oferecemos um nível de KYC Core Gratuito, tornando a verificação de identidade de nível empresarial acessível. A nossa abordagem nativa de IA garante alta precisão e automação, reduzindo a necessidade de revisões manuais e otimizando as suas operações. Com a Didit, pode orquestrar o risco e automatizar a confiança globalmente, garantindo uma experiência segura e fácil de usar para os seus clientes, ao mesmo tempo que cumpre os requisitos de conformidade.
Pronto para Começar?
Pronto para ver a Didit em ação? Obtenha uma demonstração gratuita hoje.
Comece a verificar identidades gratuitamente com o nível gratuito da Didit.