跳转到主要内容
企业验证在多个层级跟踪状态:会话、各项功能、公司登记查询和 AML 结果。本页是每个状态的参考说明。 API 返回的状态值是精确且区分大小写的标签,例如 "In Progress" 和 "Not Finished",与 Webhook 中传递的字符串一致。 请按这些字符串进行匹配,不要依赖大写名称。

会话状态

企业验证(KYB)会话的整体状态,也是你最常需要判断的字段。
"Awaiting User" 是临时状态,你无需手动将会话移出该状态。终端用户一旦完成待办操作,例如提交关键人员名单或重新上传被要求的文件,Didit 会重新评估会话,并根据结果自动将其转为 "In Review"、"Approved" 或 "Declined"。

功能状态

每项 KYB 功能都有自己的状态,并汇总为会话状态。

KYB 功能名称

以下是 KYB 会话的 features 字段值,也会出现在 Webhook 中:
  • KYB_REGISTRY:公司登记查询。
  • AML:公司层面的 AML 筛查。
  • KYB_DOCUMENTS:证件收集与 OCR。
  • KYB_KEY_PEOPLE:关键人员,包括 UBO、股东、董事、代表及其他高管。

注册机构状态(来自服务商)

公司在权威登记来源中的官方状态。它反映辖区内登记机构报告的实体法律或监管地位,因此具体取值因来源而异。该状态出现在 KYB 决策的 company.registry_status 字段中。
由于 registry_status 反映的是登记机构的原始值,如果你需要一个跨辖区一致的指标来驱动产品逻辑,请使用下方的 verification_status。

公司验证状态

这是面向企业的标准化状态,针对每个公司结果提供。它将不同国家和来源的登记状态统一为一个一致的指标,可直接在你的产品中解读。该状态出现在 KYB 决策的 company.verification_status 字段中。

公司数据获取状态

表明从外部或官方登记机构获取某家公司记录的数据进度。用它来判断某家公司的已获取信息有多完整。该状态出现在 KYB 决策的 company.fetch_status 字段中。

AML 验证状态

按每次筛查(公司或个人)返回。

决策如何自我说明

KYB 决策不会携带单一的原因代码字符串。 每个功能数组(registry_checks[]、document_verifications[]、key_people_checks[]、aml_screenings[])都包含 warnings[],其中带有 KYB_* 和 AML 标签,decision_trace 则记录决策的得出过程。 请查看 KYB 警告 中的标签,并将其与会话状态一同记录。 当审核员对照平台自身的汇总结果手动设置状态时,决策会携带 status_override,以及 overridden_at 时间和平台原本会设置的 automatic_status。 请参阅响应结构。

后续步骤

响应结构

查看每个状态在 payload 中的位置。

风险评估

影响 KYB 结果的因素。

Webhook

状态变更时触发的事件。
最后修改于 2026年11月7日