Pular para o conteúdo principal
Didit levanta US$ 7,5 milhões para construir a infraestrutura para identidade e fraude
Didit
Voltar para o blog
Blog · 15 de março de 2026

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.

Por DiditAtualizado
didit-iframe-integration-guide.png

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:

Infraestrutura para identidade e fraude.

Uma API para KYC, KYB, Monitoramento de Transações e Análise de Carteiras. Integre em 5 minutos.

Peça para uma IA resumir esta página
Integração Didit Iframe: Verificação de Identidade Fácil.