查询支付订单
接口说明
通过订单号查询系统订单详情，包含当前支付状态、金额等信息。
请求地址
POST /unipay/query/pay-order
- 认证：RSA 签名（
@PaymentVerify） - 响应：
DaxResult<NormalPayOrderResult>
请求参数
基础参数同 统一支付 - 基础参数，业务参数：
| 参数 | 类型 | 必填 | 最大长度 | 描述 |
|---|---|---|---|---|
| orderNo | string | 否* | 100 | 平台业务单号 |
| bizOrderNo | string | 否* | 100 | 商户订单号 |
*
orderNo、bizOrderNo至少传一个，优先级：orderNo > bizOrderNo
请求示例
json
{
"mchNo": "M200000001",
"appId": "APP001",
"reqId": "REQ20241201003",
"reqTime": "2024-12-01 12:10:00",
"sign": "Base64签名值",
"orderNo": "P2024120112345700001"
}响应参数
DaxResult<NormalPayOrderResult>，data 字段结构：
| 参数 | 类型 | 描述 |
|---|---|---|
| orderNo | string | 平台业务单号 |
| bizOrderNo | string | 商户订单号 |
| tradeNo | string | 资金交易号 |
| outOrderNo | string | 通道支付订单号 |
| title | string | 订单标题 |
| description | string | 订单描述 |
| channel | string | 支付通道（ChannelEnum） |
| method | string | 支付方式（PayMethodEnum） |
| limitPay | string | 限制支付类型（PayLimitPayEnum） |
| amount | long | 订单金额（分） |
| realAmount | long | 实际支付金额（分） |
| refundableBalance | long | 可退款余额（分） |
| status | string | 支付状态（PayStatusEnum） |
| refundStatus | string | 退款状态（PayRefundStatusEnum） |
| provider | string | 支付渠道（PayProviderEnum，如 WECHAT/ALIPAY） |
| payTime | string | 支付时间（UTC） |
| closeTime | string | 关闭时间（UTC） |
| expiredTime | string | 过期时间（UTC） |
| terminalNo | string | 终端设备编码 |
| storeNo | string | 门店号 |
| buyerId | string | 付款用户 ID |
| attach | string | 附加数据（原样返回） |
| errorMsg | string | 错误信息 |
退款状态（PayRefundStatusEnum）
支付订单维度的退款标记：
| refundStatus | 说明 |
|---|---|
| no_refund | 未退款 |
| refunding | 退款中 |
| partial_refund | 部分退款 |
| refunded | 全部退款 |
响应示例
json
{
"code": 0,
"msg": "success",
"data": {
"orderNo": "P2024120112345700001",
"bizOrderNo": "ORDER20241201001",
"tradeNo": "T2024120112345700001",
"outOrderNo": "WX2024120100001",
"title": "测试商品",
"channel": "wechat",
"method": "wechat_qr",
"amount": 100,
"realAmount": 100,
"refundableBalance": 100,
"status": "success",
"refundStatus": "no_refund",
"provider": "WECHAT",
"payTime": "2024-12-01T04:00:00Z",
"expiredTime": "2024-12-01T04:30:00Z",
"attach": "{\"orderId\": 123}"
},
"sign": "Base64签名值",
"resTime": "2024-12-01T04:10:00Z",
"reqId": "REQ20241201003"
}