GET /v1/merchant/statements

业务扣款记录（每单最终从预付扣了多少）

Scope merchant:read 商户自身

逐 (单据 × 资产) 一行，merchant_paid 是这一单最终从你的预付里

扣掉的净额（已冲掉退回的部分），所以一笔发起后又退款的单在这里是 0

而不是两行。

只出你付了多少这一条腿。 我方的手续费收入与我方付给上游的成本

不出参 —— 那是两套口径，混进对账单只会让你的账对不上。

⚠ merchant_paid 是定点整数串，位数看同一行的 ledger_scale。

ledger_scale 可能是 null（资产已下架或尚未登记）——

不要兜底成 6，那会让 8 位资产静静地错 100 倍。拿不到位数就把这个

数显示成「不确定」。

游标落在聚合值上，所以翻页时一笔单的两条腿不会被劈到两页。

from / to 过滤的是分录时间。

查询参数

字段	类型	必填	说明
`from`	string	可选	起始时间（含），ISO-8601 字符串，按字典序比较
`to`	string	可选	截止时间（含），ISO-8601 字符串
`asset`	string	可选	只看某个资产。大小写不敏感（服务端转大写）
`limit`	integer	可选	缺省 20、上限 100
`cursor`	string	可选	上一页的 `next_cursor`（不透明串）

响应

200OK

{
  "data": [
    {
      "posted_at": "2026-08-12T09:31:02.441Z",
      "business": "remit_lock",
      "ref_table": "remit_orders",
      "ref_id": "rmt_01J8Z6M2K9QF3H7V0",
      "merchant_paid": "1350000",
      "asset": "USDT",
      "ledger_scale": 6,
      "display_scale": 2
    }
  ],
  "next_cursor": "MjAyNi0wOC0xMlQwOTozMTowMi40NDFafHJtdF8wMUo4",
  "has_more": true
}

403insufficient_scope 缺 merchant:read

调用样例

curl -X GET 'https://api.zise.com/v1/merchant/statements' \
  -H 'authorization: Bearer $TOKEN' \
  -H 'x-zise-merchant: $MERCHANT_ID'

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

import requests

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