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

# Share Session API：合作伙伴间可复用 KYC 共享

> Didit 提供可复用 KYC 与 KYB：通过限时 token 在可信合作伙伴间共享已验证会话，免去重复验证，减少摩擦，降低成本。

The Share Session API enables **可复用 KYC 和 KYB**：在可信合作伙伴组织之间安全地共享已验证的会话数据。适用于用户验证（KYC）和企业验证（KYB）会话。共享 token 会编码 `session_kind`，以便接收方应用在导入时还原相同的会话类型。

## Endpoints

> [card] [共享会话](https://docs.didit.me/zh/sessions-api/share-session/share.md)
>
> `POST /v3/session/{sessionId}/share/` — 为已验证的会话生成有时效的共享 token。

> [card] [导入共享会话](https://docs.didit.me/zh/sessions-api/share-session/import.md)
>
> `POST /v3/session/import-shared/` — 使用共享 token 导入合作伙伴共享的会话。

## 工作原理

**1. 合作伙伴 A 共享会话**

用户在合作伙伴 A 的平台上完成验证后，合作伙伴 A 使用会话 ID 和目标合作伙伴的应用 ID 调用 **共享会话**。Didit 返回有时效的 `share_token`。

**2. 共享 token 发送给合作伙伴 B**

合作伙伴 A 通过自己的安全渠道（API 调用、Webhook 等）将 `share_token` 发送给合作伙伴 B。

**3. 合作伙伴 B 导入会话**

合作伙伴 B 使用 `share_token` 调用 **导入共享会话**。Didit 会在合作伙伴 B 的账户中创建已验证会话的副本，包含完整的验证数据。

## 要求

| 要求 | 详情 |
| - | - |
| **会话状态** | 只有已结束的会话（`"Approved"`、`"Declined"`、`"In Review"`）可以共享 |
| **合作伙伴应用 ID** | 目标合作伙伴的应用 ID（可在 Business Console 的设置中找到） |
| **token TTL** | 可在 60 秒至 86,400 秒（24 小时）之间配置。默认值：3,600 秒（1 小时） |
| **身份认证** | 双方合作伙伴必须使用各自的 API 密钥进行身份认证 |

## 使用场景

* **银行 → 金融科技**：银行验证过的用户无需重新验证，即可访问金融科技合作伙伴的服务
* **电商平台 → 支付服务商**：在电商平台上验证过的卖家可以立即入驻支付服务商
* **保险 → 医疗健康**：可信合作伙伴之间的跨行业验证共享
* **集团公司**：在同一组织内的多个应用之间共享验证数据

> [!NOTE]
>
> 了解更多关于可复用 KYC 功能的信息，请参阅[通过 API 共享 KYC 指南](https://docs.didit.me/zh/core-technology/reusable-kyc/share-kyc-via-api.md)。


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