查询退款单
接口说明
通过退款单号查询退款单详情，包含退款金额、状态、完成时间等信息。属于开放支付 API（RSA 签名）；仅查询本地退款单，不调用通道，需要实时通道状态请走 退款同步。
请求地址
POST /unipay/query/refund-order
- 认证：RSA 签名（
@PaymentVerify） - 响应：
DaxResult<RefundOrderResult>
请求参数
基础参数同 统一支付 - 基础参数，业务参数：
| 参数 | 类型 | 必填 | 最大长度 | 描述 |
|---|---|---|---|---|
| refundNo | string | 否* | 100 | 平台退款号 |
| bizRefundNo | string | 否* | 100 | 商户退款号 |
*两个单号至少传一个，优先级：refundNo > bizRefundNo
请求示例
json
{
"mchNo": "M200000001",
"appId": "APP001",
"reqId": "REQ20241201033",
"reqTime": "2024-12-01 12:33:00",
"sign": "Base64签名值",
"refundNo": "R2024120112345700001"
}响应参数
DaxResult<RefundOrderResult>，data 字段结构（对外精简版）：
| 参数 | 类型 | 描述 |
|---|---|---|
| refundNo | string | 平台退款号 |
| bizRefundNo | string | 商户退款号 |
| tradeNo | string | 原支付资金交易号 |
| bizOrderNo | string | 原支付商户业务订单号 |
| outRefundNo | string | 通道退款流水号 |
| amount | long | 退款金额（分） |
| orderAmount | long | 原订单总金额（分） |
| status | string | 退款状态（RefundOrderStatusEnum：progress / success / fail / close） |
| reason | string | 退款原因 |
| finishTime | string | 退款完成时间（北京时间，yyyy-MM-dd HH:mm:ss） |
| errorMsg | string | 错误信息 |
响应示例
json
{
"code": 0,
"msg": "success",
"data": {
"refundNo": "R2024120112345700001",
"bizRefundNo": "REFUND20241201001",
"tradeNo": "T2024120112345700001",
"bizOrderNo": "ORDER20241201001",
"outRefundNo": "5000050xxxxxxxxxxxx",
"amount": 100,
"orderAmount": 100,
"status": "success",
"reason": "用户申请退款",
"finishTime": "2024-12-01 14:00:00"
},
"sign": "Base64签名值",
"resTime": "2024-12-01 12:33:00",
"reqId": "REQ20241201033"
}使用建议
- 查询为幂等操作，仅返回本地已落库的数据；实时通道状态请优先使用 退款同步。