发起退款
收藏接口说明
接口说明：
本接口用于餐饮&综合的SaaS 商家向抖音开放平台发起团购订单核销后退款的申请，支持指定订单、券 ID、退款金额、退款原因等核心信息，完成退款流程的提交。接口采用 HTTP POST 方式调用，所有请求参数需以 JSON 格式传递，且仅支持已完成核销的订单退款场景
使用限制
使用规则&限制
- 退款维度：支持单券维度退款。
- 支持整单退款&部分多次退款。退款方式：
- 全额退款：退还消费者实际支付的全部金额，原路返回；
- 部分退款：商家可自定义退款金额，多次退款；
适用范围
- 订单类型：团购订单、代金券订单；
- 时间限制：订单核销后 30 天内 可发起自助退款，超过 30 天需联系客服；
- 商家范围：全量餐饮、综合购物等商家
- 团购券库存是否回补取决于退款场景和库存策略设置：未使用的团购券退款通常会恢复库存，使用后仅退款一般不恢复。
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/goodlife/v1/groupon/order/refund/apply/ |
| HTTP Method | POST |
| Scope | life.capacity.groupon.order.refund.apply |
请求参数
请求头
access-token必填String
示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
固定值"application/json"
Rpc-Transit-Life-AccountString
来客商户根账户ID
Body
account_id必填String
账户ID
order_id必填String
订单ID·
refund_reason_code必填Array<Int64>
退款原因枚举
102 | 没看清使用规则，要用时才发现有限制 |
103 | 其他平台/方式购买更优惠 |
106 | 商家营业但不接待 |
107 | 商家停业/装修/转让 |
109 | 朋友/网上评价不好 |
114 | 不能送外卖 |
116 | 可用的门店距离太远 |
117 | 担心安全问题（疫情、天气等） |
118 | 需要加价/购买其他产品才能用 |
119 | 服务态度不好 |
122 | 实际与宣传/描述不一样 |
123 | 商家服务态度差 |
125 | 商家要求改用其他方式/平台付款 |
158 | 电话/发消息联系不上商家 |
161 | 排队太久/预约不上位置、包厢等 |
211 | 商家餐品有质量问题 |
212 | 商家地址信息错误,找不到店铺 |
213 | 不满足使用条件 |
215 | 因排队等原因放弃使用 |
217 | 商家设备/环境有质量问题 |
304 | 因疫情/天气等不可抗力 无法使用 |
305 | 个人原因无法到店使用 |
306 | 券被错误核销 |
401 | 计划有变，暂时不需要了 |
402 | 买多了/买错了 |
406 | 商家缺货 |
999 | 其他原因（需填写备注） |
certificate_id_listArray<String>
券ID, 和券code二选一传入
code_listArray<String>
券code，和券ID二选一传入
out_after_sale_idString
外部售后单ID、如果传入同时也视为幂等ID
refund_amountInt64
退用户金额(用户实付+支付优惠)，单位分，不填默认退剩余全部
refund_reason_descString
退款原因说明
请求示例
curl --location --request POST 'https://open.douyin.com/goodlife/v1/groupon/order/refund/apply/' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{"refund_reason_desc":"m5w94r0pG5","code_list":["Acc34S7XuI"],"out_after_sale_id":"8AENsc2iMo","refund_reason_code":[3231251066750117689],"account_id":"IXlngBnaW7","refund_amount":5258743426434471972,"order_id":"P3tdpU7OMG","certificate_id_list":["AuPlFaur4a"]}'
响应参数
Body展开全部子属性
data必填Struct
展开子属性
extra必填Struct
扩展信息
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "order_id": "J1vcnWFnJN", "success": false, "after_sale_id": "L92Lxv90h2", "after_sale_info_list": [ { "after_sale_id": "EIKPkcVogr", "item_order_id": [ "gZ9K8FkNy4" ], "certificate_id": [ "QEaqblSLT3" ], "code_list": [ "BMJFhC88bO" ], "order_id": "VROl4S9E4U" } ], "error_code": 0, "description": "" }, "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "20260521194252437084AF91C349B4ED24", "now": 1779363779 } }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 2100001 | 未知错误 | 重试接口，重试3次仍报错联系抖音生活服务技术支持 |
| 200 | 2100004 | 系统繁忙，此时请开发者稍候再试 | 重试接口，重试3次仍报错联系抖音生活服务技术支持 |
| 200 | 2100005 | 参数不合法 | 请根据接口错误返回信息调整参数 |
| 200 | 2119001 | 参数不合法 | 请根据接口错误返回信息调整参数 |
| 200 | 2119002 | 系统繁忙，请稍候再试 | 重试 |
| 200 | 2119003 | 请求太过频繁，请稍后再试 | 重试 |
| 200 | 2119005 | 应用未获商家授权 | 联系合作商家在商家后台发起授权，并在服务商后台同意授权 |
| 200 | 2119010 | 接口已下线 | 接口已下线 |
| 200 | 2190002 | access_token无效 | 调用接口重新生成access_token |
| 200 | 2190004 | 应用未获得该能力, 请去https://open.douyin.com/申请 | 应用申请接口权限 |
| 200 | 2190008 | access_token过期,请刷新或重新授权 | 规范token刷新机制，检查是否有测试环境在同步刷新token |
| 200 | 3000001 | 根据实际业务错误返 回 | 对照接口文档规范参数并重试 |
| 200 | 5000001 | 根据实际业务错误返回 | 联系抖音处理 |
| 200 | 300001 | 以实际错误信息为准 | |
| 200 | 3000003 | 超过最大可退金额 | 超过最大可退金额 |
