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

接口说明

  1. 收到用户申请退款的消息后,开发者可调用此接口进行异步处理,若拒绝退款,需要传拒绝原因
  2. 商家处理审核的时间为 24 小时,超时默认自动拒绝退款

使用限制

SLA:支持的最大QPS:50;PCT99承诺值:1000ms;

基本信息

名称描述
HTTP URL
https://open.douyin.com/goodlife/v1/homed/trade/payment/after/sale/merchant_audit/
HTTP Method
POST
Scope
life.capacity.homed.trade.payment.after.sale.merchant_audit
权限要求
  • 开发者需要申请权限:商家买单能力
    • 开放平台路径:抖音开放平台 > 控制台 > 应用详情 > 解决方案
    • 商家授权路径:抖音来客 > 店铺管理 > 第三方应用授权

请求参数

请求头
access-token必填String
示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
固定值"application/json"
Rpc-Transit-Life-AccountString

来客商户根账户ID

Body
account_id必填String
商家账户id
after_sale_id必填String

买单对应售后单号

audit_statusInt32

审核状态
1同意退款、 2拒绝退款

out_biz_after_sale_idString

外部商家对应的售后单号

reject_descString

商家拒绝时填写的其他原因的备注信息

reject_reasonString

必填,商家拒绝退款原因文案

请求示例
curl --location --request POST 'https://open.douyin.com/goodlife/v1/homed/trade/payment/after/sale/merchant_audit/' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --header 'Rpc-Transit-Life-Account: TPZO02ANaE' \ --data '{"account_id":"3I0XJfQKjz","after_sale_id":"kTLCK3FXHq","audit_status":2837791957463903501,"out_biz_after_sale_id":"KJJW8ifXlB","reject_desc":"p3ki5jpeac","reject_reason":"y0fSkrvbNd"}'

响应参数

Body展开全部子属性
data必填Struct
展开子属性
extra必填Struct
扩展信息
展开子属性
响应示例
正常响应示例异常响应示例
{ "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "20260108160031E22260F080C92987B83C", "now": 1767859233 }, "data": { "error_code": 0, "description": "" } }
切换单列布局

错误码

HTTP 状态码错误码错误码描述排查建议
2002100001
未知错误
重试接口,重试3次仍报错联系抖音生活服务技术支持
2002100004
系统繁忙,此时请开发者稍候再试
重试接口,重试3次仍报错联系抖音生活服务技术支持
2002100005
参数不合法
请根据接口错误返回信息调整参数
2002119001
参数不合法
请根据接口错误返回信息调整参数
2002119002
系统繁忙,请稍候再试
重试
2002119003
请求太过频繁,请稍后再试
重试
2002119005
应用未获商家授权
联系合作商家在商家后台发起授权,并在服务商后台同意授权
2002119010
接口已下线
接口已下线
2002190002
access_token无效
调用接口重新生成access_token
2002190004
应用未获得该能力, 请去https://open.douyin.com/申请
应用申请接口权限
2002190008
access_token过期,请刷新或重新授权
规范token刷新机制,检查是否有测试环境在同步刷新token
2003000001
根据实际业务错误返回
对照接口文档规范参数并重试
2005000001
根据实际业务错误返回
联系抖音处理
2003000010
以实际错误信息为准
请检查参数后重试
2003000004
以实际错误信息为准
请检查当前售后单
2003000005
以实际错误信息为准
请检查当前售后单状态,已通过情况下无需再次审核
2003000006
以实际错误信息为准
请检查当前售后单状态,已拒绝情况下无需再次审核
2003000009
以实际错误信息为准
检查参数
2003000003
以实际错误信息为准
请检查订单和售后单是否归属本商户
2003000007
以实际错误信息为准
检查参数
2005000001
系统错误,请重试
多次重试失败请联系抖音处理
2003000001
以实际错误信息为准
详见错误描述信息
2005000001
系统错误,请重试
多次重试失败请联系抖音处理
2003000002
以实际错误信息为准
请检查业务参数是否正确