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

# API를 통한 KYC 공유: 재사용 가능한 KYC

> Didit API를 통해 신뢰할 수 있는 파트너 간 인증 데이터를 안전하게 공유하세요. 수명이 짧은 공유 token을 활용해 연동된 서비스 간 중복 KYC를 방지합니다.

## 작동 방식

사용자 `A`가 `Service X`에서 사용자 인증을 완료하고 이제 파트너인 `Service Y`에 가입한다고 가정해 보겠습니다. `Service X`가 `A`에 관한 정보를 `Service Y`와 공유하는 데 동의하면 다음과 같이 진행할 수 있습니다.

1. **공유 token 생성(`Service X`)**: `Service X`는 특정 사용자의 인증 세션에 대해 안전하고 유효 기간이 짧은 `share_token`을 생성하는 API 호출을 수행합니다. 이 token은 `Service Y` 전용으로 지정됩니다. API 레퍼런스를 참조하세요: [Share Session API](https://docs.didit.me/ko/sessions-api/share-session/share.md).

2. **파트너에게 token 전달(`Service X` -> `Service Y`)**: `Service X`는 사전 협의된 백엔드 채널을 통해 생성된 `share_token`을 `Service Y`에 안전하게 전송합니다.

3. **세션 가져오기(`Service Y`)**: `Service Y`는 수신한 `share_token`을 사용하여 사용자 데이터를 가져오는 API 호출을 수행합니다. 이렇게 하면 모든 문서와 확인 내역을 포함한 인증 세션의 전체 사본이 `Service Y` 자체 환경 내에 생성됩니다. API 레퍼런스를 참조하세요: [Import Shared Session API](https://docs.didit.me/ko/sessions-api/share-session/import.md).

### 가져오기 옵션

세션을 가져올 때 `Service Y`는 결과를 처리하는 방식을 제어할 수 있습니다.

* **`trust_review`**: 이 불리언 파라미터는 `Service Y`가 `Service X`의 검토 및 최종 상태(`Approved`/`Declined`)를 신뢰할지 여부를 결정합니다.
  * `true`: 원래 상태 그대로 세션이 복사됩니다. 사용자는 `Service Y`에 즉시 온보딩되거나(또는 거부) 처리됩니다.
  * `false`: 세션 데이터는 복사되지만 상태는 자동으로 `In Review`로 설정됩니다. 이를 통해 `Service Y`는 수집된 문서와 데이터를 활용하면서 자체 내부 검토 절차를 진행하여 최종 결정을 내릴 수 있습니다.
* **`workflow_id`**: `Service Y`는 가져온 세션과 연결할 자체 인증 워크플로를 지정해야 합니다.
* **`vendor_data`**: `Service Y`는 가져온 세션에 자체 내부 사용자 식별자를 할당할 수 있습니다.

### 중요 고려 사항

* **완료된 세션만 가능**: 완료 상태(`Approved`, `Declined`, `In Review`)인 세션에 대해서만 공유 token을 생성할 수 있습니다.
* **중복 불가**: 특정 세션은 지정된 파트너 애플리케이션으로 한 번만 가져올 수 있습니다. 이후의 시도는 거부됩니다.

***

## 재사용 가능한 KYC vs. API를 통한 KYC 공유

두 기능 모두 신원 정보 재사용을 지원하지만 목적이 다릅니다.

| 기능 | 사용자 제어 재사용 가능한 KYC | API를 통한 KYC 공유(B2B 공유) |
| - | - | - |
| **시작 주체** | 온보딩 중 최종 사용자가 시작합니다. | 서버 간 API 호출을 통해 기업이 시작합니다. |
| **동의** | 사용자가 재사용할 때마다 데이터 공유에 명시적으로 동의합니다. | 동의는 일반적으로 최초 기업과의 사용자 이용약관을 통해 처리됩니다. 파트너 기업 간의 명확한 데이터 공유 계약이 필요합니다. |
| **데이터 흐름** | 사용자의 Didit ID를 통해 새 앱과 직접 데이터를 공유합니다. | `Service X`가 안전한 token을 통해 `Service Y`와 데이터를 공유합니다. |
| **사용 사례** | 관련 없는 여러 서비스에 빠르게 가입하려는 사용자에게 적합합니다. | 관련 플랫폼 전반에서 사용자의 신원 정보 이동이 필요한 파트너 에코시스템, 금융 서비스 그룹 또는 대기업 그룹사에 적합합니다. |

***

> ## ❗️ 중요: 데이터 공유 제한 사항
>
> 서로 다른 조직 간에 사용자의 개인 데이터를 공유하는 것은 엄격한 법률 및 규제 요건의 적용을 받습니다. 이 기능을 사용하기 전에 귀사는 유럽 연합의 GDPR 및 영국의 UK GDPR과 같이 적용 가능한 모든 데이터 보호 법률을 완전히 준수하고 있는지 확인할 책임이 있습니다.
>
> 다음 사항을 반드시 준수해야 합니다.
>
> 1. **법적 근거 마련**: 데이터 공유에 대한 적법한 법적 근거가 있는지 확인해야 합니다. 이를 위해 귀사와 파트너 조직 간의 명확한 데이터 공유 계약이 필요한 경우가 많습니다.
> 2. **사용자 동의 확보**: 서비스 이용약관 및 개인정보 처리방침에 명시된 대로, 사용자에게 파트너와의 데이터 공유에 대해 적절히 안내하고 동의를 받았는지 확인해야 합니다.
> 3. **국가 간 데이터 이전의 적절한 처리**: 국경을 넘어 데이터가 이전되는 경우(예: EU에서 비EU 국가로 이전), 법률에서 요구하는 적절한 보호 조치가 마련되어 있는지 확인해야 합니다.
>
> Didit은 데이터 공유를 위한 기술적 기능을 제공하지만, 공유하는 데이터와 관련된 모든 법적 및 컴플라이언스 의무에 대한 책임은 전적으로 귀사와 파트너에게 있습니다. 이 기능을 구현하기 전에 법률 자문을 받아보실 것을 강력히 권장합니다.


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