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

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 '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/cards/applications/{id}/shipment",
  {
    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/cards/applications/{id}/shipment",
    headers={
        "authorization": "Bearer $TOKEN",
        "x-zise-merchant": "$MERCHANT_ID",
        "x-on-behalf-of": "$MEMBER_ID"
    },
)
# 金额用 Decimal(str(...))，不要 float
data = res.json()

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

路径参数

请求头

响应