plugin.applyRefundLife

我的收藏

使用限制

在使用生服插件中的组件和 API 前，需要对行业插件有一个基本了解，可以参考文档：行业插件介绍，然后按照以下步骤及顺序使用生服插件中的能力：

1.参考申请行业插件完成插件的申请，注意只有小程序拥有生服类目资质才可见申请入口；

2.参考使用行业插件进行能力的调用；

行业插件在抖音 App 版本 31.8.0 及以上，小程序基础库版本 3.4x.0.0 及以上时支持。

plugin.applyRefundLife(options)

名称	类型	是否必填	描述	示例值
orderId	string	是	抖音订单号
refundInfo	Object	是	退款信息
itemOrderList	ItemOrderList[]	否	退款 item 单信息不传默认所有购买的sku都退
needRefundDeliveryFee	boolean	否	是否需要退配送费不需要传，如果所有sku+打包费都退了，默认会连带退配送费
needRefundPackFee	boolean	推荐传	是否需要退打包费不传默认不退打包费
afterSaleType	int	是	退货退款(1)、仅退款(3) 核销前退款，只能发起退货退款
success	Function	否	接口调用成功的回调函数
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

refundInfo

属性名	类型	默认值	必填	说明
reasonCode	number[]		是	请参考下面表格目前仅支持传入一个编码
note	string		否（reasonCode = 999 ，即其他时，必填）	退款备注（退款备注字数不能超过200个）
applySource	enum		是	`enum ApplySourceEnum { USER_BEFORE_FULFILMENT = 101, // 用户履约前退款 USER_AFTER_FULFILMEN = 304, // 用户履约后退款 }`

reasonCode 枚举

ItemOrderList

字段名	类型	是否必传	描述
itemOrderId	string	是	退款的商品单号

object 类型

object 类型

属性名	类型	是否一定存在	说明
errNo	string	是	错误码，全部信息可查看 errNo 说明 •errNo 21550：未登录 •errNo 20000：未传入reasonCode •errNo 10401：系统错误，可联系平台同学排查 •errNo 21535：业务错误，可参考返回信息进行排查
errMsg	string	是	错误信息提示
errLogId	string	是	当申请退款接口失败时会提供该数据，可供服务端排查问题