文档中心 > API类目 > 旅行度假API

qimen.alitrip.rentcar.refund.notify (退款接口回调)

1、此接口用于此场景商家执行操作后,飞猪通知api商家退款最终结果:商家通知飞猪退款接口后,如果商家签约了免密代扣协议,可以同步返回退款成功失败结果。但是如果商家未签约免密代扣协议,商家需要到天猫后台手动点击同意退款后才能退款成功。如商家在天猫后台操作了拒绝退款,则退款失败。 2、飞猪客服跟用户协商好退款后,飞猪通过此接口通知商家订单发生退款。并告知商家对应的退款金额和原因。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
traceId String 必须 89432798173257923 traceId
orderId String 必须 43883894038493 飞猪订单号
outOrderId String 必须 1249314 供应商订单号
refundUniqKey String 必须 23443 供应商退款幂等流水号(用户标记一次退款,相同流水号多次调用也只退一次)
refundType Number 必须 1 1:api商家通知飞猪退款结果回调 2:飞猪发起客服退款成功后通知商家
refundStatus Number 必须 1 退款状态,1:退款成功,2:退款失败
refundReason String 可选 与用户协商一致退款 主动发起退款原因,只当refundType = 2时,才会存在,
refundAmount String 可选 23.33 主动发起退款金额,保留两位小时,单位元,只当refundType = 2时,才会存在,
extra String 可选 {"errorCode":"1001","errotMessage":"风控拦截原因"} 扩展json数据

响应参数

名称 类型 示例值 描述
success Boolean true 通知是否成功
retCode String 1001 错误码
retMessage String 错误信息 错误信息

请求示例

{"traceId":"89432798173257923","refundType":1,"orderId":"43883894038493","refundReason":"与用户协商一致退款","outOrderId":"1249314","extra":"{\"errorCode\":\"1001\",\"errotMessage\":\"风控拦截原因\"}","refundUniqKey":"23443","refundStatus":1,"refundAmount":"23.33"}

响应示例

{
    "success":true,
    "retCode":"1001",
    "retMessage":"错误信息"
}

验签示例

{"success":"false","retMessage":"Illegal request","retCode":"sign-check-failure"}

错误码解释

错误码 错误描述 解决方案

API工具

FAQ

返回
顶部