tt.createInfoOrder

我的收藏

基础库 3.62.0.0 开始支持本组件。

提供留资场景预下单能力，开发者通过调用该方法生成订单，返回订单号和订单信息。并且可以通过该能力返回值结合留资线索组件使用。

使用限制：

最低支持版本上注明行业 SDK ，表示仅在行业 SDK 上才支持，需要在代码中配置行业 SDK 的权限：行业 SDK 的权限配置。当完成行业 SDK 的权限配置后，可通过 tt.canIUse('createInfoOrder') 判断该 API 是否可用。

语法：

tt.createInfoOrder(options)

参数说明：

options 为 object 类型，属性如下：

属性名	类型	默认值	必填	说明
data	string	无	是	由开发者服务端返回，生成方式见下文
byteAuthorization	string	无	是	参考交易系统
success	Function	无	否	接口调用成功的回调函数
fail	Function	无	否	接口调用失败的回调函数

data（数据和交易下单一致，去掉一些不需要的字段）：

属性名	类型	默认值	必填	说明
skuList	SkuList[]SkuList说明见下文	无	是	下单商品信息注意：目前只支持传入一项
outOrderNo	string	无	是	外部订单号 =》外部服务单号，小程序内唯一即可（也不能和交易系统外部单号冲突）

SkuList 结构对象：

属性名	类型	默认值	必填	说明
skuId	string	无	是	外部商品id，如：号卡商品id、会员充值套餐id、某类服务id、付费工具id等
quantity	number	无	是	数量0 < quantity <= 100
title	string	无	是	商品标题，长度 <= 256字节
imageList	string[]	无	是	商品图片链接，长度 <= 512 字节注意：目前只支持传入一项
type	number	无	是	商品类型，详见此处的商品类型枚举值示例：◦号卡商品：传101◦剧集：传404
tagGroupId	string	无	是	交易规则标签组点此查看对应商品类型的标签组ID注意：根据接入规范，选择适合的标签组ID传入，该标签组对应标签将会在用户收银台展示。
entrySchema	SchemaSchema说明见下文	无	否	商品详情页链接
skuAttr	string	无	否	商品信息：转换成json string号卡类商品必填：https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/server/payment/trade-system/general/order/request-order-data-sign

回调成功：

object 类型，属性如下：

属性名	类型	必填	说明
orderId	string	是	抖音开放平台内部的交易订单号，拉起收银台的参数，示例：moss123456789
itemOrderList	ItemOrderList[]	是	item单信息
logId	string	否	可供服务端排查问题

ItemOrderList 类型，属性如下：

属性名	类型	必填	说明
itemOrderId	string	是	交易系统商品单号，示例：moss874637654774
skuId	string	是	商品id，开发者下单时传入的商品id
itemOrderAmount	number	是	item单实付金额

错误码：

errNo	errMsg	说明
10000	createInfoOrder:fail 参数错误	参数错误
10000	createInfoOrder:fail 商品不符合行业要求	商品类型与小程序所属行业不符。请仔细阅读接入规范，查看所属行业可交易的商品类型后修正参数
10401	createInfoOrder:fail internal error	请求异常，可重试或升级APP
11004	createInfoOrder:fail 签名参数异常	请检查byteAuthorization，若不是'SHA256-RSA2048 '开头的格式，请使用下方示例代码生成。
11004	createInfoOrder:fail 签名校验异常	请参考加签问题FAQ进行自查
11001	createInfoOrder:fail 访问未授权	该JSAPI依赖用户登录，使用前请确保用户已经完成登录
12002	createInfoOrder:fail 账号行为异常	账号行为异常
13000	createInfoOrder:fail 系统错误	系统错误；可能情况较多，建议重试；若还重复报错，可以拉 Oncall 排查具体原因。
21016	createInfoOrder:fail 外部单号已存在	外部单号已存在
21046	createInfoOrder:fail 订单收款商户号不合法	订单收款商户号不合法
21550	createInfoOrder:fail not login	请用真机调试或者参考常见问题
26003	createInfoOrder:fail 相关接口已被封禁,具体原因可进入「控制台-小程序-健康-违规记录」进行查询	相关接口已被封禁,具体原因可进入「控制台-小程序-健康-违规记录」进行查询
26003	createInfoOrder:fail 无下单权限	当前场景无下单权限，具体可咨询对接运营

备注：整体接入可以参考，交易系统预下单：https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/api/industry/general_trade/create_order/request-order。

代码示例：

tt.createInfoOrder({
    data: 开发者服务端返回的data, // 请勿在前端对data做任何处理
    byteAuthorization: 开发者服务端返回的byteAuthorization, // 请勿在前端对byteAuthorization做任何处理
    success: (res) => {
      console.log('成功', res);
    },
    fail: (res) => {
      console.log(res)
    },
  });