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

Estas guias cobrem a verificação de identidade. Para o início de sessão dos utilizadores finais, use as guias da plataforma de Autenticação; os novos pacotes de Autenticação dependem da versão lançada.

Integre a verificação Didit na sua aplicação web. Oferecemos sete métodos de integração para se adaptarem à sua arquitetura e aos seus requisitos de experiência do utilizador. Escolha o que corresponde à sua stack.

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

Métodos de integração

Método	Tempo de configuração	Backend?	Ideal para
JavaScript SDK	3 minutos	Opcional	Controlo total — React/Vue/Angular/Next.js/Nuxt/Svelte/JS puro
InContext (Iframe)	< 1 minuto	Opcional	Experiência incorporada sem redirecionamento
Redirect	5 minutos	Sim	Máxima compatibilidade, fluxos entre dispositivos
WebView (iOS/Android)	15 minutos	Sim	Alternativa para dispositivos móveis quando não existe 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	CRM Salesforce — verificação de registos de Contacto/Lead

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

JavaScript SDK

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

Gestão de sessões e callbacks de eventos
Suporte para React, Vue, Angular, NextJS, Nuxt, Svelte e JavaScript puro
Suporte total para 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 JavaScript SDK

InContext (Iframe)

Incorpore o fluxo de verificação diretamente na sua aplicação através de um iframe. Experiência fluida, sem redirecionar os utilizadores para fora do seu site. Principais funcionalidades:

UniLink (sem necessidade de backend) — configuração em < 1 minuto
Sessão de API (com backend) — personalização completa
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; digital-credentials-get"
></iframe>

→ Documentação completa do InContext

Redirect

Redirecione os utilizadores para a página de verificação alojada pela Didit. Após a conclusão, os utilizadores regressam ao seu URL de retorno. Principais funcionalidades:

Máxima compatibilidade com navegadores
Suporte para verificação entre dispositivos
Integração simples
Funciona quando o acesso à câmara através de iframe é problemático

Início rápido:

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

→ Documentação completa do Redirect

Comparação

Funcionalidade	JavaScript SDK	InContext (Iframe)	Redirect
Tempo de configuração	3 min	< 1 min	5 min
Backend necessário	Opcional	Opcional	Sim
Permanece no seu domínio	Sim	Sim	Não
Suporte entre dispositivos	Sim	Sim	Sim
Controlo programático total	Sim	Limitado	Apenas callback
Callbacks de eventos	Em tempo real	`postMessage`	Apenas callback
Marca branca	Sim	Sim	Sim
Compatibilidade com navegadores	Todos	Todos	Todos

Os três métodos entregam resultados finais e assinados através de webhooks. A comparação acima descreve a experiência no navegador, não a forma como recebe a decisão de verificação.

Configuração

Permissões obrigatórias do iframe

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

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

Repositórios de exemplo

Exemplos do SDK Web

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

Exemplo de iframe

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

Demo completa em Next.js

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

Pacote NPM

@didit-protocol/sdk-web no npm

Relacionados

Webhooks — receba resultados de verificação assinados no seu backend
API de criação de sessão — o endpoint por detrás de cada SDK web
SDKs nativos — iOS, Android, React Native, Flutter

Guias

Autenticação

Model Context Protocol (MCP)

SDKs web

SDKs nativos

SDKs de servidor

Integrações

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

Métodos de integração

JavaScript SDK

InContext (Iframe)

Redirect

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

​JavaScript SDK

​InContext (Iframe)

​Redirect

​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

JavaScript SDK

InContext (Iframe)

Redirect

Comparação

Configuração

Permissões obrigatórias do iframe

Repositórios de exemplo

Relacionados