> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

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

> SDKs web da Didit para KYC, KYB, AML e prova de vida: JavaScript, iframe, redirecionamento ou WebView. A partir de $0.33 por KYC completo.

> [!NOTE]
>
> Estes guias cobrem a Verificação de identidade. Para o login do usuário final, use os [guias da plataforma de Autenticação](https://docs.didit.me/authentication/overview.md); 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.

> [!NOTE]
>
> **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](https://docs.didit.me/integration/web-sdks/javascript-sdk.md) | 3 minutos | Opcional | Controle total - React/Vue/Angular/Next.js/Nuxt/Svelte/JS puro |
| [InContext (iframe)](https://docs.didit.me/integration/web-sdks/incontext-iframe.md) | \< 1 minuto | Opcional | Experiência incorporada, sem redirecionamento |
| [Redirecionamento](https://docs.didit.me/integration/web-sdks/web-redirect.md) | 5 minutos | Sim | Máxima compatibilidade, fluxos entre dispositivos |
| [WebView (iOS/Android)](https://docs.didit.me/integration/web-sdks/webview-in-ios-android.md) | 15 minutos | Sim | Alternativa para celular quando não há SDK nativo |
| [WordPress + WooCommerce](https://docs.didit.me/integration/web-sdks/wordpress-woocommerce.md) | 5 minutos | Sem código | Sites WordPress, lojas WooCommerce |
| [Shopify](https://docs.didit.me/integration/web-sdks/shopify.md) | 5 minutos | Sem código | Lojas Shopify - verificação no checkout ou na conta |
| [Salesforce](https://docs.didit.me/integration/web-sdks/salesforce.md) | 10 minutos | Sem código | Salesforce CRM - verificação de registros de Contato/Lead |

> [!NOTE]
>
> **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:**

```javascript theme={null}
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**](https://docs.didit.me/integration/web-sdks/javascript-sdk.md)

***

## 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:**

```html theme={null}
<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**](https://docs.didit.me/integration/web-sdks/incontext-iframe.md)

***

## 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:**

```javascript theme={null}
// After creating a session via your backend
window.location.href = verificationUrl;
```

→ [**Documentação completa do Redirecionamento**](https://docs.didit.me/integration/web-sdks/web-redirect.md)

***

## 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 |

> [!NOTE]
>
> Os três métodos entregam resultados finais assinados por [webhooks](https://docs.didit.me/integration/webhooks.md) - 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:

```html theme={null}
allow="camera; microphone; geolocation; clipboard-write; fullscreen; autoplay; encrypted-media"
```

***

## Repositórios de exemplo

> **[Exemplos do SDK Web](https://github.com/didit-protocol/sdk-web-examples)**
>
> Exemplos em React, Vue, Angular, Next.js, Nuxt, Svelte e JS puro

> **[Exemplo de iframe](https://github.com/didit-protocol/iframe-example)**
>
> Exemplos de iframe com UniLink e com sessão via API

> **[Demo completa em Next.js](https://github.com/didit-protocol/didit-full-demo)**
>
> Integração de ponta a ponta em Next.js

> **[Pacote NPM](https://www.npmjs.com/package/@didit-protocol/sdk-web)**
>
> `@didit-protocol/sdk-web` no npm

## Relacionados

* [Webhooks](https://docs.didit.me/integration/webhooks.md) - receba resultados de verificação assinados no seu backend
* [API Criar sessão](https://docs.didit.me/sessions-api/create-session.md) - o endpoint por trás de todos os SDKs web
* [SDKs nativos](https://docs.didit.me/pt-br/integration/native-sdks/overview.md) - iOS, Android, React Native, Flutter


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.