tt.confirmFulfillment
收藏
我的收藏基础库 2.85.0.0 开始支持本方法
调用该 API 后,弹窗展示履约相关内容,用户点击后返回调用结果。
使用限制
- 1.当前仅支持泛知识接入交易规则场景调用。
- 2.最低支持版本上注明行业 SDK ,表示仅在行业 SDK 上才支持,需要在代码中配置行业 SDK 的权限:行业 SDK 的权限配置。当完成行业 SDK 的权限配置后,可通过 tt.canIUse('confirmFulfillment') 判断该 API 是否可用。
语法
tt.confirmFulfillment(options);
参数说明
object 类型,属性如下:
属性名 | 类型 | 默认值 | 必填 | 说明 |
serviceId | string | 无 | 是 | 履约弹窗模板,不同的serviceId会对应不同的弹窗文案 泛知识场景固定传入:201 |
orderId | string | 无 | 是 | 抖音平台交易单号 |
toStatus | string | 无 | 是 | 目标履约状态 |
itemOrderIdList | string[] | 无 | 是 | 抖音平台item单号 |
toStatus 信息
toStatus代表用户在弹窗中点击确认后,订单将流转到的履约状态。
toStatus | 含义 | 使用场景 |
fulfilling | 履约中 | 业务流程由“服务开始前”流转到“服务开始中“后,引导用户通过弹窗进行确认,从而将履约状态驱动到“履约中”。 |
fulfill_done | 履约完成 | 业务流程由“服务开始中”流转到“服务结束“后,引导用户通过弹窗进行确认,从而将履约状态驱动到“履约完成”。 |
回调成功
属性名 | 类型 | 说明 |
errMsg | string | "confirmFulfillment:ok" |
logId | string | 该数据可供服务端排查问题 |
回调失败
属性名 | 类型 | 说明 |
errNo | number | 错误码 |
errMsg | string | 调用结果 |
errLogId | string | 该数据可供服务端排查问题 |
错误码说明
errNo | errMsg | 说明 |
20000 | confirmFulfillment:fail params.serviceId should be string, but got undefined | serviceId 未传。其他字段校验错误也会有类似错误信息 |
12001 | confirmFulfillment:fail 操作过于频繁,请稍后再试 | 操作过于频繁,请稍后再试 |
10000 | confirmFulfillment:fail 参数错误 | 参数错误 |
10401 | confirmFulfillment:fail internal error | 请求异常,可重试或升级APP |
12001 | confirmFulfillment:fail 操作过于频繁,请稍后再试 | 操作过于频繁,请稍后再试 |
13000 | confirmFulfillment:fail 系统错误 ,请重试 | 系统错误,请重试 |
21550 | confirmFulfillment:fail not login | |
27017 | confirmFulfillment:fail 订单存在退款记录 | 订单存在退款记录 |
27018 | confirmFulfillment:fail 当前已在该指定状态,无需操作 | 当前已在该指定状态,无需操作 |
27019 | confirmFulfillment:fail 当前指定状态无效,请检查参数 | 当前指定状态无效,请检查参数 |
27020 | confirmFulfillment:fail 当前不允许流转到指定状态 | 当前不允许流转到指定状态 |
27021 | confirmFulfillment:fail 不允许使用该方式进行调用,请检查是否使用组件或openapi | 不允许使用该方式进行调用,请检查是否使用组件或openapi |
27022 | confirmFulfillment:fail 当前请求的订单状态不相同,请检查参数 | 当前请求的订单状态不相同,请检查参数 |
效果示例
根据serviceid对应的模板内容展示弹窗文案
Bug & Tip
无