plugin.lifeConfirmReceipt
确认收货JSAPI
提供开发者交易系统中确认收货的功能,开发者通过调用该方法后,订单会流转到履约完成状态。
使用限制
该JS API仅针对“包含高风险商品”的订单有效,如订单未“包含高风险商品”,则报错“当前订单不支持用户确认收货,将根据配送送达情况自动完成”;
行业插件在抖音 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被限定为用户点击后才生效,不允许绕开用户进行该操作
