法币查单 · YHT

XPay 商户接口 · 2026-11-09 更新 · 金额单位：人民币元

POST https://www.xpay.plus/v1/api/open/order/query
Content-Type: application/json; charset=utf-8
/v1/api/open/order/queryall 为同一查单能力的兼容入口，不是批量订单列表。

使用下单时同一 XPay 商户身份签名；只能查询本商户订单。所有字段按下单文档中的规则签名。

请求 JSON
{
  "appId": "YOUR_XPAY_APP_ID",
  "merchantOrderNo": "WEB-20261109-0001",
  "payType": "YHT",
  "signature": "REPLACE_WITH_COMPUTED_SIGNATURE"
}
已付款示例
{
  "code": 0,
  "message": "ok",
  "data": {
    "platformOrderNo": "YHT20261109000000DEMO01",
    "merchantOrderNo": "WEB-20261109-0001",
    "amount": "0.01",
    "status": 2,
    "payTime": 1794205651,
    "payUrl": "",
    "qrCode": "https://qr.alipay.com/EXAMPLE_ONLY",
    "yhtTradeNo": "CHANNEL_TRADE_NO",
    "notifyCount": 1,
    "lastNotifyTime": 1794205651,
    "upstreamChecked": true,
    "upstreamStatus": 2,
    "upstreamError": null,
    "merchantNotifyCaptured": false,
    "merchantNotifyReceivedAt": null
  }
}

本地订单状态 status

值含义
1待支付
2已支付
3已关闭 / 支付失败 / 超时关闭
4已全额退款
5已部分退款

payTime 为 Unix 秒级时间戳，未付款时为 0；不是日期字符串。code=0 表示查询成功，付款成功必须检查 data.status=2。

查询字段说明

字段含义
platformOrderNo / merchantOrderNo / amount核对订单身份与业务金额
payUrl / qrCode原订单支付内容；不能作为付款成功证明
yhtTradeNo渠道交易号，仅用于对账
notifyCount / lastNotifyTime平台收到的渠道通知次数与最后接收时间，不是商户收款次数
upstreamChecked / upstreamStatus实时渠道查询是否成功及渠道状态摘要。渠道状态不与本地 status 共用枚举；渠道 2 表示支付成功。
upstreamError查询无法完成时的固定业务提示；不包含渠道原始响应
merchantNotifyCaptured / merchantNotifyReceivedAt仅平台专用测试接收器的诊断结果。普通商户为 false/null，不代表自己的 notifyUrl 没有收到通知。
cashierPhase / upstreamSubmitted仅托管收银台订单可能返回；授权前可只有本地订单，还未向支付通道提交
如果渠道查询为成功而本地仍待支付，说明状态尚未收敛。继续查单或联系平台核查，勿重复付款。查询不会伪造回调或直接改写本地订单。

查询失败：1001 缺少参数；1002 签名错误；1005 商户不存在；1006 当前商户下未找到订单。请勿使用平台内部查询路径代替本页商户接口。