申请退款

我的收藏

使用限制

无

接口说明

抖音侧请求第三方申请退款，允许同步返回审核结果。当退款审核结果为接受，若传入手续费小于等于平台计算手续费，以平台计算罚金为准，否则视为拒绝。

若采用异步退款流程，同步返回待确认，需要配合退款回调接口使用

客服强退不会调用该接口，只调用退款通知接口

用户申请退款、过期自动退款、发码失败自动退会送审第三方审核。

接口请求成功时务必确保 error_code=0, 审核结果通过 data.result 字段返回。

若返回结果不符合规范, 即使error_code为0，抖音会当作发生错误。

若error_code不等于0或者发生错误（非4001 or 4002），抖音侧不会处理 data 中的数据，抖音会遵循指数间隔进行12次重试，最大重试间隔60秒。

若重试12次仍出错，则72小时后，抖音侧会自动通过退款。

发码失败自动退场景，请返回拒绝退款或者通过退款，不要返回错误（比如查不到订单）。

发码失败自动退场景，若第三方未创建过该订单，请谨慎返回拒绝退款（既没有发码又拒绝退款会产生大量客诉）。

发码失败自动退场景，原则上不允许返回拒绝退款or错误，若明确需要返回拒绝退款，需要和抖音侧申请加白。

基本信息

Scope	life.capacity.trip_traffic_order_refund
action	traffic.order.refund_apply
权限要求	行业解决方案-申请退款
回调场景	申请退款

请求头

•

Content-Type：application/json

•

X-Bytedance-Logid: 请求 logid，用于问题排查用

•

x-life-clientkey: 服务商应用的 client_key

•

x-life-sign: 请求签名，签名规则

请求参数

名称	类型	是否必填	描述	示例值
order_id	string	是	抖音侧订单 ID	100001
after_sale_id	string	是	退款ID（用于幂等）
refund_type	int32	是	退款类型 1-过期退 2-主动退 ~~3-客服强退~~ 4-未成交退款-如发码失败等（目前仅发码失败） 9-其他	1
certificates	list<object>	是	申请退款的券码列表
.certificate_id	string	是	一张券码的标识
.code	string	否	三方码（若发码失败为空）

请求示例

一单1份

{
    "order_id": "100001",
    "certificates":
    [
        {
            "certificate_id": "1111",
            "code": "code_11"
        }
    ]
}

一单3份

{
    "order_id": "100001",
    "certificates":
    [
        {
            "certificate_id": "1111",
            "code": "code_11"
        },
        {
            "certificate_id": "2222",
            "code": "code_22"
        },
        {
            "certificate_id": "2222",
            "code": "code_22"
        }
    ]
}

响应参数

名称	类型	是否必填	描述	示例值
data	object	是
.error_code	int	是	错误码，合法范围为 [0,999999]	0
.description	string	是	错误信息
.result	int	是	退款审核结果. 0:待确认,1:允许,2:拒绝（0:待确认为预留）
.reason	string	否	拒绝原因，若结果为拒绝时必填

响应示例

{
    "data": {
        "error_code": 0,
        "description": "success",
        "result": 1
      }
}

// 退款拒绝
{
    "data": {
        "error_code": 0,
        "description": "",
        "result": 2,
        "reason": "商品不支持退款"
      }
}

错误码

error_code	description	备注
0		成功，已成功处理也返回0
3001	系统异常	系统异常，抖音侧需要重试
4001	订单不存在	订单未在第三方创建过，抖音侧不会重试，会直接通过退款（请确认不重试直接通过退款不会造成问题再返回该错误码）
4002	退款单不存在	退款单未在第三方创建过，抖音侧不会重试，会直接通过退款（请确认不重试直接通过退款不会造成问题再返回该错误码）
...	...	失败，抖音侧需要重试