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

# Links de verificação: URLs de KYC hospedado e QR codes

> Crie links de verificação e QR codes seguros no console ou na API da Didit e lance KYC hospedado em minutos, sem desenvolver frontend.

Um link de verificação é uma URL única e segura que direciona o usuário final para um fluxo de verificação hospedado inteiramente pela Didit. Você define as etapas e a lógica da verificação no seu Business Console, e a Didit cuida da interface do usuário, da captura de dados e da segurança. Assim, você lança um processo de verificação robusto em minutos, muitas vezes sem escrever código.

Esse método faz parte do caminho de integração **Orchestrated Workflows**, que oferece todo o poder do mecanismo de fluxos de trabalho com o máximo de simplicidade.

***

## Como funciona

**1. Configure seu fluxo de verificação (workflow)**

No [Didit Business Console](https://business.didit.me), use o editor sem código para criar um fluxo com a sequência exata de verificações de que você precisa (por exemplo, leitura do documento de identidade → prova de vida → Triagem AML). Cada fluxo tem um `workflow_id` único.

**2. Gere um link de verificação**

Crie uma sessão única para um usuário. Isso pode ser feito **sem código**, diretamente no Business Console, ou **low-code**, por meio de uma única chamada de API ao endpoint [Create Session](https://docs.didit.me/pt-br/sessions-api/create-session.md).

**3. Compartilhe o link**

Envie a URL gerada ao usuário por qualquer canal (e-mail, SMS, mensagem no aplicativo) ou incorpore-a em um iframe.

**4. Receba os resultados em tempo real**

A Didit envia atualizações automáticas para a [URL do webhook](https://docs.didit.me/pt-br/integration/webhooks.md) configurada à medida que o usuário avança e quando o resultado final da verificação fica pronto.

***

## Como gerar links de verificação

### Método 1: geração sem código (pelo Business Console)

O método ideal para começar imediatamente, para processos manuais ou para equipes sem desenvolvedores disponíveis.

1. Acesse a seção **Verifications** no seu [Didit Business Console](https://business.didit.me).
2. Clique em **+ Create Verification**.
3. Selecione o `workflow_id` que você quer usar nesta sessão.
4. Se quiser, informe `vendor_data` (como um ID de usuário do seu sistema) para associar a verificação ao seu usuário.
5. Uma **URL única e um QR code** são gerados na hora.
6. Copie o link, peça ao usuário que leia o QR code ou envie o link diretamente para o e-mail do usuário.

### Método 2: geração com pouco código (pela API)

Esse método oferece automação completa e é a forma padrão de integrar links de verificação à lógica da sua aplicação.

Envie uma única requisição `POST` ao endpoint `/v3/session/` com sua chave de API e o `workflow_id`:

```bash theme={null}
curl --request POST \
     --url https://verification.didit.me/v3/session/ \
     --header 'x-api-key: YOUR_API_KEY' \
     --header 'Content-Type: application/json' \
     --data '{
       "workflow_id": "550e8400-e29b-41d4-a716-446655440000",
       "vendor_data": "your_internal_user_id_123",
       "callback": "https://yourapp.com/didit/webhook/handler"
     }'
```

A API retorna um objeto JSON com o `session_id` e a `url` única de verificação:

```json theme={null}
{
  "session_id": "11111111-2222-3333-4444-555555555555",
  "session_number": 1234,
  "vendor_data": "your_internal_user_id_123",
  "status": "Not Started",
  "workflow_id": "550e8400-e29b-41d4-a716-446655440000",
  "callback": "https://yourapp.com/didit/webhook/handler",
  "url": "https://verify.didit.me/session/abcdef123456"
}
```

> [!NOTE]
>
> Todos os detalhes da API estão na [referência da API Create Session](https://docs.didit.me/pt-br/sessions-api/create-session.md).

***

## Quando usar links de verificação

> [card] Agilidade de lançamento
>
> Lance um processo de verificação completo, seguro e em conformidade em horas, não em semanas.

> [card] Sem desenvolvimento de frontend
>
> Delegue à interface pré-criada da Didit toda a interface do usuário (captura de documentos, verificações de vivacidade e orientações ao usuário).

> [card] Entrega multicanal
>
> Envie solicitações de verificação por e-mail, SMS, chat de suporte ou qualquer outro canal de comunicação.

> [card] Onboarding presencial
>
> Use o QR code em situações presenciais em que o usuário precisa concluir a verificação no próprio dispositivo.

***

## Próximos passos

* **Configure seu primeiro fluxo**: acesse o [Business Console](https://business.didit.me) para criar sua jornada de verificação.
* **Configure seus webhooks**: saiba como receber atualizações de status em tempo real no guia [Handling Webhooks](https://docs.didit.me/pt-br/integration/webhooks.md).
* **Conheça os Unilinks**: para uma alternativa reutilizável e sem backend, veja [Unilinks](https://docs.didit.me/pt-br/console/uni-links.md).


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