主题
退款查询
POST /api/refund/query
需要公共签名参数。虽然路由注册为任意 HTTP 方法,当前控制器仅解析表单和 JSON,不解析 URL 查询参数;推荐使用 POST JSON。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| refundOrderId | string | 二选一 | 平台退款单号,优先使用 |
| mchRefundNo | string | 二选一 | 商户退款单号 |
json
{ "mchNo": "M_DEMO", "appId": "APP_DEMO", "mchRefundNo": "REFUND_DEMO_001", "sign": "实际签名" }查询按商户归属校验,不额外按 appId 隔离同商户订单。查询读取本地权威状态;在途退款由后台查询收敛。
响应 data
包含 申请退款 的全部字段,并增加:
| 字段 | 类型 | 说明 |
|---|---|---|
| payOrderId | string | 原支付订单号 |
| mchNo、appId | string | 商户及应用标识 |
| currency | string | 币种 |
| extParam | string / null | 商户附加文本 |
| successTime、createdAt | integer / null | 毫秒时间戳 |
与支付查询不同,退款响应保留值为 null 的字段。外层成功结构为 {code:0,data:{...},sign:"..."},对 data 验签。内部结算恢复数据不会出现在开放响应中。