支付订单查询

POST /api/pay/query

需要公共签名参数。读取本地权威状态，不会每次商户查单都请求上游；渠道回调和后台补单负责更新支付结果。

请求字段

字段	类型	必填	说明
payOrderId	string	二选一	平台支付订单号，优先使用
mchOrderNo	string	二选一	商户订单号

订单按当前商户归属校验，当前不额外按 appId 隔离同商户订单；响应使用调用应用密钥签名。两个字段同时提供时按 payOrderId 定位。推荐只传一个标识。

json

{ "mchNo": "M_DEMO", "appId": "APP_DEMO", "mchOrderNo": "ORDER_DEMO", "sign": "实际签名" }

响应 data

字段	类型	说明
payOrderId、mchNo、appId、mchOrderNo	string	平台与商户订单标识
ifCode、wayCode	string	实际渠道及支付方式；聚合订单未选择通道时 ifCode 可为空
amount	integer	支付金额，分
currency	string	币种
state	integer	支付状态，2 为成功
clientIp	string	客户端 IP
subject、body	string	商品标题、描述
channelOrderNo	string	本平台直接对接的上游渠道订单号
paymentVoucherTradeNo	string	用户支付宝 / 微信账单交易单号；渠道提供时返回
paymentVoucherMchOrderNo	string	用户支付宝 / 微信账单商户单号；渠道提供时返回
errCode、errMsg	string	渠道错误信息
extParam	string	商户附加文本
successTime、createdAt	integer	毫秒时间戳

值为 null 的可选字段会省略；不要要求 successTime 在支付中订单上存在。code=0 但 state=1 表示查询成功、支付仍在处理中。

json

{
  "code": 0,
  "data": {
    "payOrderId": "P_DEMO", "mchNo": "M_DEMO", "appId": "APP_DEMO",
    "mchOrderNo": "ORDER_DEMO", "ifCode": "alipay", "wayCode": "ALI_QR",
    "amount": 100, "currency": "cny", "state": 2,
    "subject": "测试商品", "body": "一笔测试订单"
  },
  "sign": "对data计算的签名"
}

示例省略部分时间和渠道字段。成功后核对商户订单号与金额再更新业务订单。

支付订单查询 ​

请求字段 ​

响应 data ​

支付订单查询

请求字段

响应 data