账户中心 › 指南
「待补件」不是失败,是差几样东西。补件表单也是我方托管的。
补件
它是什么
审核员看了档案,觉得差几样东西(一份居留许可、一张更清楚的证件照、一句关于职业的说明)。这时状态是 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 那条一样,
拿到它的人就能以那个会员的名义提交材料 —— 别把它贴进公开渠道。