Skip to content

退款查询 ​

POST /api/refund/query

需要公共签名参数。虽然路由注册为任意 HTTP 方法,当前控制器仅解析表单和 JSON,不解析 URL 查询参数;推荐使用 POST JSON。

字段类型必填说明
refundOrderIdstring二选一平台退款单号,优先使用
mchRefundNostring二选一商户退款单号
json
{ "mchNo": "M_DEMO", "appId": "APP_DEMO", "mchRefundNo": "REFUND_DEMO_001", "sign": "实际签名" }

查询按商户归属校验,不额外按 appId 隔离同商户订单。查询读取本地权威状态;在途退款由后台查询收敛。

响应 data ​

包含 申请退款 的全部字段,并增加:

字段类型说明
payOrderIdstring原支付订单号
mchNo、appIdstring商户及应用标识
currencystring币种
extParamstring / null商户附加文本
successTime、createdAtinteger / null毫秒时间戳

与支付查询不同,退款响应保留值为 null 的字段。外层成功结构为 {code:0,data:{...},sign:"..."},对 data 验签。内部结算恢复数据不会出现在开放响应中。

接口行为以当前 payment 实现为准。示例商户号与密钥均为虚构。