抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 行业插件介绍
  • 申请行业插件
  • 使用行业插件
  • 电商插件
  • 短剧插件
  • 生服插件
  • 预下单
  • 支付
  • 营销
  • 预约
  • plugin.booking
  • plugin.lifeConfirmReceipt
  • 逆向交易
  • 生服组件
  • plugin.lifeConfirmReceipt

    收藏
    我的收藏

    确认收货JSAPI

    提供开发者交易系统中确认收货的功能,开发者通过调用该方法后,订单会流转到履约完成状态。

    使用限制

    该JS API仅针对“包含高风险商品”的订单有效,如订单未“包含高风险商品”,则报错“当前订单不支持用户确认收货,将根据配送送达情况自动完成”;
    在使用生服插件中的组件和 API 前,需要对行业插件有一个基本了解,可以参考文档:行业插件介绍,然后按照以下步骤及顺序使用生服插件中的能力:
    1.参考 申请行业插件 完成插件的申请,注意只有小程序拥有生服类目资质才可见申请入口;
    2.参考 使用行业插件 进行能力的调用;
    行业插件在抖音 App 版本 31.8.0 及以上,小程序基础库版本 3.4x.0.0 及以上时支持。

    语法

    plugin.lifeConfirmReceipt(options)

    参数说明

    options 为 object 类型,属性如下:
    属性名
    类型
    默认值
    必填
    说明
    备注
    最低支持版本
    accountId
    string
    ​
    --
    是
    账户id
    ​
    零售随心团必传
    ​
    orderId
    string
    --
    是
    外卖单Id
    ​
    ​
    success
    Function
    ​
    否
    接口调用成功的回调函数
    ​
    ​
    fail
    Function
    ​
    否
    接口调用失败的回调函数
    ​
    ​
    complete
    ​
    Function
    ​
    否
    接口调用结束的回调函数(调用成功、失败都会执行)
    ​
    ​

    回调成功

    object类型
    属性名
    类型
    ​
    说明
    ​
    最低支持版本
    ​
    success
    boolean
    是否收货成功
    ​

    回调失败

    object类型
    属性名
    类型
    ​
    是否一定存在
    说明
    ​
    最低支持版本
    ​
    errCode
    string
    是
    错误码,对应信息可查看errCode说明
    ​
    errMsg
    string
    是
    错误信息提示
    ​
    errLogId
    string
    否
    当收货失败时会提供该数据,可供服务端排查问题
    ​

    使用示例

    const plugin = tt.requirePlugin('tta5a3d31e3aecfb9b11'); plugin.lifeConfirmReceipt({ accountId: "7220243801503762489", orderId: "1085371494409626539" })

    Tips

    FAQ

    lifeConfirmReceipt:fail appid不能为空

    需使用真机而不是IDE调试应用

    需用户点击确认收货

    该JS API被限定为用户点击后才生效,不允许绕开用户进行该操作
    ​