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

# Ligações de verificação: URLs KYC alojados e códigos QR

> Crie ligações e códigos QR de verificação seguros com a Didit, na consola ou via API. Verificação de identidade alojada em minutos, sem frontend.

A Verification Link é um URL único e seguro que encaminha o seu utilizador final para um fluxo de verificação alojado inteiramente pela Didit. Você desenha as etapas e a lógica da verificação na sua Business Console, e a Didit trata da interface de utilizador, da captura de dados e da segurança. Isto permite-lhe lançar um processo de verificação robusto em minutos, muitas vezes sem necessidade de código.

Este método faz parte do percurso de integração **Fluxos Orquestrados**, oferecendo-lhe o poder do motor de fluxos com a máxima simplicidade.

***

## Como funciona

**1. Configure o seu fluxo**

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

**2. Gere uma ligação de verificação**

Crie uma sessão única para um utilizador. Isto pode ser feito **sem código** diretamente a partir da Business Console, ou **com pouco código** através de uma única chamada à API para o endpoint [Create Session](https://docs.didit.me/pt/sessions-api/create-session.md).

**3. Partilhe a ligação**

Envie o URL gerado ao seu utilizador por qualquer canal — e-mail, SMS, mensagem na aplicação — ou incorpore-o num iframe.

**4. Obtenha resultados em tempo real**

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

***

## Gerar ligações de verificação

### Método 1: Geração sem código (através da Business Console)

O método ideal para começar de imediato, para processos manuais ou para equipas sem recursos de programação.

1. Aceda à secção **Verificações** na sua [Didit Business Console](https://business.didit.me).
2. Clique em **+ Create Verification**.
3. Selecione o `workflow_id` que pretende usar para esta sessão.
4. Opcionalmente, introduza `vendor_data` (como um ID de utilizador do seu sistema) para associar a verificação ao seu utilizador.
5. São gerados instantaneamente um **URL único e um código QR**.
6. Copie a ligação, peça ao utilizador que leia o código QR ou envie a ligação diretamente para o e-mail do utilizador.

### Método 2: Geração com pouco código (através da API)

Este método oferece automatização total e é a forma padrão de integrar as ligações de verificação na lógica da sua aplicação.

Envie um único pedido `POST` para o endpoint `/v3/session/` com a 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 devolve um objeto JSON que contém o `session_id` e o `url` único 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]
>
> Os detalhes completos da API estão disponíveis na [referência da API Create Session](https://docs.didit.me/pt/sessions-api/create-session.md).

***

## Quando usar ligações de verificação

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

> [card] Sem desenvolvimento de frontend
>
> Deixe toda a interface de utilizador — captura do documento, verificações de prova de vida e orientação ao utilizador — a cargo da interface pré-construída da Didit.

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

> [card] Onboarding presencial
>
> Use o código QR em cenários presenciais, em que o utilizador precisa de concluir a verificação no seu próprio dispositivo.

***

## Próximos passos

* **Configure o seu primeiro fluxo** — aceda à [Business Console](https://business.didit.me) para desenhar o seu percurso de verificação.
* **Configure os seus webhooks** — saiba como receber atualizações de estado em tempo real no guia [Gerir webhooks](https://docs.didit.me/pt/integration/webhooks.md).
* **Explore as Unilinks** — para uma alternativa reutilizável e sem backend, consulte [Unilinks](https://docs.didit.me/pt/console/uni-links.md).


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