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

# SDK di verifica dell'identità web: JavaScript e iframe

> SDK Didit per KYC, KYB, AML e liveness sul web: JavaScript, iframe, redirect o WebView. Da $0.33 per verifica KYC completa, $10 gratis al mese.

> [!NOTE]
>
> Queste guide riguardano la verifica dell'identità. Per l'accesso degli utenti finali, usa le [guide della piattaforma Authentication](https://docs.didit.me/it/authentication/overview.md); i nuovi pacchetti Authentication dipendono dalla release.

Integra la verifica Didit nella tua applicazione web. Offriamo sette metodi di integrazione per adattarsi alla tua architettura e ai requisiti di esperienza utente: scegli quello più adatto al tuo stack.

> [!NOTE]
>
> **Scegli il tuo metodo di integrazione**: dagli iframe senza codice, per una configurazione rapida, al controllo programmatico completo con il nostro SDK JavaScript, oppure plugin pronti all'uso per WordPress, Shopify e Salesforce.

***

## Metodi di integrazione

| Metodo | Tempo di configurazione | Backend? | Ideale per |
| - | - | - | - |
| [SDK JavaScript](https://docs.didit.me/it/integration/web-sdks/javascript-sdk.md) | 3 minuti | Opzionale | Controllo completo: React/Vue/Angular/Next.js/Nuxt/Svelte/vanilla |
| [InContext (Iframe)](https://docs.didit.me/it/integration/web-sdks/incontext-iframe.md) | \< 1 minuto | Opzionale | Esperienza integrata senza reindirizzamento |
| [Redirect](https://docs.didit.me/it/integration/web-sdks/web-redirect.md) | 5 minuti | Sì | Massima compatibilità, flussi cross-device |
| [WebView (iOS/Android)](https://docs.didit.me/it/integration/web-sdks/webview-in-ios-android.md) | 15 minuti | Sì | Alternativa mobile quando non è disponibile un SDK nativo |
| [WordPress + WooCommerce](https://docs.didit.me/it/integration/web-sdks/wordpress-woocommerce.md) | 5 minuti | Nessun codice | Siti WordPress, negozi WooCommerce |
| [Shopify](https://docs.didit.me/it/integration/web-sdks/shopify.md) | 5 minuti | Nessun codice | Negozi Shopify: verifica al checkout o dell'account |
| [Salesforce](https://docs.didit.me/it/integration/web-sdks/salesforce.md) | 10 minuti | Nessun codice | CRM Salesforce: verifica dei record Contact/Lead |

> [!NOTE]
>
> **Raccomandazione**: per le applicazioni web in produzione, usa l'**SDK JavaScript** per la migliore UX e il controllo programmatico completo. Usa l'**iframe InContext** per la configurazione più rapida, **Redirect** quando serve la verifica cross-device, e le integrazioni dedicate **WordPress / Shopify / Salesforce** se lavori su queste piattaforme.

***

## SDK JavaScript

L'SDK JavaScript di Didit offre un modo programmatico per integrare la verifica, con il controllo completo dell'esperienza utente.

**Funzionalità principali:**

* Gestione delle sessioni e callback degli eventi
* Supporto per React, Vue, Angular, NextJS, Nuxt, Svelte e JS vanilla
* Supporto TypeScript completo
* Modalità modale e inline

**Avvio rapido:**

```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'
});
```

→ [**Documentazione completa dell'SDK JavaScript**](https://docs.didit.me/it/integration/web-sdks/javascript-sdk.md)

***

## InContext (Iframe)

Integra il flusso di verifica direttamente nella tua applicazione tramite un iframe. Un'esperienza fluida, senza reindirizzare gli utenti fuori dal tuo sito.

**Funzionalità principali:**

* UniLink (nessun backend richiesto): configurazione in \< 1 minuto
* Sessione API (con backend): personalizzazione completa
* Implementazioni modali e inline
* Esempi di componenti React

**Avvio rapido:**

```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; digital-credentials-get"
></iframe>
```

→ [**Documentazione completa di InContext**](https://docs.didit.me/it/integration/web-sdks/incontext-iframe.md)

***

## Redirect

Reindirizza gli utenti alla pagina di verifica ospitata da Didit. Al termine, gli utenti tornano al tuo URL di callback.

**Funzionalità principali:**

* Massima compatibilità con i browser
* Supporto per la verifica cross-device
* Integrazione semplice
* Funziona quando l'accesso alla fotocamera nell'iframe presenta problemi

**Avvio rapido:**

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

→ [**Documentazione completa di Redirect**](https://docs.didit.me/it/integration/web-sdks/web-redirect.md)

***

## Confronto

| Funzionalità | SDK JavaScript | InContext (Iframe) | Redirect |
| - | - | - | - |
| Tempo di configurazione | 3 min | \< 1 min | 5 min |
| Backend richiesto | Opzionale | Opzionale | Sì |
| Resta sul tuo dominio | Sì | Sì | No |
| Supporto cross-device | Sì | Sì | Sì |
| Controllo programmatico completo | Sì | Limitato | Solo callback |
| Callback degli eventi | In tempo reale | `postMessage` | Solo callback |
| White-label | Sì | Sì | Sì |
| Compatibilità con i browser | Tutti | Tutti | Tutti |

> [!NOTE]
>
> Tutti e tre i metodi forniscono i risultati finali firmati tramite [webhook](https://docs.didit.me/it/integration/webhooks.md): la tabella sopra descrive l'esperienza utente nel browser, non il modo in cui ricevi la decisione sulla verifica.

***

## Configurazione

### Permessi richiesti per l'iframe

Per le integrazioni con iframe InContext, includi sempre questi permessi:

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

***

## Repository di esempio

> [card] [Esempi web SDK](https://github.com/didit-protocol/sdk-web-examples)
>
> Esempi per React, Vue, Angular, Next.js, Nuxt, Svelte e JS vanilla

> [card] [Esempio iframe](https://github.com/didit-protocol/iframe-example)
>
> Esempi di iframe con UniLink e con sessione API

> [card] [Demo completa Next.js](https://github.com/didit-protocol/didit-full-demo)
>
> Integrazione Next.js end-to-end

> [card] [Pacchetto NPM](https://www.npmjs.com/package/@didit-protocol/sdk-web)
>
> `@didit-protocol/sdk-web` su npm

## Correlati

* [Webhook](https://docs.didit.me/it/integration/webhooks.md): ricevi sul tuo backend i risultati di verifica firmati
* [API Create Session](https://docs.didit.me/it/sessions-api/create-session.md): l'endpoint alla base di ogni SDK web
* [SDK nativi](https://docs.didit.me/it/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.