API 参考 › 汇款

汇款订单详情

GET /v1/remittances/{id} scope: remittances:read

代会员调用 · 必带 x-on-behalf-of

⚠ 出参不含上游成本与我方毛利。你看到的是「这笔业务扣了你多少」。

按 status_version 做向前合并（只许向前更新）——

少了它，慢响应会把「已到账」打回「处理中」。

source_amount 与列表端点的 locked_amount 同形：都是插好小数点

的定点字符串（"500.250000"），位数由随行的 ledger_scale 给出。

（本页在 2026-08-13 之前写着「详情是未插小数点的整数串」—— 那是一段

已经修掉的实现留下的陈述，照它写解析器会差 10^ledger_scale 倍。）

status 与下单、列表两个端点同一份映射：pending_merchant_funds

（= 你的预付余额不足，会员的钱一分未动）在三处都收敛成 pending，

队列深度看 GET /v1/merchant/pending。其余状态一律原样露出 ——

认不出的状态请按「未知」渲染，别 default 成「处理中」。

⚠ supplement 是这一屏最容易被漏掉的一块。 它非 null 时说明

这单在等材料（我方审核期发起，或上游 RFI），而这类订单在你的会员

那一侧表现为「钱冻着、什么都没发生」。submit_url 是我方托管的

补件页，可以直接丢给终端用户（我方发给他的邮件里那颗按钮开的

就是同一个地址）。

⚠ submit_url 本身就是凭据（路径里带一次性令牌）：别写进日志、

别贴进工单、别放进任何会被第三方读到的地方。

它没有过期时间 —— 有效性的判据是工单状态 + 订单状态：

用户交完、这一轮被驳回换了下一轮、或订单结束，页面会自己说明情况。

所以别在你那一侧画倒计时，也别缓存它跨轮次复用。

supplement 的字段：

round 第几轮。一单可以补多次，每一轮是独立的一份要求；
status PENDING 等用户交 / SUBMITTED 用户交了、等我方或上游判。

两者要给用户看的界面完全不同，别折成一个布尔；

source upstream 上游 RFI（钱已在合作银行，这单撤不回来）/

admin 我方审核期发起（钱还冻在会员的 locked 桶里）。

两种情况该对用户说的话不一样；

items[].submitted 这一项交过没有。多项要求可以分两次传完 ——

缺了这一位你只能让用户把已经交过的再传一遍，而重传会覆盖上一次；

items[].label 已按语言取好词。想指定语言就带 Accept-Language，

不带则用该会员账号偏好的语言（= 他收到的那封邮件的语言）；

items[].type 这一项要交什么形态的东西。**今天只有 file 一个

取值**（上游那一侧同样只有「附件」一档，没有文本回答的通道）。

出这一位是为了将来多一档时你的 switch 有东西可判 —— 少了它，

新增一档的表现是「界面照旧只画上传框，而用户要交的是一段文字」，

全程零报错。认不出的取值请原样露出；

submitted_at 空串 = 还没交。

路径参数

字段	类型	必填	说明
`id`	string	必填	订单号。`rmt_` 前缀可带可不带（我方会剥掉）。

字段	类型	必填	说明
`x-on-behalf-of`	string	必填	代哪个会员调用。收 `external_member_id`（你自己的会员号）或我方发的 `mem_<uuid>`，两种都认。

响应

200OK

{
  "id": "rmt_9c1f0a7e-3b2d-4f81-9a55-1d2e3f4a5b6c",
  "status": "pending_docs",
  "source_asset": "USDT",
  "source_amount": "500.250000",
  "ledger_scale": 6,
  "payout_currency": "GBP",
  "payout_amount": "380.00",
  "status_version": 3,
  "supplement": {
    "round": 1,
    "status": "PENDING",
    "source": "upstream",
    "message": "Please provide proof of the source of funds.",
    "items": [
      {
        "field_key": "proof_of_funds",
        "label": "资金来源证明",
        "type": "file",
        "required": true,
        "submitted": false
      }
    ],
    "submit_url": "https://api.zise.com/remit/supplement/6f1c2b9d4a8e47f0b3d5c1a2e9f80b7c",
    "created_at": "2026-08-12T10:05:00Z",
    "submitted_at": ""
  },
  "created_at": "2026-08-12T09:30:00Z"
}

404not_found 这个订单不在这个会员名下，或根本不存在。 两种同一响应 —— 区分开等于送出一个订单号探测器。

请求

curl -X GET 'https://api.zise.com/v1/remittances/{id}' \
  -H 'x-auth-token: Bearer $TOKEN' \
  -H 'x-on-behalf-of: $MEMBER_ID'

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

import requests

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

req, _ := http.NewRequest("GET", "https://api.zise.com/v1/remittances/{id}",
    nil)
req.Header.Set("x-auth-token", "Bearer $TOKEN")
req.Header.Set("x-on-behalf-of", "$MEMBER_ID")
res, err := http.DefaultClient.Do(req)
// 金额字段用 string 接，不要 float64

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.zise.com/v1/remittances/{id}"))
    .header("x-auth-token", "Bearer $TOKEN")
    .header("x-on-behalf-of", "$MEMBER_ID")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
// 金额字段用 String / BigDecimal，不要 double

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

200

{
  "id": "rmt_9c1f0a7e-3b2d-4f81-9a55-1d2e3f4a5b6c",
  "status": "pending_docs",
  "source_asset": "USDT",
  "source_amount": "500.250000",
  "ledger_scale": 6,
  "payout_currency": "GBP",
  "payout_amount": "380.00",
  "status_version": 3,
  "supplement": {
    "round": 1,
    "status": "PENDING",
    "source": "upstream",
    "message": "Please provide proof of the source of funds.",
    "items": [
      {
        "field_key": "proof_of_funds",
        "label": "资金来源证明",
        "type": "file",
        "required": true,
        "submitted": false
      }
    ],
    "submit_url": "https://api.zise.com/remit/supplement/6f1c2b9d4a8e47f0b3d5c1a2e9f80b7c",
    "created_at": "2026-08-12T10:05:00Z",
    "submitted_at": ""
  },
  "created_at": "2026-08-12T09:30:00Z"
}

汇款订单详情

路径参数

请求头

响应