退款查询

查询键：refund_no 与 out_refund_no 至少填一个；两者都填时以 refund_no 为准。响应字段与退款发起一致。

接口说明

请求方式：【POST】/v1/wallet/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 平台退款单号；≤64；与 out_refund_no 至少填一个；两者都填时以本字段为准
out_refund_no string false 商户退款单号；≤64；与 refund_no 至少填一个

请求示例

{
  "out_refund_no": "RF202607300001"
}

应答参数

200 OK

参数名 类型 必填 描述
refund_no string false 平台退款单号
out_refund_no string false 商户退款单号
original_trade_no string false 原平台扣款单号
original_out_trade_no string false 原商户扣款订单号
refund_amount integer false 退款金额（分）
refund_status string false INIT / PROCESSING / SUCCESS / FAIL
create_time string false ISO 8601
order_finish_time string false 订单完成时间；成功或失败时有值

应答示例

200 OK

{
  "refund_no": "5101010120260730120000000001",
  "out_refund_no": "RF202607300001",
  "original_trade_no": "4101010120250525120000000001",
  "original_out_trade_no": "DED202505250001",
  "refund_amount": 1,
  "refund_status": "PROCESSING",
  "create_time": "2026-07-30T12:00:00+08:00"
}

错误码

公共错误码

状态码 错误码 描述 解决方案
401 SIGN_ERROR 验证不通过 请参阅【开发指引-整体说明】排查签名
400 PARAM_ERROR 参数错误 请根据错误提示正确传入参数
500 SYSTEM_ERROR 系统异常，请稍后重试 请稍后重试

业务错误码

状态码 错误码 描述 解决方案
非 200 NOT_FOUND 单不存在 核查单号
非 200 INVALID_PARAMETER 查询键均未传 至少传一个

应答示例

失败

{
  "code": "NOT_FOUND",
  "message": "交易失败"
}

应答示例

失败

{
  "code": "INVALID_PARAMETER",
  "message": "交易失败"
}