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

# Wiederverwendbares KYC: Einmal prüfen, in Apps nutzen

> Didit bietet wiederverwendbares KYC: Einmal verifizieren und sicher über mehrere Apps teilen. Beseitigt doppeltes KYC. Kostenlos.

Wiederverwendbares KYC ermöglicht es Benutzern, ihre Identität einmalig zu verifizieren und diese Verifizierung sicher über mehrere in Didit integrierte Anwendungen hinweg zu teilen. Dies verringert den Onboarding-Aufwand und gewährleistet gleichzeitig Sicherheit und Compliance.

Reusable-KYC-Integrations-Prompt
        Prompt in die Zwischenablage kopieren



      
      

\<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>



      
      

Einfügen in

Dieses Kapitel der KYB-Lektion der Didit Academy setzt bei der Parteienverifizierung und der Wiederverwendung von KYC-Sitzungen an.In der KYB-Academy-Lektion zeigt das Kapitel bei 7:04 die Parteienverifizierung unter Wiederverwendung einer bestehenden KYC-Sitzung, anstatt einen UBO zur zweifachen Verifizierung zu verpflichten.[Parteienverifizierung und Wiederverwendung von KYC-Sitzungen — Didit Academy](https://www.youtube.com/embed/JEnW_sEe35Y?start=424\&rel=0\&playsinline=1)## Wie es funktioniert**1. Erstmalige Verifizierung**Der Benutzer schließt einen standardmäßigen KYC-Prozess ab (Ausweisverifizierung + Gesichtserkennung). Die Verifizierungsdaten werden verschlüsselt und konform mit eIDAS2 in der Didit ID des Benutzers gespeichert.**2. Wiederverwendung bei einer neuen Anwendung**Trifft der Benutzer auf eine andere in Didit integrierte Anwendung, wählt er die Option zur Wiederverwendung seines bestehenden KYC. Ein schneller Gesichtserkennungsabgleich bestätigt seine Identität, und er willigt in die Weitergabe bestimmter Daten ein.**3. Sofortiges Onboarding**Die neue Anwendung empfängt die verifizierten KYC-Informationen sofort – kein erneutes Hochladen von Dokumenten, keine Wartezeit.## Hauptvorteile| Für Benutzer | Für Unternehmen | Für die Compliance |
| - | - | - |
| Einmal verifizieren, überall nutzen | Schnelleres Onboarding von Benutzern | Einhaltung regulatorischer Standards |
| Kontrolle über die Datenfreigabe | Geringere Abbruchraten | Vollständiger Audit-Trail |
| Sekunden statt Minuten | Höhere Konversionsraten | Jurisdiktionsübergreifende Unterstützung |## Sicherheit und Compliance| Bereich | Details |
| - | - |
| **Verschlüsselung** | Ende-zu-Ende-Verschlüsselung für alle gespeicherten und übertragenen Daten |
| **Biometrische erneute Authentifizierung** | Gesichtserkennung bei jeder Wiederverwendung erforderlich |
| **Regulatorische Konformität** | eIDAS2-konform, unterstützt AML/KYC-Anforderungen |
| **Grenzüberschreitend** | Funktioniert über verschiedene Jurisdiktionen hinweg |![Didit-Ablauf für wiederverwendbares KYC, mit dem verifizierte Benutzer ihre Identität dienstübergreifend nutzen können](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/reusable-kyc.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=12c89122aad772b3683a629343b6dabc)Wiederverwendbares KYC steht Benutzern, die eine erste Verifizierung abgeschlossen haben, automatisch zur Verfügung. Benutzer können jederzeit wählen, ob sie ihr KYC wiederverwenden oder eine erneute Prüfung durchführen möchten.


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