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

# KYC reutilitzable amb l'API de compartició de sessions

> Amb Didit, comparteix sessions verificades amb partners de confiança: KYC i KYB reutilitzables amb tokens de durada limitada.

El nostra API de compartició de sessions permet compartir de manera segura les dades de sessions verificades entre organitzacions associades de confiança, tant per a sessions de verificació d'usuaris (KYC) com de verificació d'empreses (KYB). El token de compartició codifica el `session_kind`, perquè l'aplicació receptora reconstrueixi el mateix tipus de sessió en importar-la. Així, funciona amb **KYC i KYB reutilitzables**.

## Endpoints

> [card] [Compartir sessió](https://docs.didit.me/ca/sessions-api/share-session/share.md)
>
> `POST /v3/session/{sessionId}/share/` — Genera un token de compartició amb temps limitat per a una sessió verificada.

> [card] [Importar sessió compartida](https://docs.didit.me/ca/sessions-api/share-session/import.md)
>
> `POST /v3/session/import-shared/` — Importa una sessió que un soci ha compartit amb un token de compartició.

## Com funciona

**1. El soci A comparteix una sessió**

Després que un usuari completi la verificació a la plataforma del soci A, el soci A crida **Compartir sessió** amb l'ID de la sessió i l'ID de l'aplicació del soci de destinació. Didit retorna un `share_token` amb temps limitat.

**2. El token de compartició s'envia al soci B**

El soci A envia el `share_token` al soci B pel seu propi canal segur (crida d'API, webhook, etc.).

**3. El soci B importa la sessió**

El soci B crida **Importar sessió compartida** amb el `share_token`. Didit crea una còpia de la sessió verificada al compte del soci B, amb totes les dades de verificació.

## Requisits

| Requisit | Detalls |
| - | - |
| **Estat de la sessió** | Només es poden compartir les sessions finalitzades (`"Approved"`, `"Declined"`, `"In Review"`) |
| **ID de l'aplicació del soci** | L'ID de l'aplicació del soci de destinació (es troba a la configuració de la Business Console) |
| **TTL del token** | Configurable entre 60 segons i 86,400 segons (24 hores). Per defecte: 3,600 segons (1 hora) |
| **Autenticació** | Tots dos socis han d'autenticar-se amb les seves pròpies claus d'API |

## Casos d'ús

* **Banca → Fintech**: Un usuari verificat per un banc pot accedir a un soci fintech sense tornar a verificar-se
* **Marketplace → Proveïdor de pagaments**: Els venedors verificats a un marketplace es poden donar d'alta al proveïdor de pagaments a l'instant
* **Assegurances → Salut**: Compartició de verificacions entre socis de confiança de diferents sectors
* **Empreses del grup**: Compartició de dades de verificació entre diverses aplicacions dins de la mateixa organització

> [!NOTE]
>
> Més informació sobre la funcionalitat de KYC reutilitzable a la guia [Compartir el KYC mitjançant l'API](https://docs.didit.me/ca/core-technology/reusable-kyc/share-kyc-via-api.md).


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