Z Zise Developers
账户中心 › 指南

「待补件」不是失败,是差几样东西。补件表单也是我方托管的。

补件

它是什么

审核员看了档案,觉得差几样东西(一份居留许可、一张更清楚的证件照、一句关于职业的说明)。这时状态是 SUPPLEMENT_REQUIRED,而不是 REJECTED

⚠ 界面上别把它显示成「认证失败」。两者对用户的含义完全不同:

一个是「你被拒了」,一个是「再传一样东西就好」。

显示成失败的表现是用户直接放弃。

你要做的


GET /v1/kyc/supplements
x-on-behalf-of: <external_member_id>

返回待办的补件工单,每条带一个托管填写链接。把链接交给用户即可。

那张表单上有什么

由审核员按这一单缺什么现搭,最多 10 项,每项是:

属性取值
标签审核员写的一句话,例如「请上传居留许可正面」
类型text(填一句话)或 photo(传一张图)
必填是 / 否

单个文件 ≤ 8 MB,同样按魔数嗅探真实类型。

表单是六语言的,按会员的语言出话 —— 你不需要做任何本地化。

状态怎么走


SUPPLEMENT_REQUIRED ──用户提交──► SUPPLEMENT_SUBMITTED ──审核──► APPROVED / REJECTED

每一步都发 kyc.result.updated

补件链接不登录也能打开(token 即凭证)。这是刻意的:终端用户

在你的系统里有账号,在我方这边没有。所以这条链接与 L1 那条一样,

拿到它的人就能以那个会员的名义提交材料 —— 别把它贴进公开渠道

相关端点