Z Zise Developers
/
API 参考 › 发卡
GET /v1/cards/{id}/transactions

卡消费流水（游标分页）

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

⚠⚠ 这个端点目前一调用就 500，先别接。 它的 SQL 取的

kind / amount / currency / scale / occurred_at 五个列在

card_transactions 上并不存在（真实列名是 txn_type / card_change /

card_currency / card_scale / txn_at）。这是我方的缺陷，已登记待修；

修好之前这里描述的响应形状是它应有的样子，不是你现在能拿到的东西。

另：卡消费不外发 webhook（每笔消费一条会把事件流变成纯粹的调用量

放大器，而事件体只带 id 与状态，你拿到也只能回查）。流水靠这个端点拉。

路径参数

字段类型必填说明
id string 必填 卡 id

查询参数

字段类型必填说明
cursor string 可选 上一页的 next_cursor（不透明串）
limit integer 可选 缺省 20，上限 100
字段类型必填说明
x-on-behalf-of string 必填 代哪个会员调用

响应

200OK（按发生时间倒序）
{
  "data": [
    {
      "id": "ctx_2c9e4b10-77af-4d3a-8e51-b0d6c2f9a134",
      "kind": "auth",
      "status": "succeed",
      "amount": "12990000",
      "currency": "USD",
      "scale": 6,
      "merchant_name": "NETFLIX.COM",
      "mcc": "4899",
      "auth_code": "084217",
      "occurred_at": "2026-08-09T10:55:02.000Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}
404not_found 卡不存在，或不在这个会员/这个商户名下
500api_error —— 见上方警告，当前这是这个端点的实际行为
调用样例 
curl -X GET 'https://api.zise.com/v1/cards/{id}/transactions' \
  -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/{id}/transactions",
  {
    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/{id}/transactions",
    headers={
        "authorization": "Bearer $TOKEN",
        "x-zise-merchant": "$MERCHANT_ID",
        "x-on-behalf-of": "$MEMBER_ID"
    },
)
# 金额用 Decimal(str(...))，不要 float
data = res.json()