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

# Compartir KYC via API: verificació reutilitzable

> Comparteix dades de verificació via API de forma segura amb Didit. Evita repetir el KYC entre serveis integrats amb tokens de curta durada.

## Com funciona

Suposem que un usuari `A` ha superat la verificació d'usuaris a `Service X` i ara s'està registrant al soci `Service Y`. Si `Service X` accepta compartir la informació sobre `A` amb `Service Y`, es pot fer de la manera següent:

1. **Generar el token per compartir (`Service X`)**: `Service X` fa una crida a l'API per generar un `share_token` segur i de curta durada per a la sessió de verificació d'un usuari concret. Aquest token està destinat exclusivament a l'ús per part de `Service Y`. Consulta la referència de l'API: [Share Session API](https://docs.didit.me/ca/sessions-api/share-session/share.md).

2. **Passar el token al soci (`Service X` -> `Service Y`)**: `Service X` transmet de manera segura el `share_token` generat a `Service Y` a través d'un canal de backend prèviament acordat.

3. **Importar la sessió (`Service Y`)**: `Service Y` utilitza el `share_token` rebut per fer una crida a l'API per importar les dades de l'usuari. Això crea una còpia completa de la sessió de verificació, inclosos tots els documents i comprovacions, dins del propi entorn de `Service Y`. Consulta la referència de l'API: [Import Shared Session API](https://docs.didit.me/ca/sessions-api/share-session/import.md).

### Opcions d'importació

En importar una sessió, `Service Y` té el control sobre com gestionar els resultats:

* **`trust_review`**: aquest paràmetre booleà determina si `Service Y` confia en la revisió i en l'estat final (`Approved`/`Declined`) de `Service X`.
  * `true`: la sessió es copia amb l'estat original. L'usuari completa l'alta a l'instant (o és rebutjat) a `Service Y`.
  * `false`: les dades de la sessió es copien, però l'estat s'estableix automàticament a `In Review`. Això permet a `Service Y` utilitzar els documents i les dades recollides, però dur a terme el seu propi procés de revisió interna per prendre una decisió final.
* **`workflow_id`**: `Service Y` ha d'especificar quin dels seus propis fluxos de treball de verificació vol associar a la sessió importada.
* **`vendor_data`**: `Service Y` pot assignar el seu propi identificador d'usuari intern a la sessió importada.

### Consideracions importants

* **Només sessions finalitzades**: només es pot generar un token per compartir per a sessions que tinguin un estat finalitzat (`Approved`, `Declined`, `In Review`).
* **Sense duplicats**: una sessió concreta només es pot importar un cop a una aplicació de soci determinada. Els intents posteriors seran rebutjats.

***

## KYC reutilitzable vs. compartir KYC via API

Tot i que ambdues funcionalitats faciliten la reutilització de la identitat, tenen finalitats diferents:

| Funcionalitat | KYC reutilitzable controlat per l'usuari | Compartir KYC via API (intercanvi B2B) |
| - | - | - |
| **Qui ho inicia?** | L'usuari final, durant l'alta. | L'empresa, mitjançant una crida a l'API de servidor a servidor. |
| **Consentiment** | L'usuari dona el seu consentiment explícit per compartir les seves dades a cada reutilització. | El consentiment se sol gestionar a les condicions del servei que l'usuari accepta amb l'empresa inicial. Es requereix un acord clar per compartir dades entre les empreses sòcies. |
| **Flux de dades** | El Didit ID de l'usuari facilita l'intercanvi de dades directament amb la nova aplicació. | `Service X` comparteix les dades amb `Service Y` mitjançant un token segur. |
| **Cas d'ús** | Un usuari que vol registrar-se ràpidament a múltiples serveis no relacionats. | Ecosistemes de socis, grups de serveis financers o conglomerats on la identitat d'un usuari s'ha de poder transferir entre plataformes relacionades. |

***

> ## ❗️ Important: restriccions per compartir dades
>
> Compartir dades personals d'usuaris entre diferents organitzacions està subjecte a requisits legals i regulatoris estrictes. Abans d'utilitzar aquesta funcionalitat, la teva organització és responsable d'assegurar-se que compleix plenament totes les lleis de protecció de dades aplicables, com ara el GDPR a la Unió Europea i el UK GDPR al Regne Unit.
>
> Has de:
>
> 1. **Establir una base jurídica**: assegura't de disposar d'una base jurídica legítima per compartir les dades. Sovint, això requereix un acord clar per compartir dades entre tu i l'organització sòcia.
> 2. **Garantir el consentiment de l'usuari**: confirma que els teus usuaris han estat degudament informats i han donat el seu consentiment perquè les seves dades es comparteixin amb els teus socis, tal com s'estableix a les teves condicions del servei i a la teva política de privacitat.
> 3. **Gestionar les transferències internacionals adequadament**: si les dades es transfereixen a escala transfronterera (per exemple, de la UE a un país no pertanyent a la UE), has de garantir que s'apliquin les garanties adequades segons exigeix la llei.
>
> Didit proporciona la capacitat tècnica per compartir dades, però la teva organització i els teus socis són els únics responsables de totes les obligacions legals i de compliment normatiu relacionades amb les dades que compartiu. Et recomanem encaridament consultar amb el teu assessor legal abans d'implementar aquesta funcionalitat.


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