退款申请回调
当用户从交易的模板组件发起退款后,抖音开平交易系统会给向开发者的服务发起请求,用于通知开发者用户发起退款,开发者响应时需要返回必填的信息。
使用限制
无
接口说明
- •用户发起/过期自动退/客服退,交易系统都会请求开发者的“退款申请回调”接口。
- •退款单的创建是在退款申请回调之前,退款申请回调请求开发者服务失败,也不会在 C 端展示错误,退款申请回调请求失败后会进行重试。
- •请务必确保 退款申请回调请求能按照正确的格式和参数要求返回。
- •请求返回的外部退款单号也务必确保在同一小程序内不会重复,否则也会被认为请求失败。
- •开发者返回的 err_no 不为 0 也会认为请求失败,会进行重试,请确保请求成功,有拒绝退款的场景请在退款审核阶段拒绝退款。
- •如果一直请求开发者服务失败,退款单将无法被推进到退款审核阶段,请务必确保响应无问题。
- •退款申请回调务必做好幂等处理,相同的系统退款单号重复请求应当被视为相同的一次退款。
- •退款结果通知地址优先级:发起退款/退款申 请回调指定的 notify_url > 行业模板配置-消息通知中指定的回调地址 > 抖音开放平台-小程序应用详情-能力-支付页面设置的回调地址。
注意流程图中红色线条的部分。
客服退:
基本信息
基本信息 | |
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 | 是 | 是否需要退款审核:
不需要退款审核,则无需再调用 退款审核结果同步接口 | 1 |
refund_audit_deadline | int64 | 否 | 退款审核的最后期限,超过该期限无需商家审核,自动退款,13 位时间戳,单位毫秒 通常是3天(从退款发起时间开始算) | 151231321231 |
create_refund_time | int64 | 是 | 退款创建时间,13 位时间戳,单位毫秒 | 151231321230 |
refund_source | int8 | 是 | 退款来源:
| 1 |
cp_extra | string | 否 | cp 自定义字段,不支持二进制,长度 <= 2048byte | cp_extra |
refund_reason | Array | 否 | 退款原因,退款原因有多个 | ["不喜欢"] |
refund_description | string | 否 | 退款补充说明 | 想退款 |
refund_item_detail | object | 否 | 退款商品单信息 注意:交易系统订单退款必传 | |
refund_item_detail 说明
名称 | 类型 | 是否必填 | 描述 |