SDKs web de verificação de identidade: JS e iframe

Estes guias cobrem a Verificação de identidade. Para o login do usuário final, use os guias da plataforma de Autenticação; os novos pacotes de Autenticação dependem de lançamento.

Integre a verificação da Didit ao seu aplicativo web. Oferecemos sete métodos de integração para se adequar à sua arquitetura e aos requisitos de experiência do usuário - escolha o que combina com a sua stack.

Escolha seu método de integração: de iframes rápidos sem código ao controle programático total com nosso SDK JavaScript, ou plugins prontos para WordPress, Shopify e Salesforce.

Métodos de integração

Método	Tempo de configuração	Backend?	Ideal para
SDK JavaScript	3 minutos	Opcional	Controle total - React/Vue/Angular/Next.js/Nuxt/Svelte/JS puro
InContext (iframe)	< 1 minuto	Opcional	Experiência incorporada, sem redirecionamento
Redirecionamento	5 minutos	Sim	Máxima compatibilidade, fluxos entre dispositivos
WebView (iOS/Android)	15 minutos	Sim	Alternativa para celular quando não há SDK nativo
WordPress + WooCommerce	5 minutos	Sem código	Sites WordPress, lojas WooCommerce
Shopify	5 minutos	Sem código	Lojas Shopify - verificação no checkout ou na conta
Salesforce	10 minutos	Sem código	Salesforce CRM - verificação de registros de Contato/Lead

Recomendação: em aplicativos web de produção, use o SDK JavaScript para a melhor experiência e o controle programático total. Use o iframe InContext para a configuração mais rápida, o Redirecionamento quando for necessária a verificação entre dispositivos e as integrações dedicadas para WordPress / Shopify / Salesforce se você estiver nessas plataformas.

SDK JavaScript

O SDK JavaScript da Didit oferece uma forma programática de integrar a verificação, com controle total sobre a experiência do usuário. Principais recursos:

Gerenciamento de sessões e callbacks de eventos
Suporte a React, Vue, Angular, NextJS, Nuxt, Svelte e JS puro
Suporte completo a TypeScript
Modos modal e inline

Início rápido:

import { DiditSdk } from '@didit-protocol/sdk-web';

DiditSdk.shared.onComplete = (result) => {
  switch (result.type) {
    case 'completed':
      console.log('Verification completed!');
      console.log('Session ID:', result.session?.sessionId);
      console.log('Status:', result.session?.status);
      break;
    case 'cancelled':
      console.log('User cancelled verification');
      break;
    case 'failed':
      console.error('Verification failed:', result.error?.message);
      break;
  }
};

// Start verification with the `url` returned by POST /v3/session/ (or your UniLink)
DiditSdk.shared.startVerification({
  url: 'https://verify.didit.me/session/3FaJ9wLqX2Mz'
});

→ Documentação completa do SDK JavaScript

InContext (iframe)

Incorpore o fluxo de verificação diretamente no seu aplicativo usando um iframe. Experiência fluida, sem redirecionar os usuários para fora do seu site. Principais recursos:

UniLink (sem backend) - configuração em < 1 minuto
Sessão via API (com backend) - personalização total
Implementações modal e inline
Exemplos de componentes React

Início rápido:

<iframe 
  src="https://verify.didit.me/u/YOUR_WORKFLOW_ID_BASE64"
  style="width: 100%; height: 700px; border: none;" 
  allow="camera; microphone; geolocation; clipboard-write; fullscreen; autoplay; encrypted-media"
></iframe>

→ Documentação completa do InContext

Redirecionamento

Redirecione os usuários para a página de verificação hospedada pela Didit. Ao concluir, os usuários voltam para a sua URL de callback. Principais recursos:

Máxima compatibilidade com navegadores
Suporte à verificação entre dispositivos
Integração simples
Funciona quando o acesso à câmera no iframe é problemático

Início rápido:

// After creating a session via your backend
window.location.href = verificationUrl;

→ Documentação completa do Redirecionamento

Comparação

Recurso	SDK JavaScript	InContext (iframe)	Redirecionamento
Tempo de configuração	3 min	< 1 min	5 min
Backend obrigatório	Opcional	Opcional	Sim
Permanece no seu domínio	Sim	Sim	Não
Suporte entre dispositivos	Sim	Sim	Sim
Controle programático total	Sim	Limitado	Somente callback
Callbacks de eventos	Em tempo real	`postMessage`	Somente callback
Marca própria	Sim	Sim	Sim
Compatibilidade com navegadores	Todos	Todos	Todos

Os três métodos entregam resultados finais assinados por webhooks - a comparação acima descreve a experiência no navegador, não como você recebe a decisão da verificação.

Configuração

Permissões obrigatórias do iframe

Nas integrações com iframe InContext, inclua sempre estas permissões:

allow="camera; microphone; geolocation; clipboard-write; fullscreen; autoplay; encrypted-media"

Repositórios de exemplo

Exemplos do SDK Web

Exemplos em React, Vue, Angular, Next.js, Nuxt, Svelte e JS puro

Exemplo de iframe

Exemplos de iframe com UniLink e com sessão via API

Demo completa em Next.js

Integração de ponta a ponta em Next.js

Pacote NPM

@didit-protocol/sdk-web no npm

Relacionados

Webhooks - receba resultados de verificação assinados no seu backend
API Criar sessão - o endpoint por trás de todos os SDKs web
SDKs nativos - iOS, Android, React Native, Flutter

Guias

Model Context Protocol (MCP)

SDKs web

SDKs nativos

SDKs web de verificação de identidade: JS e iframe

Métodos de integração

SDK JavaScript

InContext (iframe)

Redirecionamento

Comparação

Configuração

Permissões obrigatórias do iframe

Repositórios de exemplo

Exemplos do SDK Web

Exemplo de iframe

Demo completa em Next.js

Pacote NPM

Relacionados

​Métodos de integração

​SDK JavaScript

​InContext (iframe)

​Redirecionamento

​Comparação

​Configuração

​Permissões obrigatórias do iframe

​Repositórios de exemplo

Exemplos do SDK Web

Exemplo de iframe

Demo completa em Next.js

Pacote NPM

​Relacionados

Métodos de integração

SDK JavaScript

InContext (iframe)

Redirecionamento

Comparação

Configuração

Permissões obrigatórias do iframe

Repositórios de exemplo

Relacionados