代收订单查询 (Pay-in Query)

接口描述

商户主动调用此接口查询代收订单的最新支付状态与详情。一般用于在未及时收到异步回调、或商户端订单对账场景。

---

请求信息

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

---

请求头（HTTP Headers）

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

---

请求 Body 参数

参数名称	必选	类型	示例值	备注
timestamp	是	Long	1772880200000	毫秒级时间戳
merchantOrderNo	是	String	202603070001	商户订单号（下单时传入的唯一编号）

请求示例

{
  "timestamp": 1772880200000,
  "merchantOrderNo": "202603070001"
}

---

响应参数

成功响应示例

{
  "code": 1,
  "msg": "success",
  "data": {
    "merchantNo": "M1639466186292",
    "merchantOrderNo": "202603070001",
    "platOrderNo": "876324486452871168",
    "amount": "220.00",
    "fee": "2.20",
    "payUrl": "https://gateway.example.com/checkout/876324486452871168",
    "expireTime": "2026-05-05 11:11:11",
    "status": "3"
  }
}

失败响应示例

{
  "code": 0,
  "msg": "param merchant error"
}

返回字段说明

字段名	类型	说明
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.expireTime	String	订单支付过期时间
data.payUrl	String	订单支付链接
data.status	String	订单状态： 0: 已创建 1: 过期 2: 失败 3: 成功