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

# Link di verifica: URL KYC ospitati e codici QR

> Crea link di verifica sicuri e codici QR dalla console Didit o dall'API. Avvia la verifica dell'identità ospitata in pochi minuti, senza sviluppo frontend.

A Verification Link è un URL unico e sicuro che indirizza il tuo utente finale verso un flusso di verifica ospitato interamente da Didit. Progetti i passaggi e la logica della verifica nella tua Business Console, mentre Didit gestisce l'interfaccia utente, la raccolta dei dati e la sicurezza. Questo ti consente di avviare un processo di verifica solido in pochi minuti, spesso senza scrivere codice.

Questo metodo fa parte del percorso di integrazione **Orchestrated Workflows**, che ti offre la potenza del motore dei workflow con la massima semplicità.

***

## Come funziona

**1. Configura il tuo workflow**

Nella [Didit Business Console](https://business.didit.me), usa l'editor no-code per progettare un workflow con la sequenza esatta di controlli di cui hai bisogno (ad esempio, Scansione del documento d'identità → Controllo di vitalità → Screening AML). Ogni workflow ha un `workflow_id` univoco.

**2. Genera un link di verifica**

Crea una sessione univoca per un utente. Può essere fatto **no-code** direttamente dalla Business Console, oppure **low-code** tramite una singola chiamata API all'endpoint [Create Session](https://docs.didit.me/it/sessions-api/create-session.md).

**3. Condividi il link**

Invia l'URL generato al tuo utente tramite qualsiasi canale — email, SMS, messaggio in-app — oppure incorporalo in un iframe.

**4. Ricevi i risultati in tempo reale**

Didit invia aggiornamenti automatici all'[URL del webhook](https://docs.didit.me/it/integration/webhooks.md) configurato man mano che l'utente avanza e quando il risultato finale della verifica è pronto.

***

## Generare i link di verifica

### Metodo 1: Generazione no-code (tramite Business Console)

Il metodo ideale per iniziare subito, per processi manuali o per team senza risorse di sviluppo.

1. Vai alla sezione **Verifiche** nella tua [Didit Business Console](https://business.didit.me).
2. Fai clic su **+ Create Verification**.
3. Seleziona il `workflow_id` che vuoi usare per questa sessione.
4. Facoltativamente, inserisci `vendor_data` (ad esempio un ID utente del tuo sistema) per associare la verifica al tuo utente.
5. Vengono generati immediatamente un **URL univoco e un codice QR**.
6. Copia il link, fai scansionare il codice QR all'utente oppure invia il link direttamente all'email dell'utente.

### Metodo 2: Generazione low-code (tramite API)

Questo metodo offre piena automazione ed è il modo standard per integrare i link di verifica nella logica della tua applicazione.

Invia una singola richiesta `POST` all'endpoint `/v3/session/` con la tua chiave API e il `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"
     }'
```

L'API restituisce un oggetto JSON contenente il `session_id` e l'`url` di verifica univoco:

```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]
>
> I dettagli completi dell'API sono disponibili nel [riferimento dell'API Create Session](https://docs.didit.me/it/sessions-api/create-session.md).

***

## Quando usare i link di verifica

> [card] Rapidità di lancio
>
> Avvia un processo di verifica completo, sicuro e conforme in poche ore, non in settimane.

> [card] Nessuno sviluppo frontend
>
> Delega l'intera interfaccia utente — acquisizione del documento, controlli di vitalità e guida per l'utente — all'interfaccia predefinita di Didit.

> [card] Consegna multicanale
>
> Invia le richieste di verifica tramite email, SMS, chat di supporto o qualsiasi altro canale di comunicazione.

> [card] Onboarding fisico
>
> Usa il codice QR per scenari in presenza in cui un utente deve completare la verifica sul proprio dispositivo.

***

## Prossimi passi

* **Configura il tuo primo workflow** — vai alla [Business Console](https://business.didit.me) per progettare il tuo percorso di verifica.
* **Configura i tuoi webhook** — scopri come ricevere aggiornamenti di stato in tempo reale nella guida [Gestione dei webhook](https://docs.didit.me/it/integration/webhooks.md).
* **Esplora Unilinks** — per un'alternativa riutilizzabile e senza backend, consulta [Unilinks](https://docs.didit.me/it/console/uni-links.md).


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