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
}403
insufficient_scope 缺 merchant: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()