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

# Condivisione KYC via API: KYC riutilizzabile

> Condividi in sicurezza i dati di verifica tra partner con Didit tramite API ed evita KYC ripetuti grazie a token di condivisione a breve durata.

## Come funziona

Supponiamo che un utente `A` abbia superato la verifica degli utenti in `Service X` e si stia ora registrando presso il partner `Service Y`. Se `Service X` acconsente a condividere le informazioni su `A` con `Service Y`, l'operazione può essere eseguita come segue:

1. **Generazione del token di condivisione (`Service X`)**: `Service X` effettua una chiamata API per generare un `share_token` sicuro e di breve durata per la sessione di verifica di uno specifico utente. Questo token è destinato esclusivamente all'uso da parte di `Service Y`. Consulta i riferimenti API: [Share Session API](https://docs.didit.me/it/sessions-api/share-session/share.md).

2. **Passaggio del token al partner (`Service X` -> `Service Y`)**: `Service X` trasmette in modo sicuro lo `share_token` generato a `Service Y` tramite un canale backend predisposto in precedenza.

3. **Importazione della sessione (`Service Y`)**: `Service Y` utilizza lo `share_token` ricevuto per effettuare una chiamata API e importare i dati dell'utente. In questo modo viene creata una copia completa della sessione di verifica, inclusi tutti i documenti e i controlli, all'interno dell'ambiente di `Service Y`. Consulta i riferimenti API: [Import Shared Session API](https://docs.didit.me/it/sessions-api/share-session/import.md).

### Opzioni di importazione

Durante l'importazione di una sessione, `Service Y` ha il controllo su come gestire i risultati:

* **`trust_review`**: questo parametro booleano determina se `Service Y` si fida della revisione e dello stato finale (`Approved`/`Declined`) proveniente da `Service X`.
  * `true`: la sessione viene copiata con lo stato originale. L'utente viene immediatamente registrato (o rifiutato) su `Service Y`.
  * `false`: i dati della sessione vengono copiati, ma lo stato viene impostato automaticamente su `In Review`. Ciò consente a `Service Y` di utilizzare i documenti e i dati raccolti, eseguendo tuttavia il proprio processo interno di revisione per prendere una decisione finale.
* **`workflow_id`**: `Service Y` deve specificare a quale dei propri workflow di verifica associare la sessione importata.
* **`vendor_data`**: `Service Y` può assegnare il proprio identificatore utente interno alla sessione importata.

### Considerazioni importanti

* **Solo sessioni completate**: un token di condivisione può essere generato solo per le sessioni che hanno uno stato concluso (`Approved`, `Declined`, `In Review`).
* **Nessun duplicato**: una specifica sessione può essere importata una sola volta in una determinata applicazione partner. I tentativi successivi saranno rifiutati.

***

## KYC riutilizzabile vs. condivisione di KYC tramite API

Sebbene entrambe le funzionalità facilitino il riutilizzo dell'identità, rispondono a finalità diverse:

| Funzionalità | KYC riutilizzabile controllato dall'utente | Condivisione di KYC tramite API (condivisione B2B) |
| - | - | - |
| **Chi avvia?** | L'utente finale, durante l'onboarding. | L'azienda, tramite una chiamata API da server a server. |
| **Consenso** | L'utente acconsente esplicitamente a condividere i propri dati per ciascun riutilizzo. | Il consenso viene in genere gestito nei termini di servizio dell'utente con l'azienda iniziale. È necessario un accordo chiaro di condivisione dei dati tra le aziende partner. |
| **Flusso dei dati** | Il Didit ID dell'utente facilita la condivisione dei dati direttamente con la nuova applicazione. | `Service X` condivide i dati con `Service Y` tramite un token sicuro. |
| **Caso d'uso** | Un utente che desidera registrarsi rapidamente a più servizi indipendenti tra loro. | Ecosistemi di partner, gruppi di servizi finanziari o conglomerati in cui l'identità dell'utente deve essere portabile tra piattaforme correlate. |

***

> ## ❗️ Importante: limitazioni alla condivisione dei dati
>
> La condivisione di dati personali degli utenti tra organizzazioni diverse è soggetta a severi requisiti legali e normativi. Prima di utilizzare questa funzionalità, la tua organizzazione ha la responsabilità di assicurarsi di essere pienamente conforme a tutte le leggi applicabili sulla protezione dei dati, come il GDPR nell'Unione Europea e lo UK GDPR nel Regno Unito.
>
> Devi:
>
> 1. **Stabilire una base giuridica**: assicurati di disporre di una base giuridica legittima per la condivisione dei dati. Spesso ciò richiede un accordo chiaro di condivisione dei dati tra te e l'organizzazione partner.
> 2. **Garantire il consenso dell'utente**: verifica che i tuoi utenti siano stati debitamente informati e abbiano acconsentito alla condivisione dei propri dati con i tuoi partner, come indicato nei tuoi termini di servizio e nell'informativa sulla privacy.
> 3. **Gestire i trasferimenti internazionali in modo appropriato**: in caso di trasferimento di dati oltre confine (ad es. dall'UE a un paese terzo), devi assicurarti che siano predisposte garanzie adeguate come richiesto dalla legge.
>
> Didit fornisce le funzionalità tecniche per la condivisione dei dati, ma la tua organizzazione e i tuoi partner sono gli unici responsabili di tutti gli obblighi legali e di conformità relativi ai dati condivisi. Consigliamo vivamente di consultare il proprio consulente legale prima di implementare questa funzionalità.


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