退款申请回调
收藏我的收藏
当用户从交易的模板组件发起退款后,抖音开平交易系统会给向开发者的服务发起请求,用于通知开发者用户发起退款,开发者响应时需要返回必填的信息。
使用限制
- 1.该文档已废弃,请转移到以下目录查看对应文档
- a.融合(退款扩展点)
- b.非融合(退款申请回调)
接口说明
- •用户发起/过期自动退/客服退,交易系统都会请求开发者的“退款申请回调”接口。
- •订单未核销且用户发起过期自动退时,商家不得拒绝退款;如需拒绝,需先完成核销。过期退流程中可正常发起核销,订单未核销则 48 小时后系统自动退款。
- •退款单的创建是在退款申请回调之前,退款申请回调请求开发者服务失败,也不会在 C 端展示错误,退款申请回调请求失败后会进行重试。
- •请务必确保退款申请回调请求能按照正确的格式和参数要求返回。
- •请求返回的外部退款单号也务必确保在同一小程序内不会重复,否则也会被认为请求失败。
- •开发者返回的 err_no 不为 0 也会认为请求失败,会进行重试,请确保请求成功,有拒绝退款的场景请在退款审核阶段拒绝退款。
- •如果一直请求开发者服务失败,退款单将无法被推进到退款审核阶段,请务必确保响应无问题。
- •退款申请回调务必做好幂等处理,相同的系统退款单号重复请求应当被视为相同的一次退款。
注意流程图中**红色线条**的部分
客服退
基本信息
基本信息 | |
HTTP URL | |
HTTP Method | POST |
权限要求 | 无 |
请求头
请求参数
名称 | 类型 | 是否必填 | 描述 | 示例 |
msg | string | 是 | 退款单相关信息的 json 字符串 | ot1231231 |
type | string | 是 | 枚举值:
| pre_create_refund |
version | string | 是 | 固定值:"2.0"。 回调版本,用于开发者识别回调参数的变更 | 2.0 |
msg 说明 (msg 是 json 格式字符串)
名称 | 类型 | 是否必填 | 描述 | 示例 |
app_id | string | 是 | 小程序的 appid | ttqweqw12312 |
open_id | string | 是 | 用户 openid | 123123 |
refund_id | string | 是 | 抖音开平侧退款单号 | ot1231313 |
order_id | string | 是 | 抖音开平侧订单号 | ot1231312 |
out_order_no | string | 是 | 开发者侧订单号 | 213123 |
refund_total_amount | int64 | 是 | 退款总金额,单位分 | 100 |
need_refund_audit | int8 |


