抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • JS API 列表
  • 基础
  • TTML
  • 网络
  • 媒体
  • 地图
  • 文件
  • 数据缓存
  • 地理位置
  • 设备
  • 画布
  • 界面
  • 页面导航
  • 开放接口
  • 行业开放
  • 第三方平台
  • 其它
  • 生活服务(即将废弃)
  • (即将废弃)地址组件
  • (即将废弃)继续支付
  • (即将废弃)用户申请退款
  • (即将废弃)用户申请退款

    收藏
    我的收藏
    注意
    本文档即将废弃,新文档请参见plugin.applyRefundLife
    语法
    tt.applyRefundLife(options)
    使用限制
    // 判断是否支持行applyRefundLife if (tt.canIUse("applyRefundLife")) { // do something }
    参数说明
    名称
    类型
    是否必填
    描述
    示例值
    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 枚举
    类型
    code
    退款原因描述
    发货前仅退款
    410
    我不想要了
    发货前仅退款
    402
    买错了/买多了/买少了
    发货前仅退款
    403
    地址/电话填写错误
    发货前仅退款
    409
    选错送达时间
    发货前仅退款
    406
    商家缺货
    发货前仅退款
    407
    商家联系我取消
    发货前仅退款
    505
    超出配送范围
    发货后 送达前退款
    410
    我不想要了
    发货后 送达前退款
    402
    买错了/买多了/买少了
    发货后 送达前退款
    403
    地址/电话填写错误
    发货后 送达前退款
    409
    选错送达时间
    发货后 送达前退款
    712
    骑手联系我取消
    送达后退款
    410
    七天无理由退款
    ItemOrderList
    字段名
    类型
    是否必传
    描述
    itemOrderId
    string
    是
    退款的商品单号
    回调成功
    object 类型
    属性名
    类型
    说明
    orderId
    string
    内部商户订单号
    refundId
    string
    内部退款单号
    回调失败
    object 类型
    属性名
    类型
    是否一定存在
    说明
    errNo
    string
    是
    错误码,全部信息可查看 errNo 说明
      •errNo 21550:未登录
      •errNo 20000:未传入reasonCode
      •errNo 10401:系统错误,可联系平台同学排查
      •errNo 21535:业务错误,可参考返回信息进行排查
    errMsg
    string
    是
    错误信息提示
    errLogId
    string
    是
    当申请退款接口失败时会提供该数据,可供服务端排查问题
    ​