企业数据模型：KYB 数据结构

本页介绍企业（Business）实体的每个字段，以及 Didit 如何填充这些字段。

身份字段

字段	类型	说明
`uuid`	UUID	Didit 分配的主键。稳定且唯一。
`didit_internal_id`	string	便于阅读的内部标识符。
`vendor_data`	string	您为该企业设定的标识符。在每个应用内唯一。了解更多。
`display_name`	string	控制台中显示的覆盖名称。默认为 `legal_name` 或 `vendor_data`。
`legal_name`	string	按注册登记的法定公司名称，来自最近一次已通过的企业验证（KYB）会话的公司登记查询结果。
`registration_number`	string	官方公司注册号，来自公司登记。
`country_code`	string (ISO 3166-1 alpha-3)	公司注册所在国家/地区。

当 legal_name、registration_number 和 country_code 来自已验证的公司登记查询时，这些字段为只读。您可以在控制台中或通过 PATCH /v3/businesses/{vendor_data}/ 手动覆盖它们，但覆盖操作会在审计日志中被标记。

状态

字段	类型	取值	说明
`status`	enum	`ACTIVE`、`FLAGGED`、`BLOCKED`	控制对未来会话和交易的执行。参见生命周期。

会话汇总字段

字段	类型	说明
`session_count`	int	为该企业创建过的企业验证（KYB）会话总数
`approved_count`	int	结束状态为 `Approved` 的会话数
`declined_count`	int	结束状态为 `Declined` 的会话数
`in_review_count`	int	当前处于 `In Review` 状态的会话数
`features`	object	最新的公司验证状态，位于 `KYB` 键下

`features` 映射

{
  "KYB": "Approved"
}

该映射只包含一个键 KYB，其值为公司最新验证的状态："Not Finished"、"Approved"、"Declined"、"In Review" 或 "Resub Requested"。如需了解每个 KYB 功能的状态，请查看会话决策。如需快速检查企业当前是否已完全通过验证，且无需遍历所有会话，请使用 features 映射。

活动时间戳

字段	类型	更新时机
`first_session_at`	ISO 时间戳	创建第一个企业验证（KYB）会话时
`last_session_at`	ISO 时间戳	最近一个会话被创建或更新时
`last_activity_at`	ISO 时间戳	任何变更时：会话、交易、状态、资料、备注
`created_at`	ISO 时间戳	实体记录被创建时
`updated_at`	ISO 时间戳	实体记录最后一次更新时

元数据

字段	类型	说明
`metadata`	object (JSON)	由您控制的自由格式 JSON
`tags[]`	array	由控制台或 API 管理的标签

关联数据 (不存储在企业记录中)

关联数据	访问方式
企业验证（KYB）会话	`GET /v3/sessions?vendor_data=<value>`
关联用户（高管、UBO、董事）	在控制台的企业详情页面中显示；由最近一次已通过的企业验证（KYB）会话得出
交易（作为申请方或交易对手）	按企业 `vendor_data` 筛选交易
证件	通过企业验证（KYB）会话决策查看
AML 命中项	通过企业验证（KYB）会话决策查看

响应示例

{
  "uuid": "f7a9c1b2-4e6d-4f8a-9c5d-2a1b3c4d5e6f",
  "didit_internal_id": "B-2026-00018",
  "vendor_data": "biz-acme",
  "display_name": "Acme Corp",
  "legal_name": "Acme Corporation Limited",
  "registration_number": "12345678",
  "country_code": "GBR",
  "status": "ACTIVE",
  "session_count": 2,
  "approved_count": 1,
  "declined_count": 0,
  "in_review_count": 1,
  "features": {
    "KYB": "Approved"
  },
  "first_session_at": "2025-09-01T12:00:00Z",
  "last_session_at": "2026-04-01T09:00:00Z",
  "last_activity_at": "2026-04-16T10:00:00Z",
  "metadata": { "partner": "Acme Holdings" }
}

后续步骤

操作

创建、更新、修改状态、删除。

KYB 历史

检索与该企业相关的所有会话。

API 参考

GET /v3/businesses// 的结构定义。

最后修改于 2026年11月7日

概览

定价

工作流与验证

审核与运营

实体（用户与企业）

设置与自定义

安全与合规

Didit 学院

资源

企业数据模型：KYB 数据结构

身份字段

状态

会话汇总字段

`features` 映射

活动时间戳

元数据

关联数据 (不存储在企业记录中)

响应示例

后续步骤

操作

KYB 历史

API 参考

​身份字段

​状态

​会话汇总字段

​features 映射

​活动时间戳

​元数据

​关联数据 (不存储在企业记录中)

​响应示例

​后续步骤

操作

KYB 历史

API 参考

身份字段

状态

会话汇总字段

`features` 映射

活动时间戳

元数据

关联数据 (不存储在企业记录中)

响应示例

后续步骤