订单查询接口

USDT 按当前商户的 merchantOrderNo 查询单笔订单；响应 pay_usdt 为最终应付 USDT 数量，不依赖 pay_money 或法币汇率。USDT queries return one merchant-scoped order; pay_usdt is the final payable amount.

请求地址
/v1/api/open/order/query
请求参数 
curl -X POST 'https://xpay.plus/v1/api/open/order/query' \
  -H 'Content-Type: application/json' \
  -d '{
    "appId":"Zu78qwe1",
    "merchantOrderNo":"Order202409291231",
    "signature":"6F3B90783FABE56DBB771D03E0EAADD0"
  }'

请求示例

请求参数 
{
  "appId": "Zu78qwe1",
  "merchantOrderNo": "Order202409291231",
  "signature": "6F3B90783FABE56DBB771D03E0EAADD0"
}

返回示例

返回结果 
{
  "code": 0,
  "message": "success",
  "data": {
    "payUrl": "https://xpay.plus/payment/index/order/id/Order202409291231",
    "orderNo": "PO202601010001",
    "merchantOrderNo": "Order202409291231",
    "status": "0",
    "pay_usdt": "10.00",
    "recovered": true
  }
}

微信直连查单扩展

请求地址仍为 POST /v1/api/open/order/query，提交 payType=WECHAT 并将其参与 XPay MD5 签名。

请求参数
{
  "appId": "Zu78qwe1",
  "merchantOrderNo": "WX202608140001",
  "payType": "WECHAT",
  "signature": "..."
}

返回字段与支付宝直连查单一致，tradeNo 为微信支付订单号。待支付订单还会由 wechat:poll 定时主动同步。

支付宝直连查单扩展

请求地址仍为 POST /v1/api/open/order/query。增加 payType=ALIPAY，并将该字段一起参与 XPay MD5 签名。

请求参数 
{
  "appId": "Zu78qwe1",
  "merchantOrderNo": "ALI202608070001",
  "payType": "ALIPAY",
  "signature": "..."
}
返回结果 
{
  "code": 0,
  "message": "ok",
  "data": {
    "platformOrderNo": "ALI20260807110917E2BF35",
    "merchantOrderNo": "ALI202608070001",
    "amount": "20.00",
    "status": 2,
    "tradeNo": "2026080722000000000001",
    "payTime": 1786072157
  }
}
status说明
1待支付
2已支付
3已关闭