「SPI」退款结果同步外部商家
收藏接口说明
抖音侧完成退款后，通知第三方实际退款结果。
通知类型的接口 请勿返回业务类型的错误（譬如订单不存在）
基本信息
Scope | life.trade.meal_retail_spi_refund_notify | |||
权限要求 | | |||
回调场景 | | |||
请求头
- •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 |
order_out_after_sale_id | string | 是 | 外部售后订单id | 1 |
after_sale_id | string | 是 | 抖音侧售后主单ID | 1111 |
refund_amount | int | 是 | 退款金额 | |
user_refund_amount | int | 是 | 退用户金额 | |
refund_info_list | list | 是 | 退款详情 | |
- order_item_id | string | 是 | | |
- related_coupons_info | | 否 | | |
-- related_order_id | string | 否 | 关联订单ID，仅当团购券抵扣部分协调退款时有值 | |
-- related_item_id | string | 否 | 关联订单ID，仅当团购券抵扣部分协调退款时有值 | |
-- related_certificate_id | string | 否 | 关联订单ID，仅当团购券抵扣部分协调退款时有值 | |
-- groupon_type | int | 否 | 团购类型：1 团购，2 次卡 | |
-- serial_num | int | 否 | 次卡序号 | |
-- code | string | 否 | 券码 | |
- item_refund_amount | int | 是 | 退款金额 | |
- item_user_refund_amount | int | 是 | 退用户金额 | |
notice_type | int | 是 | 通知类型，目前仅退款成功会通知 0 = 退款成功 | |
refund_reason | string | 是 | 退款原因：由用户、客服或系统发起 | 3 |
simple_after_sale_type | int | 是 | 退款类型：1、第一单撤销核销 2、第一单协同退 | 1 |
handle_time | int | 是 | 处理时间戳 | |
desc | string | 否 | 备注 | |
请求示例
响应参数
名称 | 类型 | 是否必填 | 描述 | 示例值 |
data | struct | 是 | | |
- error_code | int | 是 | 错误码，合法范围为 [0,999999] | 0 |
- description | string | 是 | 错误信息 【占位图】 | |
响应示例
{ "data": { "error_code": 0, "description": "", } }
错误码
error_code | description | 备注 |
0 | | 操作成功 成功 |
