感谢您的反馈!
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"}
| 错误码 | 错误描述 | 解决方案 |
|---|