通知退款结果

我的收藏

使用限制

无

接口说明

抖音侧完成退款后，通知第三方实际退款结果。

通知类型的接口 请勿返回业务类型的错误（譬如订单不存在），返回系统类型的错误抖音侧可以重试。

接口请求成功时务必确保 error_code=0

若 error_code 不为 0，不处理 data 中的数据，抖音会十分钟内多次重试

基本信息

Scope	life.capacity.trip_traffic_order_refund
action	traffic.order.refund_notify
权限要求	行业解决方案-退款结果通知
回调场景	退款结果

请求头

•

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-其他
notice_list	list<object>	是	退款通知列表
.certificate_id	string	否	券ID
.code	string	否	三方码
.apply_time	int	否	退款申请时间，时间戳，秒
.audit_time	int	否	退款审核时间，时间戳，秒
.audit_result	int	是	审核结果： 1-同意，2-拒绝

请求示例

一单1份

{
      "order_id": "12345678",
      "notice_list": [
            {
                  "certificate_id": "987654321",
                  "code": "abcd1234",
                  "apply_time": 1632657476,
                  "audit_time": 1632657486,
                  "audit_result": 1
            }
      ]
}

一单3份

{
      "order_id": "12345678",
      "notice_list": [
            {
                  "certificate_id": "987654321",
                  "code": "abcd1234",
                  "apply_time": 1632657476,
                  "audit_time": 1632657486,
                  "audit_result": 1
            },
            {
                  "certificate_id": "987654322",
                  "code": "abcd1235",
                  "apply_time": 1632657476,
                  "audit_time": 1632657486,
                  "audit_result": 1
            },
            {
                  "certificate_id": "987654323",
                  "code": "abcd1236",
                  "apply_time": 1632657476,
                  "audit_time": 1632657486,
                  "audit_result": 1
            }
      ]
}

响应参数

名称	类型	是否必填	描述	示例值
data	object	是
- error_code	int	是	错误码，合法范围为 [0,999999]	0
- description	string	是	错误信息

响应示例

{
    "data": {
        "error_code": 0,
        "description": "",
    }
}

错误码

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