商家退款申请
收藏接口说明
抖音侧请求第三方申请退款，允许同步返回审核结果，务必保证幂等，即重复请求需要保证接口返回一致。
提货券订单允许部分退，refund_info_list字段中会拆分成申请退款的每一份item单的信息。
发码超时自动退的情况下，允许商家进行补码操作，提货券订单一单只需返回一个三方码。
基本信息
Scope | life.capacity.comprehensive_retail_refund_apply | |||
权限要求 | 提货券三方码交易 | |||
回调场景 | | |||
请求头
- •Content-Type：
application/json- •X-Bytedance-Logid: 请求 logid， 用于问题排查用
- •x-life-clientkey: 服务商应用的 client_key
- •X-life-sign: 请求签名，签名规则
请求参数
名称 | 类型 | 是否必填 | 描述 | 示例值 |
order_id | string | 是 | 抖音订单 ID | 100001 |
order_out_id | string | 是 | 外部订单 ID | 1 |
biz_uniq_key | string | 是 | 抖音售后单ID（用于业务幂等） | |
refund_amount | int | 是 | 退款金额 | |
refund_info_list | list<object> | 是 | 退款详情 | |
.order_item_id | string | 是 | item单id | |
.item_refund_amount | int | 是 | item单退款金额 | |
.certificate | object | 是 | 凭证信息 | |
..certificate_id | string | 是 | 一张券码的标识 | |
..code | string | 否 | 三方码（若发码失败为空） | |
refund_reason | string | 是 | 退款理由 | |
handle_time | int | 是 | 处理时间 ms | |
请求示例
{ "order_id":"111", "order_out_id": "1", "biz_uniq_key": "467812", "refund_amount":100, "refund_info_list":[{ "order_item_id": "13231", "item_refund_amount": 100, "certificate": { "certificate_id": "13221", "code": "sdabdkadkj" } }], "refund_reason": "1111", "handle_time": 1678859379000 }
响应参数
名称 | 类型 | 是否必填 | 描述 | 示例值 |
data | object | 是 | | |
.error_code | int | 是 | 错误码，合法范围为 [0,999999] | 0 |
.description | string | 是 | 错误信息 | |
.order_id | string | 是 | 抖音订单id | |
.order_out_id | string | 是 | 外部订单id | |
.biz_uniq_key | string | 是 | 业务唯一键 | |
.result | int | 是 | 退款审核结果：1:允许,2:拒绝,3:待回调 | |
.reason | string | 否 | 拒绝原因，若结果为拒绝时必填 | |
.codes | list<string> | 否 | 补码 | |
响应示例
{ "data": { "error_code": 0, "description": "success", "result": 1 } }
错误码
error_code | description | 备注 |
0 | success | 成功 |
300 | ... | 抖音侧需要重试，其他错误码抖 音不重试 |
400～499 | | 其他自定义错误 |
