代收查单接口

用于查询 PayIn 订单状态，建议在未收到回调或状态不明确时主动查询。

1. 接口信息

项目	说明
HTTP Method	POST
URL	/payIn/orders/query
Content-Type	application/json
认证	商户签名（X-Merchant-Id / X-Timestamp / X-Nonce / X-Sign）

签名规则参考 签名与验签。

2. 请求参数

2.1 顶层字段

字段	类型	必填	说明
merchantOrderNo	String	是	商户订单号

请求示例：

{
  "merchantOrderNo": "M202412220001"
}

3. 响应参数

统一返回结构：

{
  "success": true,
  "data": {
    "payNo": "P202412220001",
    "merchantOrderNo": "M202412220001",
    "tradeNo": "T202412220001",
    "status": "SUCCESS",
    "amount": 100.00,
    "currency": "USD",
    "createdAt": 1734921000000,
    "updatedAt": 1734921005000,
    "expireAt": 1734922800000
  },
  "errCode": null,
  "errMsg": null
}

data 字段

字段	类型	说明
payNo	String	平台订单号
merchantOrderNo	String	商户订单号
tradeNo	String	平台交易号
status	String	订单状态（见下表）
amount	Decimal	订单金额
currency	String	币种
createdAt	Long	创建时间（毫秒时间戳）
updatedAt	Long	更新时间（毫秒时间戳）
expireAt	Long	过期时间（毫秒时间戳）
action	Object	支付动作（仅在支付中且需要跳转/二维码时返回）

状态说明

状态	含义
INIT	订单已创建，尚未进入支付流程
SUCCESS	支付成功
FAIL	支付失败
EXPIRED	订单已过期
CLOSED	订单已关闭
USER_PAYING	支付中

action 字段

字段	类型	说明
type	String	REDIRECT / QR
url	String	跳转链接（当 type=REDIRECT）
qrContent	String	二维码内容（当 type=QR）
expiresAt	Long	过期时间（毫秒时间戳，UTC）

createdAt / updatedAt / expireAt 为毫秒时间戳（UTC）。