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

# API Share Session: KYC riutilizzabile tra partner

> KYC e KYB riutilizzabili: condividi sessioni verificate con partner fidati tramite token a tempo. Evita nuove verifiche e riduci attriti e costi con Didit.

L'API Share Session consente di condividere in modo sicuro i dati di sessione già verificati tra organizzazioni partner fidate, con **KYC e KYB riutilizzabili**. Funziona sia per le sessioni di Verifica degli utenti (KYC) sia per quelle di Verifica aziendale (KYB). Il token di condivisione codifica il `session_kind`, così l'applicazione ricevente ricostruisce lo stesso tipo di sessione durante l'importazione.

## Endpoint

> [card] [Condividi sessione](https://docs.didit.me/it/sessions-api/share-session/share.md)
>
> `POST /v3/session/{sessionId}/share/` — Genera un token di condivisione a tempo limitato per una sessione verificata.

> [card] [Importa sessione condivisa](https://docs.didit.me/it/sessions-api/share-session/import.md)
>
> `POST /v3/session/import-shared/` — Importa una sessione condivisa da un partner tramite un token di condivisione.

## Come funziona

**1. Il partner A condivide una sessione**

Dopo che un utente ha completato la verifica sulla piattaforma del partner A, il partner A chiama **Condividi sessione** con l'ID della sessione e l'ID applicazione del partner di destinazione. Didit restituisce uno `share_token` a tempo limitato.

**2. Il token di condivisione viene inviato al partner B**

Il partner A invia lo `share_token` al partner B tramite il proprio canale sicuro (chiamata API, webhook, ecc.).

**3. Il partner B importa la sessione**

Il partner B chiama **Importa sessione condivisa** con lo `share_token`. Didit crea una copia della sessione verificata nell'account del partner B, con tutti i dati di verifica.

## Requisiti

| Requisito | Dettagli |
| - | - |
| **Stato della sessione** | Possono essere condivise solo le sessioni concluse (`"Approved"`, `"Declined"`, `"In Review"`) |
| **ID applicazione del partner** | L'ID applicazione del partner di destinazione (si trova nelle impostazioni della Business Console) |
| **TTL del token** | Configurabile da 60 secondi a 86,400 secondi (24 ore). Predefinito: 3,600 secondi (1 ora) |
| **Autenticazione** | Entrambi i partner devono autenticarsi con le proprie chiavi API |

## Casi d'uso

* **Banca → Fintech**: un utente verificato da una banca può accedere a un partner fintech senza dover ripetere la verifica
* **Marketplace → Provider di pagamento**: i venditori verificati su un marketplace possono effettuare l'onboarding presso il provider di pagamento immediatamente
* **Assicurazioni → Sanità**: condivisione della verifica tra settori diversi, tra partner fidati
* **Aziende del gruppo**: condivisione dei dati di verifica tra più applicazioni della stessa organizzazione

> [!NOTE]
>
> Scopri di più sulla funzionalità KYC riutilizzabile nella guida [Condividere il KYC tramite API](https://docs.didit.me/it/core-technology/reusable-kyc/share-kyc-via-api.md).


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