网关订单查询
接口说明
查询通过 网关预下单 创建的网关订单详情。
请求地址
POST /unipay/gateway/query
- 认证：RSA 签名（
@PaymentVerify） - 响应：
DaxResult<GatewayOrderResult>
请求参数
基础参数继承自 PaymentCommonParam（无需 mchNo 签名外的字段，但 mchNo 必填）：
| 参数 | 类型 | 必填 | 最大长度 | 描述 |
|---|---|---|---|---|
| mchNo | string | 是 | 32 | 商户号 |
| appId | string | 否 | 32 | 应用号 |
| reqId / nonceStr / sign / reqTime | — | — | — | 见 签名机制 |
| orderNo | string | 否* | 64 | 平台网关单号 |
| bizOrderNo | string | 否* | 100 | 商户业务单号 |
*
orderNo、bizOrderNo至少传一个，优先级：orderNo > bizOrderNo
请求示例
json
{
"mchNo": "M200000001",
"reqId": "REQ20241201011",
"reqTime": "2024-12-01 12:20:00",
"sign": "Base64签名值",
"orderNo": "G2024120112345700001"
}响应参数
DaxResult<GatewayOrderResult>，data 字段结构（18 字段）：
| 参数 | 类型 | 描述 |
|---|---|---|
| orderNo | string | 平台网关单号 |
| bizOrderNo | string | 商户业务单号 |
| gatewayType | string | 网关类型（cashier / aggregate） |
| title | string | 标题 |
| description | string | 描述 |
| amount | long | 金额（分） |
| currency | string | 币种 |
| status | string | 业务状态（GatewayOrderStatusEnum） |
| expiredTime | string | 过期时间（UTC） |
| payTime | string | 支付成功时间（UTC） |
| channel | string | 支付通道（用户最终选择的通道） |
| method | string | 支付方式 |
| product | string | 支付产品 |
| tradeNo | string | 资金交易号 |
| outOrderNo | string | 通道订单号 |
| fundStatus | string | 资金状态（PayFundStatusEnum） |
| attach | string | 商户附加参数（原样返回） |
| returnUrl | string | 同步跳转地址 |
网关订单状态（GatewayOrderStatusEnum）
| status | 说明 |
|---|---|
| wait_pay | 待支付 |
| paying | 支付中 |
| paid | 已支付 |
| failed | 支付失败 |
| closed | 已关闭 |
| expired | 已过期 |
响应示例
json
{
"code": 0,
"msg": "success",
"data": {
"orderNo": "G2024120112345700001",
"bizOrderNo": "ORDER20241201001",
"gatewayType": "cashier",
"title": "测试商品",
"amount": 100,
"currency": "CNY",
"status": "paid",
"payTime": "2024-12-01T04:05:00Z",
"channel": "wechat",
"method": "wechat_jsapi",
"tradeNo": "T2024120112345700001",
"fundStatus": "success",
"attach": "{\"orderId\": 123}",
"returnUrl": "https://your-domain.com/return"
},
"sign": "Base64签名值",
"resTime": "2024-12-01T04:20:00Z",
"reqId": "REQ20241201011"
}