Z Zise Developers
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_scopemerchant:read
调用样例
curl -X GET 'https://api.zise.com/v1/merchant/pending' \
  -H 'authorization: Bearer $TOKEN' \
  -H 'x-zise-merchant: $MERCHANT_ID'
const res = await fetch(
  "https://api.zise.com/v1/merchant/pending",
  {
    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/pending",
    headers={
        "authorization": "Bearer $TOKEN",
        "x-zise-merchant": "$MERCHANT_ID"
    },
)
# 金额用 Decimal(str(...)),不要 float
data = res.json()