退款查询

按平台退款单号或商户退款单号查询退款结果。refund_no 与 out_refund_no 二选一。

接口说明

请求方式：【POST】/v1/subscription/refund/query

请求域名：【主域名】https://api.baofu.com

请求参数

Header 参数

参数名	类型	必填	描述
Authorization	string	true	请参考【开发指引-整体说明】生成认证信息
Accept	string	true	请设置为 `application/json`
Content-Type	string	true	请设置为 `application/json`

Body 参数

参数名	类型	必填	描述
refund_no	string	false	【平台退款单号】与 `out_refund_no` 至少填一个；两者都填时以本字段为准
out_refund_no	string	false	【商户退款单号】与 `refund_no` 至少填一个

请求示例

{
  "out_refund_no": "MRF202607240001"
}

{
  "refund_no": "RF01010120260724120000000001"
}

应答参数

200 OK

与退款发起应答同构：

参数名	类型	必填	描述
refund_no	string	true	平台退款订单号
out_refund_no	string	true	商户退款订单号
deduction_no	string	true	账单号
refund_amount	integer	true	退款金额（分）
refund_status	string	true	退款状态，取值：`PENDING` / `PROCESSING` / `SUCCESS` / `FAILED`
error_code	string	false	不下发（恒省略/null）
error_message	string	false	失败时有值；成功为 null/省略
create_time	string	true	创建时间，ISO 8601

应答示例

200 OK

{
  "refund_no": "RF01010120260724120000000001",
  "out_refund_no": "MRF202607240001",
  "deduction_no": "DD01010120260319120000000001",
  "refund_amount": 100,
  "refund_status": "SUCCESS",
  "create_time": "2026-07-24T12:00:00+08:00"
}

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数校验失败	必填参数缺失或格式不合法
401	SIGN_ERROR	验证不通过	请参阅【开发指引-整体说明】排查签名
500	SYSTEM_ERROR	系统异常	内部系统错误

业务错误码

状态码	错误码	描述	解决方案
404	ORDER_NOT_FOUND	查询对象不存在	退款单不存在
404	MCH_NOT_EXISTS	商户号不匹配	传入的 `merchantNo` 与订阅归属不一致

应答示例

失败

{
  "code": "ORDER_NOT_FOUND",
  "message": "退款单不存在"
}