> ## 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 réutilisable : vérifier une fois, utiliser partout

> Vérifiez l'identité une fois et réutilisez-la entre applications avec Didit. Éliminez les KYC répétés et fluidifiez l'onboarding. Gratuit.

Le KYC réutilisable permet aux utilisateurs de vérifier leur identité une seule fois et de partager cette vérification en toute sécurité entre plusieurs applications intégrant Didit. Cela réduit les frictions lors de l'onboarding tout en maintenant la sécurité et la conformité.

Prompt d'intégration du KYC réutilisable
        Copier le prompt dans le presse-papiers



      
      

\<pre>

\````# Goal
Integrate Didit Reusable KYC — hand off a finished verification session from one Didit application to another without re-running the verification. Two endpoints: **share** on the source application, **import-shared** on the receiving application.

\# Delivery mode
Cross-application share flow. Both calls authenticate with each side's own application API key (`x-api-key`). Source session must already be in a finished status (Approved / Declined / In Review).

\# Step 1 — Mint a share token (source application)
POST https://verification.didit.me/v3/session/{sessionId}/share/
x-api-key: YOUR_API_KEY
Content-Type: application/json

\```bash
curl -X POST 'https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/share/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"for_application_id": "a5f3bca2-46e2-411e-90ef-a580900a57ee",
"ttl_in_seconds": 7200
}'
\```
Response: { share_token, for_application_id, session_kind: "user" | "business" }.

\`ttl_in_seconds` — min 60, max 86400 (24h), default 3600 (1h).

\# JWT payload (token contents)
The HS256-signed JWT carries:
\- `session_id` — UUID of the source session being shared.
\- `session_kind` — "user" (KYC) or "business" (KYB) — drives which related rows are cloned.
\- `from_application_id` — calling application UUID.
\- `for_application_id` — receiving application UUID — only this app can redeem.
\- `iat` / `exp` — issued-at and expiry epoch seconds.

The token is not idempotent (each call mints a fresh JWT) and cannot be revoked — it simply expires.

\# Step 2 — Redeem the token (receiving application)
POST https://verification.didit.me/v3/session/import-shared/

\```bash
curl -X POST 'https://verification.didit.me/v3/session/import-shared/' \
-H 'x-api-key: RECEIVING_APP_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"share_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"trust_review": false,
"workflow_id": "9f9b1234-aaaa-bbbb-cccc-1234567890ab",
"vendor_data": "user-1"
}'
\```
Required: share_token, trust_review, workflow_id (must exist on the receiving app). Optional: vendor_data (defaults to source).

\`trust_review`:
\- `true` — cloned session keeps the source status (Approved stays Approved).
\- `false` — cloned session is forced to "In Review" so your reviewers re-decide.

Response (201): the V3 decision payload for both kinds — KYC for user sessions, KYB for business sessions — the same shape as GET /v3/session/{sessionId}/decision/, discriminated by `session_kind`. The cloned session has a fresh session_id and `shared_from_session` pointing at the source for audit.

\# Failure modes to handle
\- 400 "Invalid share token." — malformed JWT / wrong signature.
\- 400 "Share token has expired." — past exp.
\- 400 "This token is not valid for this application." — JWT `for_application_id` doesn't match the receiving app.
\- 400 "Original session does not exist." — source session deleted between mint and redeem.
\- 403 "This session has already been shared with your application." — same token can only be redeemed once per receiving app. Mint a new token.
\- 404 "Workflow does not exist for this application." — `workflow_id` is from a different application.
\- Source status not finished — 400 "Only finished sessions (Approved, Declined, In Review) can be shared."

\# What gets cloned
\- session_kind="user": KYC, Face, Liveness, FaceMatch, AML, POA, Phone, Location, DatabaseValidation rows + activity log.
\- session_kind="business": KYBCompany, KYBKeyPeopleCheck, KYBDocument + shared feature rows (AML, Phone, Email, Location, QuestionnaireResponse) + activity log.

\# See also
\- Mint share token: /sessions-api/share-session
\- Redeem share token: /sessions-api/import-shared-session
\- Canonical decision schema: /reference/data-models#overview
\- Full integration playbook: /integration/integration-prompt````

\</pre>



      
      

Coller dans

Ce chapitre de la leçon KYB de la Didit Academy reprend avec la vérification des parties et la réutilisation des sessions KYC.Dans la leçon de la KYB Academy, le chapitre qui commence à 7:04 montre la vérification des parties en réutilisant une session KYC existante au lieu d'obliger un UBO à se vérifier deux fois.[Vérification des parties et réutilisation des sessions KYC — Didit Academy](https://www.youtube.com/embed/JEnW_sEe35Y?start=424\&rel=0\&playsinline=1)## Comment ça fonctionne**1. Vérification initiale**L'utilisateur effectue un processus KYC standard (Vérification d'identité + reconnaissance faciale). Les données de vérification sont chiffrées et stockées dans le Didit ID de l'utilisateur, conformément à eIDAS2.**2. Réutilisation sur une nouvelle application**Lorsque l'utilisateur accède à une autre application intégrant Didit, il choisit l'option permettant de réutiliser son KYC existant. Un contrôle rapide par reconnaissance faciale confirme son identité, et il donne son consentement pour partager des données spécifiques.**3. Onboarding instantané**La nouvelle application reçoit instantanément les informations KYC vérifiées — aucun nouveau téléversement de document, aucune attente.## Principaux avantages| Pour les utilisateurs | Pour les entreprises | Pour la conformité |
| - | - | - |
| Vérifiez une fois, utilisez partout | Onboarding des utilisateurs plus rapide | Maintient les normes réglementaires |
| Contrôle du partage des données | Taux d'abandon réduits | Journal d'audit complet |
| Des secondes au lieu de minutes | Taux de conversion plus élevés | Prise en charge multijuridictionnelle |## Sécurité et conformité| Domaine | Détails |
| - | - |
| **Chiffrement** | Chiffrement de bout en bout pour toutes les données stockées et transférées |
| **Réauthentification biométrique** | Reconnaissance faciale requise pour chaque réutilisation |
| **Réglementation** | Conforme à eIDAS2, prend en charge les exigences AML/KYC |
| **Transfrontalier** | Fonctionne d'une juridiction à l'autre |![Flux de KYC réutilisable de Didit permettant aux utilisateurs vérifiés de transférer leur identité d'un service à l'autre](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/reusable-kyc.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=12c89122aad772b3683a629343b6dabc)Le KYC réutilisable est automatiquement accessible aux utilisateurs qui ont réalisé une vérification initiale. Les utilisateurs peuvent choisir de réutiliser leur KYC ou d'effectuer une nouvelle vérification à tout moment.


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