Verificação de Identidade Simplificada: Guia de Integração por Iframe Didit (PT-BR)
Aprenda a integrar a verificação de identidade de forma rápida e segura em sua aplicação web usando a solução de iframe incorporado da Didit.

Verificação de Identidade Simplificada: Guia de Integração por Iframe Didit
No cenário digital atual, uma experiência de usuário sem atritos é fundamental. A verificação de identidade é frequentemente um mal necessário, introduzindo fricção nos fluxos de integração e conversão. A Didit resolve esse desafio com uma poderosa e fácil de implementar integração por iframe, permitindo que você incorpore um fluxo de verificação de identidade seguro e compatível diretamente em sua aplicação web. Este guia fornece uma visão geral abrangente do processo de integração do iframe Didit, opções de configuração e melhores práticas para maximizar a experiência do usuário e a segurança.
Ponto Chave 1: A integração por iframe da Didit oferece uma maneira segura e compatível de incorporar a verificação de identidade diretamente em sua aplicação web, sem integrações complexas no lado do servidor.
Ponto Chave 2: A abordagem do iframe minimiza o esforço de desenvolvimento e permite a implantação rápida de recursos de verificação de identidade.
Ponto Chave 3: A personalização da aparência e do comportamento do iframe está disponível por meio de parâmetros e ouvintes de eventos prontamente disponíveis.
Ponto Chave 4: Os preços de pagamento conforme o uso da Didit garantem que você pague apenas pelas verificações bem-sucedidas, tornando-a uma solução econômica.
Entendendo a Integração por Iframe Didit
O processo de verificação de identidade incorporada usando um iframe envolve hospedar o fluxo de verificação da Didit dentro de um elemento iframe seguro em seu site. Essa abordagem oferece vários benefícios:
- Redução do Esforço de Desenvolvimento: É necessário um código mínimo no lado do servidor. O trabalho pesado da verificação de identidade é tratado pela plataforma da Didit.
- Segurança Aprimorada: A infraestrutura de segurança da Didit é isolada dentro do iframe, minimizando o risco de violações de dados.
- Melhor Experiência do Usuário: Os usuários permanecem em seu site durante todo o processo de verificação, criando uma experiência perfeita.
- Tempo de Lançamento Mais Rápido: Implante rapidamente recursos de verificação de identidade sem ciclos de desenvolvimento extensivos.
O princípio fundamental é gerar uma URL de verificação segura da API da Didit e, em seguida, incorporar essa URL dentro de uma tag <iframe> em seu HTML. Essa URL contém todos os parâmetros necessários para iniciar o fluxo de verificação, incluindo o identificador do usuário, o tipo de verificação e quaisquer configurações personalizadas.
Configuração e Parâmetros do Iframe
A configuração do iframe é controlada por meio de vários parâmetros-chave anexados à URL de verificação. Aqui estão alguns parâmetros essenciais:
user_id: (Obrigatório) Um identificador exclusivo para o usuário.verification_type: (Obrigatório) Especifica o tipo de fluxo de verificação (por exemplo,id_verification,liveness,document_verification).redirect_url: (Opcional) A URL para redirecionar o usuário após a conclusão da verificação (sucesso ou falha).theme: (Opcional) Personalize a aparência do iframe (por exemplo,light,dark).width: (Opcional) Define a largura do iframe em pixels (padrão: 600px).height: (Opcional) Define a altura do iframe em pixels (padrão: 700px).language: (Opcional) Especifica o idioma do fluxo de verificação (por exemplo,en,es,fr).
Exemplo de URL:
https://business.didit.me/iframe?user_id=user123&verification_type=id_verification&redirect_url=https://seusite.com/verificacao-concluida&theme=dark&width=800&height=800
Implementando o Iframe em Sua Aplicação Web
Integrar a integração por iframe da Didit em sua aplicação é simples. Aqui está um exemplo básico de HTML:
<iframe src="https://business.didit.me/iframe?user_id=user123&verification_type=id_verification&redirect_url=https://seusite.com/verificacao-concluida" width="800" height="800" frameborder="0"></iframe>
Considerações Importantes:
- HTTPS: Certifique-se de que seu site seja servido por HTTPS para manter a segurança.
- CORS: O iframe da Didit está configurado para suportar solicitações de origem cruzada.
- Responsividade: Considere usar técnicas de design responsivo para garantir que o iframe se adapte a diferentes tamanhos de tela.
Gerenciando Eventos e Retornos de Verificação
A Didit fornece ouvintes de eventos e retornos de chamada para notificar sua aplicação sobre o processo de verificação. O mecanismo principal é a API postMessage. Você pode ouvir eventos como verification_started, verification_completed, verification_failed e verification_error. Esses eventos contêm dados sobre o status da verificação, incluindo quaisquer mensagens de erro ou resultados da verificação.
Exemplo de Ouvinte de Eventos JavaScript:
window.addEventListener('message', function(event) {
if (event.origin !== 'https://business.didit.me') {
return;
}
const data = JSON.parse(event.data);
switch (data.event) {
case 'verification_completed':
console.log('Verificação concluída com sucesso:', data.result);
// Redirecione o usuário ou atualize a interface do usuário
break;
case 'verification_failed':
console.error('Verificação falhou:', data.error);
// Exiba uma mensagem de erro para o usuário
break;
}
});
Como a Didit Ajuda
A Didit simplifica o processo de verificação de identidade incorporada com:
- Suíte de Verificação Abrangente: Acesse uma ampla gama de módulos de verificação, incluindo verificação de identidade, detecção de vivacidade, triagem AML e muito mais.
- API Amigável para Desenvolvedores: API e SDKs bem documentados para integração perfeita.
- Infraestrutura Escalável: Lide com grandes volumes de solicitações de verificação com facilidade.
- Cobertura Global: Suporte para mais de 14.000 tipos de documentos em mais de 220 países.
- Preços Competitivos: Preços de pagamento conforme o uso, sem taxas ocultas.
Pronto para Começar?
Comece a construir uma experiência mais segura e amigável hoje! Explore nossa documentação e comece com uma conta Didit gratuita: