这单在等用户做什么（重新确认 / 补件 / 无）

Scope remittances:read 代会员调用 · 必带 x-on-behalf-of

没有这个端点，你只能轮询订单详情去猜。 而「等重新确认」

有 4 小时时效，过期就自动退款 —— 商户完全不知道自己错过了什么，

用户只看到一笔莫名其妙退回来的钱。

action 为 null = 此刻不需要用户做任何事（正常处理中、

或已终态、或算不出来）。null 不是错误，别渲染成异常。

action 非 null 时它就是「重新确认」那一档（kind: "slippage"）：

把 old_total → new_total 的差额（extra_charge）摆给用户，

倒计时用 deadline，用户同意就把 new_total 原样发给

POST /v1/remittances/{id}/reconfirm。

can_accept: false 时不要显示确认按钮，看 reject_reason：

insufficient_balance 会员余额不够补冻 —— 让他先充值；
too_many_rounds 轮数用尽 —— 只剩取消或等过期。

⚠ extra_charge 与 extra_locked 是两个数：前者是他要多付的钱，

后者是要多冻的（含滑点预留，所以 ≥ 前者）。给用户看前者，

余额够不够按后者判。

⚠ 这里的价来自上一次分发时上游要多少，不是一次新报价 ——

我方不会为了渲染这一屏去问上游（报价只活 75 秒，用户看到时必然

已过期，而每问一次都是一次带幂等键的上游写调用）。它是决策依据，

不是承诺；真正的成交价在放行那一刻定，用户原来设的滑点上限仍然罩着它。

路径参数

字段	类型	必填	说明
`id`	string	必填	订单号。`rmt_` 前缀可带可不带。

字段	类型	必填	说明
`x-on-behalf-of`	string	必填	代哪个会员调用。

响应

200有待办时 action 非 null；无待办时 {"id": "...", "action": null}。

{
  "id": "rmt_9c1f0a7e-3b2d-4f81-9a55-1d2e3f4a5b6c",
  "action": {
    "kind": "slippage",
    "moved_bps": 137,
    "slippage_bps": 100,
    "old_total": "499.980000",
    "new_total": "512.340000",
    "extra_charge": "12.360000",
    "extra_locked": "12.483600",
    "available": "820.500000",
    "can_accept": true,
    "reject_reason": "",
    "deadline": "2026-08-12T13:30:00Z"
  }
}

404not_found 订单不在这个会员名下，或不属于你。

调用样例

curl -X GET 'https://api.zise.com/v1/remittances/{id}/pending-action' \
  -H 'authorization: Bearer $TOKEN' \
  -H 'x-zise-merchant: $MERCHANT_ID' \
  -H 'x-on-behalf-of: $MEMBER_ID'

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

import requests

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

这单在等用户做什么（重新确认 / 补件 / 无）

路径参数

请求头

响应