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

> Didit으로 재사용 가능한 KYC·KYB를 구현하세요. 신뢰할 수 있는 파트너와 시간 제한 토큰으로 검증된 세션을 공유해 재인증을 건너뛰고 마찰과 비용을 줄이세요.

Share Session API는 신뢰할 수 있는 파트너 조직 간에 검증된 세션 데이터를 안전하게 공유할 수 있도록 **재사용 가능한 KYC 및 KYB**를 지원합니다. 사용자 인증(KYC)과 기업 확인(KYB) 세션 모두에 사용할 수 있습니다. 공유 토큰에는 `session_kind`가 포함되어 있어, 가져오기 작업을 수행하는 애플리케이션이 가져올 때 동일한 종류의 세션을 재구성합니다.

## 엔드포인트

> [card] [세션 공유](https://docs.didit.me/ko/sessions-api/share-session/share.md)
>
> `POST /v3/session/{sessionId}/share/` - 검증된 세션의 유효 기간이 제한된 공유 토큰을 생성합니다.

> [card] [공유된 세션 가져오기](https://docs.didit.me/ko/sessions-api/share-session/import.md)
>
> `POST /v3/session/import-shared/` - 파트너가 공유 토큰으로 공유한 세션을 가져옵니다.

## 작동 방식

**1. 파트너 A가 세션을 공유합니다**

사용자가 파트너 A의 플랫폼에서 인증을 완료하면, 파트너 A는 세션 ID와 대상 파트너의 애플리케이션 ID를 사용하여 **세션 공유**를 호출합니다. Didit는 유효 기간이 제한된 `share_token`을 반환합니다.

**2. 공유 토큰이 파트너 B에게 전송됩니다**

파트너 A는 자체 보안 채널(API 호출, webhook 등)을 통해 `share_token`을 파트너 B에게 보냅니다.

**3. 파트너 B가 세션을 가져옵니다**

파트너 B는 `share_token`으로 **공유된 세션 가져오기**를 호출합니다. Didit는 파트너 B의 계정에 전체 인증 데이터를 포함한 검증된 세션의 사본을 생성합니다.

## 요구 사항

| 요구 사항 | 세부 정보 |
| - | - |
| **세션 상태** | 완료된 세션(`"Approved"`, `"Declined"`, `"In Review"`)만 공유할 수 있습니다 |
| **파트너 애플리케이션 ID** | 대상 파트너의 애플리케이션 ID(Business Console 설정에서 확인할 수 있습니다) |
| **토큰 TTL** | 60초에서 86,400초(24시간) 사이로 설정할 수 있습니다. 기본값: 3,600초(1시간) |
| **인증** | 두 파트너 모두 자체 API 키로 인증해야 합니다 |

## 사용 사례

* **은행 → 핀테크**: 은행에서 인증된 사용자는 다시 인증하지 않고도 핀테크 파트너를 이용할 수 있습니다
* **마켓플레이스 → 결제 제공업체**: 마켓플레이스에서 인증된 판매자는 결제 제공업체에 즉시 온보딩할 수 있습니다
* **보험 → 헬스케어**: 신뢰할 수 있는 파트너 간의 산업 간 인증 데이터 공유
* **계열사**: 같은 조직 내 여러 애플리케이션에서 인증 데이터를 공유합니다

> [!NOTE]
>
> 재사용 가능한 KYC 기능에 대해서는 [API를 통한 KYC 공유 가이드](https://docs.didit.me/ko/core-technology/reusable-kyc/share-kyc-via-api.md)에서 자세히 알아볼 수 있습니다.


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