KYC 结论（level + 最小字段，无影像、无档案）

Scope kyc:read 代会员调用 · 必带 x-on-behalf-of

代会员调用，必带 x-on-behalf-of；缺了回

member_context_required（400），不会回落到任何默认会员。

只给结论。档案原件与影像绝不出平台，也永不下发「在哪个商户做的

KYC」（那会泄露跨商户信息）。

⚠ nationality 与 updated_at 只在 L1 已通过时有值，其余情况是**空串

而不是 null**。status 只有两档：approved（level ≥ 1）与 none。

它是 level 的派生值，不是一条独立的审核状态 —— 「审核中」「已驳回」

在这里都显示 none，要看进度走 GET /v1/kyc/supplements 与你自己的

引导流程。

各业务线要求几级见 GET /v1/kyc/requirements。

字段	类型	必填	说明
`x-on-behalf-of`	string	必填	代哪个会员调用。`external_member_id` 或我方发出去的 `mem_<uuid>` 都认。「不存在」「属于别的商户」「已停用」三种同一个 404。

响应

200OK

{
  "level": 1,
  "status": "approved",
  "nationality": "CN",
  "updated_at": "2026-08-10T04:12:33.100Z"
}

400member_context_required 没带 x-on-behalf-of

404member_not_found（含「属于别的商户」与「已停用」）

调用样例

curl -X GET 'https://api.zise.com/v1/kyc' \
  -H 'authorization: Bearer $TOKEN' \
  -H 'x-zise-merchant: $MERCHANT_ID' \
  -H 'x-on-behalf-of: $MEMBER_ID'

const res = await fetch(
  "https://api.zise.com/v1/kyc",
  {
    method: "GET",
    headers: {
      "authorization": "Bearer $TOKEN",
      "x-zise-merchant": "MERCHANT_ID",
      "x-on-behalf-of": "MEMBER_ID"
    },
  },
);
// 金额一律按字符串读，不要 JSON.parse 成 number
const data = await res.json();

import requests

res = requests.get(
    "https://api.zise.com/v1/kyc",
    headers={
        "authorization": "Bearer $TOKEN",
        "x-zise-merchant": "$MERCHANT_ID",
        "x-on-behalf-of": "$MEMBER_ID"
    },
)
# 金额用 Decimal(str(...))，不要 float
data = res.json()

KYC 结论（level + 最小字段，无影像、无档案）

请求头

响应