退款结果同步外部商家
收藏接口说明
抖音侧完成退款后，通知第三方实际退款结果。
通知类型的接口 请勿返回业务类型的错误（譬如订单不存在）。
基本信息
Scope | | |||
权限要求 | | |||
回调场景 | | |||
请求头
- •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（用于业务幂等） | 1111 |
refund_amount | int | 是 | 退款金额 | |
refund_info_list | list | 是 | 退款详情 | |
- order_item_id | string | 是 | | |
- item_refund_amount | int | 是 | 退款金额 | |
notice_type | int | 是 | 通知类型，退款成功=0 | |
refund_reason | string | 是 | 退款原因：用户/客服/系统发起退款原因 | 3 |
handle_time | int | 是 | 处理时间戳 ms | |
desc | string | 否 | 备注 | |
after_sale_type | int | 否 | 售后类型 1 退货退款 3 仅退款 | 1 |
请求示例
{ "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, "certificates": { "certificate_id": "13221", "code": "sdabdkadkj" } }], "refund_reason": "1111", "handle_time": 1678859379000 }
响应参数
名称 | 类型 | 是否必填 | 描述 | 示例值 |
data | struct | 是 | | |
- error_code | int | 是 | 错误码，合法范围为 [0,999999] | 0 |
- description | string | 是 | 错误信息 | |
响应示例
{ "data": { "error_code": 0, "description": "", } }
错误码
error_code | description | 备注 |
0 | success | 成功 |
300 | ... | 抖音侧需要重试，其他错误码抖音不重试 |
400～499 | | 其他自定义错误 |
