退款同步
接口说明
主动向支付通道同步退款状态。当退款状态为 progress 时调用，获取最新退款结果。适用于通道回调延迟或需要主动确认的场景。
请求地址
POST /mch/order/refund/sync?id={退款单ID}
- 认证：Sa-Token（请求头
Accesstoken） - 响应：
Result<RefundOrderResult>
参数通过查询字符串传递
id 是查询参数（@RequestParam），不是 请求体。请求体为空即可。
请求参数
| 参数 | 位置 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| id | query | long | 是 | 退款单 ID（数字） |
请求示例
http
POST /mch/order/refund/sync?id=1853123456789012345 HTTP/1.1
Host: your-domain.com
Accesstoken: xxxx-xxxx-xxxx
Content-Type: application/json响应参数
Result<RefundOrderResult>，data 字段结构同 申请退款 - 响应参数，主要返回：
| 参数 | 类型 | 描述 |
|---|---|---|
| id | long | 退款单 ID |
| refundNo | string | 系统退款号 |
| status | string | 同步后的退款状态（RefundOrderStatusEnum） |
| finishTime | string | 退款完成时间（UTC） |
| errorMsg | string | 错误信息（失败时） |
响应示例
json
{
"code": 0,
"message": "success",
"data": {
"id": "1853123456789012345",
"refundNo": "R2024120112345700001",
"status": "success",
"finishTime": "2024-12-01T06:00:00Z"
}
}