> ## 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: 한 번의 인증으로 여러 앱에서 공유

> Didit의 재사용 가능한 KYC로 사용자가 신원을 한 번만 인증하고 여러 앱에서 안전하게 재사용하도록 지원하세요. 반복 KYC를 없애고 온보딩 마찰을 줄입니다. Didit에서 무료로 제공됩니다.

재사용 가능한 KYC를 사용하면 사용자가 한 번 신원 인증을 완료한 후, Didit과 연동된 여러 애플리케이션에 해당 인증 정보를 안전하게 공유할 수 있습니다. 이를 통해 보안과 컴플라이언스를 유지하면서 온보딩 과정의 마찰을 줄일 수 있습니다.

재사용 가능한 KYC 연동 프롬프트
        프롬프트를 클립보드에 복사



      
      

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



      
      

붙여넣을 곳

Didit Academy KYB 강의의 이번 챕터에서는 관계자 인증 및 KYC 세션 재사용을 다룹니다.KYB Academy 강의의 7:04 챕터에서는 UBO가 두 번 인증할 필요 없이 기존 KYC 세션을 재사용하여 관계자를 인증하는 방법을 보여줍니다.[관계자 인증 및 KYC 세션 재사용 — Didit Academy](https://www.youtube.com/embed/JEnW_sEe35Y?start=424\&rel=0\&playsinline=1)## 작동 방식**1. 최초 인증**사용자가 표준 KYC 절차(신분증 인증 + 얼굴 인식)를 완료합니다. 인증 데이터는 암호화되어 eIDAS2를 준수하는 사용자의 Didit ID에 저장됩니다.**2. 새 애플리케이션에서 재사용**사용자가 Didit과 연동된 다른 애플리케이션을 이용할 때, 기존 KYC를 재사용하는 옵션을 선택합니다. 빠른 얼굴 인식 검사를 통해 본인 여부를 확인하고, 특정 데이터 공유에 동의합니다.**3. 즉각적인 온보딩**새로운 애플리케이션은 검증된 KYC 정보를 즉시 전달받으므로 문서를 다시 업로드하거나 대기할 필요가 없습니다.## 주요 이점| 사용자 | 기업 | 컴플라이언스 |
| - | - | - |
| 한 번 인증으로 어디서나 사용 | 더 빠른 사용자 온보딩 | 규제 표준 유지 |
| 데이터 공유에 대한 직접 제어 | 이탈률 감소 | 완전한 감사 추적 기록 |
| 몇 분 대신 몇 초 만에 완료 | 전환율 증가 | 여러 관할 구역 지원 |## 보안 및 컴플라이언스| 영역 | 세부 사항 |
| - | - |
| **암호화** | 저장 및 전송되는 모든 데이터에 대한 종단간 암호화 적용 |
| **생체 재인증** | 재사용 시마다 얼굴 인식 필수 진행 |
| **규제 준수** | eIDAS2 준수, AML/KYC 요건 지원 |
| **국경 간 지원** | 여러 관할 구역에 걸쳐 작동 |![인증된 사용자가 여러 서비스 간에 신원 정보를 전달할 수 있도록 지원하는 Didit 재사용 가능한 KYC 흐름](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/reusable-kyc.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=12c89122aad772b3683a629343b6dabc)재사용 가능한 KYC는 최초 인증을 완료한 사용자에게 자동으로 제공됩니다. 사용자는 언제든지 기존 KYC를 재사용하거나 새로운 검사를 수행하도록 선택할 수 있습니다.


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