代收订单查询 (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",
    "payTime": "2026-09-09 22:22:22",
    "payAccountNo": "01666777888",
    "trxId": "SDIIFKISDL"
  }
}

失败响应示例

{
  "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: 成功
data.payTime	否	String	付款时间（格式：yyyy-MM-dd HH:mm:ss）
data.payAccountNo	否	String	付款账户
data.trxId	否	String	由电子钱包系统生成的唯一交易标识，用于标识本次交易