代付订单查询 (Payout Query)

接口描述

商户调用此接口主动查询代付（出款）订单的当前处理状态与详情。

---

请求信息

• 请求 URL：/payout/query
• 请求方式：POST
• Content-Type：application/json; charset=utf-8

---

请求头（HTTP Headers）

参数名	必填	类型	说明
merchantNo	是	String	商户号
sign	是	String	请求 Body 的 RSA 签名

---

请求 Body 参数

参数名	必选	类型	示例值	说明
timestamp	是	Long	1772880500000	毫秒级时间戳
merchantOrderNo	是	String	PO202603070001	商户订单号（下单时传入的唯一编号）

请求示例

{
  "timestamp": 1772880500000,
  "merchantOrderNo": "PO202603070001"
}

---

响应参数

成功返回示例

{
  "code": 1,
  "msg": "ok",
  "data": {
    "merchantNo": "M1639466186292",
    "merchantOrderNo": "PO202603070001",
    "platOrderNo": "876324486452871168",
    "amount": "220.00",
    "fee": "5.00",
    "status": "3",
    "payTime": "2026-09-09 22:22:22",
    "payAccountNo": "01666777888",
    "trxId": "SDIIFKISDL"
  }
}

失败返回示例

{
  "code": 0,
  "msg": "order not found"
}

返回参数说明

参数名	必选	类型	说明
code	是	Integer / String	业务状态码：1 成功，0 失败
msg	是	String	消息说明
data	是	Object	订单详细数据对象
data.merchantNo	是	String	商户号
data.merchantOrderNo	是	String	商户订单号
data.platOrderNo	是	String	平台内部订单号
data.amount	是	String	出款金额
data.fee	是	String	出款手续费
data.status	是	String	代付订单状态： 0: 已创建 1: 支付中 / 银行处理中 2: 失败 3: 成功
data.payTime	否	String	付款时间（格式：yyyy-MM-dd HH:mm:ss）
data.payAccountNo	否	String	付款账户
data.trxId	否	String	由电子钱包系统生成的唯一交易标识，用于标识本次交易