跳转到主要内容
POST
curl
在上一个链接失效时使用此方法:会话已被删除,或在该人员开始之前已过期。即使该人员已开始或完成验证,已删除的会话同样符合条件。导入的会话不因过期而符合条件,必须已被删除。未被删除且该人员已开始的会话,不能因过期而符合条件。 新会话关联到同一参与方,因此其结果会像原会话那样进入关键人员检查。其链接的有效期为所运行 KYC 工作流的会话有效期(1 小时至 4 周),而非企业会话的有效期。请在企业会话决策中查看参与方及其子会话。如果该人员完全不需要验证,请改为跳过该参与方。如需了解参与方及其验证的运作方式,请参阅关键人员。

授权

x-api-key
string
header
必填

您的应用 API 密钥,可在 Business Console 的“开发者 -> API 密钥”中获取。主密钥拥有完整访问权限。指定名称的密钥可设置作用域:针对每个资源设为无权限、只读或读写,限定于特定工作流或已通过的会话、限定于 IP 地址列表,以及设置到期日期。401 表示密钥错误、已撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或操作,或请求来自其 IP 列表之外的地址;在会话路由上返回 404 表示该会话不在该密钥允许的工作流或状态范围内。没有媒体访问权限的密钥获取到的图片、视频和 PDF URL 将为 null;没有会话写入权限的密钥获取到的会话链接和 token 将为 null。请参阅 https://docs.didit.me/console/api-keys。

路径参数

sessionId
string<uuid>
必填

父企业验证(KYB)会话的 UUID。

示例:

"33333333-4444-5555-6666-777777777777"

partyUuid
string<uuid>
必填

关键人员主体的 UUID(企业会话决策上的 key_people_checks[].submitted.parties[].uuid)。必须属于 sessionId 所引用的会话。

示例:

"0a3f1e2c-7c2f-4a1b-9d55-2f8d2a5d6b41"

响应

已创建新的 KYC 会话。返回包含新子会话的更新后当事方,该子会话将在其 KYC 工作流的会话过期时间后过期。

企业验证(KYB)会话的关键人员关联方及其子验证。同一关联方会出现在企业会话决策的 key_people_checks[].submitted.parties[] 中。

uuid
string<uuid>
必填

当事方标识符。

entity_type
enum<string>
必填

该主体是个人还是公司。

可用选项:
person,
company
source
enum<string>
必填

REGISTRY:从公司登记获取。USER:在关键人员页面中输入。

可用选项:
REGISTRY,
USER
name
string
必填

参与方的显示名称。

is_active
boolean
必填

该主体是否处于活跃状态。

is_skipped
boolean
必填

该主体是否免于验证。重新生成将清除此状态。

requires_verification
boolean
必填

角色和股权结构规则是否要求对此主体进行验证。

roles
object[]
必填

当事方在公司中担任的角色。

kyc_session_deleted
boolean
必填

子 KYC 会话已被删除,因此永远无法完成结算。

kyb_sub_session_deleted
boolean
必填

对应企业主体的 kyc_session_deleted。

first_name
string | null

名(个人)。

last_name
string | null

姓氏(自然人)。

company_name
string | null

企业名称(企业主体)。

registration_number
string | null

企业注册号(企业主体)。

email
string<email> | null

验证链接发送至的邮箱。

nationality
string | null

个人为国籍,企业为注册成立国家/地区。

phone_number
string | null

为该主体采集的电话号码。

date_of_birth
string<date> | null

出生日期(自然人)。

position
string | null

自由文本职位(个人)。

custom_fields
object

为该方收集的工作流定义自定义字段,按字段键索引。

kyc_session_id
string<uuid> | null

子个人 KYC 会话(个人)。

kyc_session_status
enum<string> | null

子 KYC 会话的状态。已删除的会话保留其被删除时的状态。

可用选项:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User,
null
kyc_session_url
string<uri> | null

子 KYC 会话的托管链接。在没有子会话、子会话已被删除,以及对于不具备 sessions: write 作用域的受限 API 密钥时为 null。

kyb_sub_session_id
string<uuid> | null

子 KYB 会话(企业各方)。

kyb_sub_session_status
enum<string> | null

子 KYB 会话的状态。

可用选项:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User,
null
kyb_sub_session_url
string<uri> | null

子 KYB 会话的托管链接,其 null 规则与 kyc_session_url 相同。

verification_workflow_type
enum<string> | null

子会话运行的工作流类型。

可用选项:
kyc,
kyb,
adaptive_age_verification,
biometric_authentication,
address_verification,
questionnaire_verification,
email_verification,
phone_verification,
null
verification_workflow_id
string<uuid> | null

子会话运行的工作流。

verification_workflow_label
string | null

该工作流的标签。

verification_workflow_features
object[] | null

子会话工作流的功能及其当前状态。

didit_internal_id
string<uuid> | null

已验证人员的 Didit 标识符(一旦获知)。

最后修改于 2026年11月7日