退款订单查询

退款查询

按商户退款单号查询退款资金终态及完成时间。refund_status 取值 SUCCESS / PROCESSING / FAILED；refund_finish_time 仅成功且有值时返回，格式 yyyyMMddHHmmss。

接口说明

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

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

请求参数

Header 参数

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

Body 参数

参数名	类型	必填	描述
out_refund_no	string	true	商户退款单号，≤64 字符

请求示例

{
  "out_refund_no": "REF20260622001"
}

应答参数

200 OK

参数名	类型	必填	描述
refund_status	string	true	SUCCESS / PROCESSING / FAILED
out_refund_no	string	true	商户退款单号
out_trade_no	string	false	原支付商户订单号（有则返回）
refund_no	string	false	宝付退款流水号
refund_total_amount	integer	false	退款金额，单位分
refund_finish_time	string	false	退款完成时间 yyyyMMddHHmmss；仅成功且有值时返回

应答示例

200 OK

{
  "refund_status": "SUCCESS",
  "out_refund_no": "REF20260622001",
  "out_trade_no": "20260609120001001",
  "refund_no": "20251218173125013031185289875340",
  "refund_total_amount": 100,
  "refund_finish_time": "20260720143000"
}

错误码

公共错误码

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