查询待补件模板，上传证明并提交 JSON；L1、L2 均可通过 API 完成。

KYC 补件

商户通过 GET /v1/kyc/supplements 获取待补件的 id、level、message 和带 index 的 fields 模板，上传证明后调用 POST /v1/kyc/supplements/{id} 提交 JSON。L1 和 L2 均支持。

待补件使用 GET /v1/kyc/supplements，示例条目：

{
  "id": "ksup_456",
  "level": "L2",
  "message": "请补充证明材料",
  "fields": [
    { "index": 0, "label": "资金来源说明", "type": "text", "required": true },
    { "index": 1, "label": "补充证明", "type": "photo", "required": true }
  ],
  "created_at": "2026-09-24T12:05:00.000Z",
  "expires_in_days": 14
}

实际响应为 {data: [条目], next_cursor: null, has_more: false}，并保留兼容字段 hosted_url，纯 API 客户端可忽略它。列表包含 L1 和 L2，通过 level 区分。有效期是创建时间加 14 天，expires_in_days 为固定政策，不是剩余天数。

先上传补充证明，再调用 POST /v1/kyc/supplements/{id}（本例 id 为 ksup_456）：

{
  "answers": [
    { "index": 0, "value": "工资收入及储蓄，详见附件" },
    { "index": 1, "value": "<补充证明 file_url>" }
  ]
}

按服务端模板 index 提交，不要用翻译后的 label 作字段标识。text 最多 500 字符，photo 使用当前会员上传文件 URL；required=true 必须填写，选填项可省略。index 不得重复或超出模板范围。

成功 HTTP 200：{"id":"ksup_456","level":"L2","status":"submitted"}。工单和审核状态原子更新，进入补件复审。相同幂等键原样重试返回原结果；新幂等键重复提交已完成工单返回 state_invalid。

完整鉴权、上传及错误规则见 L2 接入说明。