API 参考 › 会员

会员详情（KYC 层级、处置态）

GET /v1/members/{id} scope: members:read

商户自身

路径参数两种标识都认：你自己的 external_member_id，或我方发出去的

mem_<uuid>。一个 API 发出去的标识必须能拿回来查。

kyc_level 折算方向只能取严：L2 通过而 L1 没通过（数据异常）时

算 1 而不是 2。反过来会让一个 L1 都没过的人被你当成完整实名用户。

⚠ 平台统一 KYC 有一个不可回避的信息后果：你新建的会员若此人此前

已在平台其他地方完成 KYC，你会立刻看到 kyc_level: 2。缓解手段是

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

做的 KYC」。

不出参：内部关联（推广路径 / 推荐人）、平台级处置态、风控标记、

KYC 档案与影像。status 只有商户级那一位。

路径参数

字段	类型	必填	说明
`id`	string	必填	`external_member_id`，或我方发出去的 `mem_<uuid>`。先按内部 id 查，查不到再按外部号查。

响应

200OK

{
  "id": "mem_9f1c0c8e-6f2a-4c1d-9d0b-2a7e5b3f8c41",
  "external_member_id": "u-10086",
  "uid": "80031427",
  "email": "alice@example.com",
  "nickname": "Alice",
  "status": "normal",
  "kyc_level": 1,
  "created_at": "2026-08-12T09:30:00.000Z"
}

404member_not_found —— 「不存在」与「属于别的商户」同一响应，区分开就等于给了一个跨商户会员探测接口

请求

curl -X GET 'https://api.zise.com/v1/members/{id}' \
  -H 'x-auth-token: Bearer $TOKEN'

const res = await fetch("https://api.zise.com/v1/members/{id}", {
  method: "GET",
  headers: {
    "x-auth-token": "Bearer $TOKEN",
  },
});
// 金额按字符串读，别让它变成 number
const data = await res.json();

import requests

res = requests.get(
    "https://api.zise.com/v1/members/{id}",
    headers={
        "x-auth-token": "Bearer $TOKEN",
    },
)
# 金额用 Decimal(str(...))，不要 float
data = res.json()

req, _ := http.NewRequest("GET", "https://api.zise.com/v1/members/{id}",
    nil)
req.Header.Set("x-auth-token", "Bearer $TOKEN")
res, err := http.DefaultClient.Do(req)
// 金额字段用 string 接，不要 float64

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.zise.com/v1/members/{id}"))
    .header("x-auth-token", "Bearer $TOKEN")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
// 金额字段用 String / BigDecimal，不要 double

$ch = curl_init('https://api.zise.com/v1/members/{id}');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'x-auth-token: Bearer $TOKEN',
  ],
]);
$res = curl_exec($ch);
// 金额用 bcmath / 字符串，不要 floatval

200

{
  "id": "mem_9f1c0c8e-6f2a-4c1d-9d0b-2a7e5b3f8c41",
  "external_member_id": "u-10086",
  "uid": "80031427",
  "email": "alice@example.com",
  "nickname": "Alice",
  "status": "normal",
  "kyc_level": 1,
  "created_at": "2026-08-12T09:30:00.000Z"
}