tt.getOrderPayment

我的收藏

基础库 2.74.0.0 开始支持本方法

拉起用户支付收银台。

使用限制

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

语法

tt.getOrderPayment(options);

参数说明

options 为 object 类型，属性如下：

属性名	类型	默认值	必填	说明
orderId	string	无	是	抖音开放平台内部的交易订单号，len(orderId) <= 64byte，示例：motb37468756987
success	Function	无	否	接口调用成功的回调函数重要提示：success 回调仅代表 js_api 调用成功，不可用于判断用户实际支付成功，支付成功判断请开发者以服务端支付成功回调为准。
fail	Function	无	否	接口调用失败的回调函数
complete	Function	无	否	接口调用结束的回调函数（调用成功、失败都会执行）

回调成功

object 类型，属性如下：

属性名	类型	说明
orderId	string	抖音开放平台内部的交易订单号，len(orderId) <= 64byte，示例：motb37468756987
logId	string	可供服务端排查问题

回调失败

object 类型，属性如下：

属性名	类型	说明
errNo	string	错误码，对应信息可查看 errNo 说明
errMsg	string	错误信息提示
logId	string	当请求支付失败时会提供该数据，可供服务端排查问题

错误码说明

errNo	errMsg	说明
10000	getOrderPayment:fail 参数错误	参数错误
10401	getOrderPayment:fail internal error	请求异常，可重试或升级APP
11001	getOrderPayment:fail 访问未授权	访问未授权
12002	getOrderPayment:fail 账号行为异常	账号行为异常
13000	getOrderPayment:fail 系统错误	系统错误
20000	getOrderPayment:fail 订单不存在	订单不存在
21012	getOrderPayment:fail 创建订单失败，请稍后重试	创建订单失败，请稍后重试
21046	getOrderPayment:fail 订单收款商户号不合法	订单收款商户号不合法
21550	getOrderPayment:fail not login	请用真机调试或者参考常见问题
26001	getOrderPayment:fail 当前订单状态不可支付	当前订单状态不可支付
26003	getOrderPayment:fail 小程序违规，支付能力被封禁	小程序违规，支付能力被封禁
26005	getOrderPayment:fail 无可用支付方式	无可用支付方式
26006	getOrderPayment:fail 商户号与小程序的支付产品不一致	商户号与小程序的支付产品不一致
1	getOrderPayment:fail payment timeout	支付超时
2	getOrderPayment:fail payment fail	支付失败
3	getOrderPayment:fail payment closure	支付关闭
4	getOrderPayment:fail payment cancellation	支付取消
9	getOrderPayment:fail order status should be obtained by the developer	建议开发者自行通过服务端的订单查询接口获取订单状态

Bug & Tip

失败回调返回 errNo 为 9 ，一定要进行兜底处理。

在某些极端情况下，会导致 JSAPI 无法返回正确的支付结果，此时 JSAPI 会触发失败回调，并返回 errNo = 9，那么就需要开发者自行通过服务端的订单查询接口获取订单状态。

伪代码如下：

tt.getOrderPayment({
    // ...必要参数
    success() {
        // 成功处理函数
        // this.handlePaySuccess()
    },
    fail(err) {
        if (err.errNo === 9) {
            // 自行通过服务端接口查询订单支付状态
            // 若订单支付状态为成功，那么正常调用成功处理函数
            // this.handlePaySuccess()
        }
    }
})