Z Zise Developers
/
卡发行 › API 参考 › 开卡申请

实体卡物流（四条状态轴之一，不由其余派生）

GET /v1/cards/applications/{id}/shipment scope: cards:read
代会员调用 · 必带 x-on-behalf-of

实体卡有四条各自独立推进的状态轴：申请单 / 库存 / 物流 / 卡片。

任何一条都不许由另一条派生 —— 这个端点只出物流那一条。

想知道「用户能不能绑卡了」要看申请单状态，不是看这里的 delivered。

⚠ 「供应商处理中 / 制卡处理中」属于补货批次，不属于用户的申请单，

所以你在这里看不到它们 —— 那段时间这个端点会返回空数组，

不代表出了问题。

物流状态由运营录入（我方没接承运商 API），所以轮询它没有意义 ——

没有任何东西会因为你多问一次而前进。

按更新时间倒序，一张申请单可能有多条（补寄、退回再发）。不分页。

路径参数

字段类型必填说明
id string 必填 申请单 id。带不带 cap_ 前缀都收。
字段类型必填说明
x-on-behalf-of string 必填 代哪个会员调用。必须是这张单的主人 —— 不是则回 404。

响应

200OK。status 取值：draft · created · awaiting_pickup · in_transit · out_for_delivery · delivered（承运商说送到了）· received（用户确认签收， 与上一档刻意分开）· 以及六档异常：address_issue · delivery_failed · stalled · refused · returning · returned · lost · damaged。 时间字段没有值时是空串，不是 null。
{
  "data": [
    {
      "status": "in_transit",
      "carrier": "DHL",
      "tracking_no": "1234567890",
      "shipped_at": "2026-08-05T09:00:00.000Z",
      "delivered_at": "",
      "updated_at": "2026-08-07T14:22:11.000Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}
404not_found 申请单不存在，或不在这个会员/这个商户名下
请求 
curl -X GET 'https://api.zise.com/v1/cards/applications/{id}/shipment' \
  -H 'x-auth-token: Bearer $TOKEN' \
  -H 'x-on-behalf-of: $MEMBER_ID'
const res = await fetch("https://api.zise.com/v1/cards/applications/{id}/shipment", {
  method: "GET",
  headers: {
    "x-auth-token": "Bearer $TOKEN",
    "x-on-behalf-of": "$MEMBER_ID",
  },
});
// 金额按字符串读，别让它变成 number
const data = await res.json();
import requests

res = requests.get(
    "https://api.zise.com/v1/cards/applications/{id}/shipment",
    headers={
        "x-auth-token": "Bearer $TOKEN",
        "x-on-behalf-of": "$MEMBER_ID",
    },
)
# 金额用 Decimal(str(...))，不要 float
data = res.json()
req, _ := http.NewRequest("GET", "https://api.zise.com/v1/cards/applications/{id}/shipment",
    nil)
req.Header.Set("x-auth-token", "Bearer $TOKEN")
req.Header.Set("x-on-behalf-of", "$MEMBER_ID")
res, err := http.DefaultClient.Do(req)
// 金额字段用 string 接，不要 float64
HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.zise.com/v1/cards/applications/{id}/shipment"))
    .header("x-auth-token", "Bearer $TOKEN")
    .header("x-on-behalf-of", "$MEMBER_ID")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
// 金额字段用 String / BigDecimal，不要 double
$ch = curl_init('https://api.zise.com/v1/cards/applications/{id}/shipment');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'x-auth-token: Bearer $TOKEN',
    'x-on-behalf-of: $MEMBER_ID',
  ],
]);
$res = curl_exec($ch);
// 金额用 bcmath / 字符串，不要 floatval
200 
{
  "data": [
    {
      "status": "in_transit",
      "carrier": "DHL",
      "tracking_no": "1234567890",
      "shipped_at": "2026-08-05T09:00:00.000Z",
      "delivered_at": "",
      "updated_at": "2026-08-07T14:22:11.000Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}