账户中心 › API 参考 › 商户账户

因预付不足而排队的订单（笔数 / 逐资产 / 最早一笔）

GET /v1/merchant/pending scope: merchant:read

商户自身

托管模型下，你的会员可能在自己余额充足的情况下交易失败 ——

因为你的预付备付金不够。会员侧的文案刻意不暴露原因

（只给 service_unavailable），所以整条链上唯一能把

「你该充值了」说清楚的地方就是这里。

排队中的订单一分钱都还没锁（会员的钱没动、你的预付也没冻）。

你充值之后由巡检自动推进；超过 pending_ttl_hours（缺省 24 小时）

仍未推进的会被取消。

推进是 FIFO，不按金额挑「能推的先推」—— 否则一笔大单会被永久

饿死而没有任何人看得出来（它一直在队列里、每一轮都被跳过）。

所以看 oldest_pending_since：它才是「最坏等了多久」。

逐 (业务线 × 资产) 一行，没有排队单的线不出现。

空数组 = 队列是空的，不是「查不到」。

响应

200OK

{
  "data": [
    {
      "line": "remit",
      "table": "remit_orders",
      "asset": "USDT",
      "orders": 7,
      "oldest_pending_since": "2026-08-12T02:15:41.220Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

403insufficient_scope 缺 merchant:read

请求

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

const res = await fetch("https://api.zise.com/v1/merchant/pending", {
  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/pending",
    headers={
        "x-auth-token": "Bearer $TOKEN",
    },
)
# 金额用 Decimal(str(...))，不要 float
data = res.json()

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

$ch = curl_init('https://api.zise.com/v1/merchant/pending');
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": [
    {
      "line": "remit",
      "table": "remit_orders",
      "asset": "USDT",
      "orders": 7,
      "oldest_pending_since": "2026-08-12T02:15:41.220Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}