抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台

接口说明

用户在下单后自主申请取消订单,抖音侧通知商家处理。

基本信息

Scope
life.trade.meal_retail_spi_refund_apply
权限要求
回调场景

请求头

    Content-Type:application/json
    X-Bytedance-Logid: 请求 logid,用于问题排查
    x-life-clientkey: 服务商应用的 client_key

请求参数

名称
类型
是否必填
描述
示例值
order_id
string
抖音侧订单 ID
100001
after_sale_id
string
抖音侧退款单ID
100001
cancel_reason
string
取消原因
不想要了
cancel_code
string
取消编码(后续提供枚举)
101
remark
string
顾客申请的备注
请求示例

响应参数

名称
类型
是否必填
描述
示例值
data
struct
- error_code
int
错误码,合法范围为 [0,999999]
0
- description
string
错误信息
- result
int
审核退款结果(1:允许 2:拒绝 3:等待审核)
1
- out_after_sale_id
string
三方售后单号,如果result 返回1或者2,可以返回
100001
- reason_msg
string
拒绝原因 如果返回审核拒绝,则必填
已经出餐
- reason_code
int
拒绝编码 如果返回审核拒绝,则必填
101
响应示例
{ "data": { "error_code": 0, "description": "", "result": 2, "out_after_sale_id": "100001", "reason_msg": "已经出餐", "reason_code": 101 } }

错误码

    重试(最多 15次)
    创建订单失败(error_code!=0)
    服务商返回结果不符合协议,比如字段类型错误
error_code
description
备注
0
成功
100
...
抖音侧需要重试,其他错误码抖音不重试