单笔订单退款回调通知

最新更新时间：2021.12.06

回调通知单笔订单退款结果。

温馨提示：
1.若在单笔订单退款接口中未给callbackUrl参数赋值，则不会触发该通知。
2.建议使用单笔订单退款结果查询接口作为辅助，确认订单最终退款状态。

---

接口说明

请求URL： 在单笔订单退款中所传的callbackUrl

请求方式： POST

业务请求参数

名称	必传	类型	说明
refundStatus	是	string	退款状态 WAIT:退款申请创建, SUCCESS:退款成功, FAILURE:退款失败, CLOSE:已关闭(例如超出退款期限)
osTradeNo	是	string	开放平台给商户的交易订单号
osRefundNo	是	string	本次退款的退款单号，开放平台内唯一
tpRefundNo	是	string	第三方机构退款单号
refundFee	是	int	本次退款金额
orderFee	是	int	交易订单的总金额，单位分
paymentFee	是	int	交易订单的用户实付金额 单位为分
refundTime	是	long	支付平台返回的退款时间，时间戳 ，标准北京时间
createdTime	是	long	退款申请时间，时间戳 ，标准北京时间
refundReason	否	string	退款原因，若请求退款时有值则返回
ownerBusinessNo	否	string	商户维护:商户创建的订单业务号，商户自传，支付回调原封返回
ownerRefundNo	否	string	商户维护:商户退款单号，商户自传，支付回调原封返回
ownerPayTerminal	否	string	商户支付终端，商户自传，支付回调原封返回

公共响应参数

名称	必传	类型	说明
code	是	int	请求结果code，成功返回8888,详细请参考错误码说明)
msg	是	string	请求结果描述，失败时会返回错误原因
data	否	Object	请求结果返回的业务响应参数，若无业务参数则返回空

注意：若成功接收到回调，请按照响应参数要求返回。若平台接收不到响应成功的参数，则会间隔一段时间后重复通知。

业务响应参数

无

入参格式

{
  "refundStatus":"SUCCESS",
  "osTradeNo": "os_trade_20211126",
  "osRefundNo": "os_refund_20211126",
  "refundFee": 400,
  "orderFee": 700,
  "paymentFee": 600,
  "refundTime": 1638003826072,
  "createdTime": 1638003819071,
  "refundReason": "退款原因"
}

出参格式：

{
  "code": 8888,
  "msg": "处理成功",
  "data": null
}

code 为 8888 表示操作成功，其它值则为失败，具体内容参见错误码说明)。