跳转到主要内容
Business Console 让您的团队无需编写代码即可批量管理用户实体。支持两种流程：CSV 导入（批量创建或更新用户）和 CSV 导出（提取用户表供外部工具使用）。
此处的批量导入/导出仅创建或更新用户档案。它不会重建历史 KYC 会话、证件警告、活体证据或服务商决策。如需从 Sumsub、MetaMap、Veriff、Onfido、Persona 或其他服务商完整迁移，请参阅从其他服务商导入数据。

​
从 CSV 导入用户

​
适用场景

  • 首日迁移：从其他 KYC 供应商迁移，导入您现有的用户名单。
  • 服务商人脸迁移：在行创建后，将可信人脸图像关联到已导入的用户档案。
  • 批量入驻：导入合作伙伴的客户名单。
  • 元数据回填：批量更新大量用户的标签、等级或内部标识符。

​
模板列

在 Users → Import → Download template 下载模板。列如下：

​
运行导入

1

上传 CSV

进入 Users → Import → Upload CSV，选择您的文件。
2

查看预览

控制台会逐行验证。无效行会高亮显示，并附带错误原因（例如 vendor_data 重复、国家代码无效）。
3

开始导入

Didit 异步处理各行。您可以关闭标签页，进度可在 Users → Import history 中查看。
4

查看结果

导入完成后，历史视图会显示已创建、已更新和已跳过的行数，并提供可下载的错误报告。

​
更新与创建

  • 如果某个 vendor_data 不存在，则创建新用户。
  • 如果某个 vendor_data 已存在，则该行会更新现有用户（档案字段和元数据）。
  • 汇总计数器和已验证字段（来自已通过会话的 full_name、date_of_birth）绝不会被导入覆盖。

​
用户创建后导入人脸

CSV 导入只会创建或更新用户行，CSV 中不包含人脸图像。如需从其他服务商迁移人脸生物特征，请在目标用户存在后逐个上传人脸：
1

创建或导入用户

使用控制台 CSV 导入，或循环调用 POST /v3/users/create/。
2

读取 didit_internal_id

使用 GET /v3/users/{vendor_data}/ 获取用户。响应中包含 didit_internal_id。
3

上传人脸

使用原始 base64 人脸图像调用 POST /v3/organization/{organization_id}/application/{application_id}/vendor-users/by-id/{didit_internal_id}/faces/upload/。
人脸必须是有效图像，解码后最大 2 MB，并且包含可检测到的人脸。Didit 会将其存储在用户档案中，并建立索引，用于重复检测和人脸搜索。除非您另外使用 上传人脸到名单 endpoint，否则它不会被添加到人脸黑名单。

​
将用户导出为 CSV

​
适用场景

  • 合规审计：向审计人员交付完整用户表。
  • 数据仓库同步：定期导出到您的商业智能（BI）工具。
  • SAR 或监管机构请求：提取筛选后的用户子集。

​
运行导出

  1. 进入 Users → Export。
  2. 应用筛选条件（状态、国家/地区、日期范围、搜索）。
  3. 选择列（默认包含所有字段；您可以去掉不需要的列）。
  4. 提交。Didit 异步生成导出文件，并将带签名的下载链接发送到发起请求的操作员邮箱。
导出仅包含您的角色有权读取的数据。COMPLIANCE_OFFICER 及更高角色可以导出完整用户表；DEVELOPER 和 READER 角色的导出受到限制。

​
性能特征

​
审计追踪

每次导入和导出都会记录在审计日志中：
  • 触发该操作的操作员。
  • 行数（导入）或筛选条件快照（导出）。
  • 时间戳以及成功或失败状态。

​
后续步骤

创建用户 API

用于脚本化导入的程序化创建。

上传用户人脸

将导入的人脸图像关联到用户档案。

数据保留

导入的数据保存多长时间。

审计日志

查看导入和导出历史。
最后修改于 2026年11月7日