你提过的提现单（只读，没有发起口）

GET /v1/merchant/payouts scope: merchant:read

商户自身

⚠ 同样没有 POST，理由与地址簿那一条相同（强认证在机器接口上

保不住）。发起仍在商户后台；这一页是给你的财务系统用的：

我提的那笔审到哪了。 查询不新增任何提款出口。

状态：七档，认不出的原样回显

`status`	意思
`pending_review`	我方还没审
`approved`	已核准，待推出款
`rejected`	驳回，理由在 `review_note`
`dispatching`	已推给托管方，等链上确认
`dispatch_unknown`	结果不明 —— 见下
`paid`	已出款，交易号在 `tx_hash`
`failed`	终局失败

⚠ dispatch_unknown 既不是成功也不是失败：请求发出去了但结果

不明，钱可能已经出去了。它是绝缘态 —— 我方所有让钱再动一次的

路径对它一律拒，只能由人查证后收尾。不要据此再提一笔。

⚠ 我方随时可能加档，**认不出的状态请原样显示，不要 default 成

「处理中」** —— 那会让新增的那一档在你的界面上消失。

一行里两个金额是两种形态

amount_text —— 你在后台填的意向金额原文（十进制串）。
amount —— 我方核准时按资产精度解析出来的结算口径

（定点整数串，无小数点，位数看同一行的 ledger_scale）。

⚠ 未核准的单 amount 是 "0"，那不是「金额为零」，是「我方还

没解析出结算口径」。两者分开是因为「你填了什么」与「我方按什么金额

出款」都要能追溯。

address 是下单那一刻的快照，不是地址簿里的当前值 ——

地址簿改了备注或撤销了地址，历史单上的收款地址一个字都不会变。

keyset 游标，按 (created_at, id) 严格递减。

查询参数

字段	类型	必填	说明
`limit`	integer	可选	缺省 20、上限 100
`cursor`	string	可选	上一页的 `next_cursor`（不透明串）

响应

200OK

{
  "data": [
    {
      "id": "91b0f5c2-1d4a-4f77-8f01-6a2e9b3c7d10",
      "asset": "USDT",
      "amount_text": "20000",
      "amount": "20000000000",
      "ledger_scale": 6,
      "address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
      "status": "dispatching",
      "review_note": "",
      "tx_hash": "",
      "created_at": "2026-08-12T08:00:11.021Z",
      "updated_at": "2026-08-12T09:14:53.700Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

403insufficient_scope 缺 merchant:read

请求

curl -X GET 'https://api.zise.com/v1/merchant/payouts' \
  -H 'x-auth-token: Bearer $TOKEN'

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

import requests

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

req, _ := http.NewRequest("GET", "https://api.zise.com/v1/merchant/payouts",
    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/merchant/payouts"))
    .header("x-auth-token", "Bearer $TOKEN")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
// 金额字段用 String / BigDecimal，不要 double

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

200

{
  "data": [
    {
      "id": "91b0f5c2-1d4a-4f77-8f01-6a2e9b3c7d10",
      "asset": "USDT",
      "amount_text": "20000",
      "amount": "20000000000",
      "ledger_scale": 6,
      "address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
      "status": "dispatching",
      "review_note": "",
      "tx_hash": "",
      "created_at": "2026-08-12T08:00:11.021Z",
      "updated_at": "2026-08-12T09:14:53.700Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}