抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
发起退款成功之后,抖音平台会请求开发者服务,将退款成功的结果传递给开发者服务。
    •适用订单类型:
    ◦即时零售券单
请求参数
参数名称
参数类型
必须参数
备注
msg
string
必填
json字符串,具体结构参考下表
type
string
必填
/ext/waimai/order/notify_refund
version
string
必填
3.0
​
msg字符串具体结构
参数名称
参数类型
必须参数
备注
» order_id
string
必填
​
» order_out_id
string
选填
​
» after_sale_id
string
必填
抖音售后单id
» out_after_sale_id
string
选填
三方售后单id
» after_sale_type
string
选填
1 退货退款
3 仅退款
» apply_source
int
必填
enum ApplySourceEnum {
USER_BEFORE_FULFILMENT = 101, // 用户履约前退款
USER_AFTER_FULFILMEN = 304, // 用户履约后退款
}
» refund_amount
int
必填
总退款金额
» user_refund_amount
int
必填
给用户总退款金额(扣减了优惠)
» refund_info_list
list<trade/common/biz_common.RefundInfo>
必填
​
»» order_item_id
string
必填
跟创单的item单id一致
»» item_refund_amount
int
必填
退款金额
»» item_user_refund_amount
int
必填
给用户退款金额(扣减了优惠)
»» related_coupon_list
list<trade/common/biz_common.RelatedCouponInfo>
选填
关联的即时零售券信息
​
»»» related_order_id
string
选填
订单id
»»» related_item_id
string
选填
item单id
»» item_type
enum(trade/common/biz_common.RefundItemTypeEnum)
必填
1=商品
2=配送费
» notice_type
int
必填
​
0=退款完成
1=退款审核完成(客服退)
» refund_reason
string
选填
退款原因
» refund_reason_desc
string
否
退款原因备注信息,退款原因为其他的时候会返回
» handle_time
int
必填
时间戳,秒
json示例
{ "order_id": "68WUrJAC1o", "open_id": "3gYCCEIHx2", "account_id": "BGMwr51lce", "sku_list": [ { "sku_id": "81Uu5JmiqE", "product_id": "P91K7f1eUV", "sku_out_id": "nQcuiM7aHk", "product_out_id": "SR0bKJHdph", "count": 6409899986684011553, "unit_amount": 2305429172530799713, "pack_amount": 4231378010294814013, "item_orders": [ { "item_order_id": "KeljJ4hh7w", "item_relations": [ { "relate_to_level": 2, "relate_to_id": "WovWYIhYRV", "relate_id_type": 2, "relate_reason_type": 3 } ], "sku_specs": [ { "attr_key": "g0aJKAi8BW", "item_name": "CEJDXYvTRd", "item_key": "Sr4Q3j9fvZ" } ] } ], "sub_sku_list": [ {} ], "can_buy": true } ], "amount": { "origin_amount": 6131180308193081039, "discount_amount": 1119513333342233694, "pay_amount": 4411194640606517414 }, "discount_list": [ { "discount_type": 8738746954259523935, "discount_id": "UbHZp0LU7B", "discount_amount": 4484633306461596751 } ] }
返回参数
Body:
参数名称
参数类型
必须参数
备注
» error_code
int
选填
0=成功
50=其他异常
» description
string
选填
​
json示例
{ "order_id": "BZN2MTSIYG", "order_out_id": "l7Gzz3B3ms", "error_code": 1587989840, "description": "u4TDH6E7TE" }
​