• JS API 列表
  • 基础
  • TTML
  • 网络
  • 媒体
  • 地图
  • 文件
  • 数据缓存
  • 地理位置
  • 设备
  • 画布
  • 界面
  • 页面导航
  • 开放接口
  • 行业开放
  • 交易系统
  • 通用交易系统
  • 交易下单
  • tt.requestOrder
  • 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() } } })