> ## 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 支持通过 API 在受信任合作伙伴之间安全共享验证数据。借助短期共享 token，消除跨集成服务的重复 KYC。

## 工作原理

假设用户 `A` 在 `Service X` 中通过了用户验证，现在正在合作伙伴 `Service Y` 处注册。如果 `Service X` 同意与 `Service Y` 共享 `A` 的信息，可以通过以下步骤完成：

1. **生成共享 token（`Service X`）**：`Service X` 调用 API，为特定用户的验证会话生成一个安全的短期 `share_token`。该 token 仅供 `Service Y` 使用。请参阅 API 参考：[Share Session API](https://docs.didit.me/zh/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/zh/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 与通过 API 共享 KYC 的对比

虽然这两项功能都支持身份信息的复用，但适用的场景有所不同：

| 功能 | 用户自主控制的可复用 KYC | 通过 API 共享 KYC（B2B 共享） |
| - | - | - |
| **谁来发起？** | 终端用户在入驻过程中发起。 | 企业通过服务器到服务器的 API 调用发起。 |
| **同意** | 用户在每次复用时明确同意共享其数据。 | 同意通常在用户与初始企业签署的服务条款中进行处理。合作伙伴企业之间需要签署明确的数据共享协议。 |
| **数据流向** | 用户的 Didit ID 协助将数据直接共享给新应用。 | `Service X` 通过安全 token 将数据共享给 `Service Y`。 |
| **使用场景** | 用户希望快速注册多个互不相关的服务。 | 合作伙伴生态系统、金融服务集团或大型企业集团，其中用户的身份信息需要在相关联的平台之间流转。 |

***

> ## ❗️ 重要提示：数据共享限制
>
> 在不同组织之间共享用户个人数据受到严格的法律和法规约束。在使用此功能之前，您的组织有责任确保完全遵守所有适用的数据保护法律，例如欧盟的 GDPR 和英国的 UK GDPR。
>
> 您必须：
>
> 1. **确立合法依据**：确保您拥有共享数据的合法依据。这通常需要您与合作伙伴组织之间签署明确的数据共享协议。
> 2. **确保用户同意**：确认您的用户已被充分告知，并已按照您的服务条款和隐私政策同意将其数据共享给您的合作伙伴。
> 3. **妥善处理跨境数据传输**：如果数据涉及跨境传输（例如从欧盟传输至非欧盟国家/地区），您必须确保按照法律要求采取适当的保护措施。
>
> Didit 提供数据共享的技术能力，但您的组织及您的合作伙伴对所共享数据相关的所有法律和合规义务承担全部责任。我们强烈建议在实施此功能之前咨询您的法律顾问。


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