• JS API 列表
  • 基础
  • TTML
  • 网络
  • 媒体
  • 地图
  • 文件
  • 数据缓存
  • 地理位置
  • 设备
  • 画布
  • 界面
  • 页面导航
  • 开放接口
  • 登录
  • 用户信息
  • 广告
  • 支付
  • tt.pay
  • 分享
  • 小程序跳转
  • 抖音视频能力
  • 收货地址
  • 设置
  • 授权
  • 评价能力
  • 数据分析
  • 视频拍摄器
  • 引导关注
  • 订阅消息
  • 电商插件能力(即将废弃)
  • AI/AR能力
  • 转发和挂载
  • 直播能力
  • 流量来源识别
  • 侧边栏能力
  • 隐私信息授权
  • web化
  • 行业开放
  • 第三方平台
  • 其它
  • tt.pay

    收藏
    我的收藏
    从基础库 1.19.4 开始支持。
    调起字节小程序收银台进行支付。开发接入之前,请先完成商户入驻流程,详细文档见:小程序担保支付接入流程
    支持支付方式:
      微信支付
      支付宝
    支持 App 版本:
      今日头条(iOS & Android)7.7.4+ 版本
      抖音 (iOS & Android) 11.3.0+ 版本

    语法

    tt.pay(options);

    输入

    options 为 object 类型,属性如下:
    属性名
    类型
    默认值
    必填
    说明
    最低支持版本
    orderInfo
    object
    调起小程序支付收银台的订单信息。该对象的值由开发者服务端调用小程序服务端下单接口生成,详见预下单接口
    1.19.4
    service
    number
    固定值:5(拉起小程序收银台)
    1.19.4
    _debug
    number
    0
    仅限调试用,上线前去掉该参数。_debug=1 时,微信支付期间可以看到中间报错信息,方便调试
    1.19.4
    success
    function
    接口调用成功的回调函数
    1.19.4
    fail
    function
    接口调用失败的回调函数
    1.19.4

    orderInfo 说明:

    属性
    类型
    必填
    说明
    order_id
    string
    担保交易服务端订单号
    order_token
    string
    担保交易订单号 token

    回调成功

    object 类型,属性如下:
    属性名
    类型
    说明
    最低支持版本
    code
    number
      0:支付成功
      1:支付超时
      2:支付失败
      3:支付关闭
      4:支付取消
      9:订单状态开发者自行获取
    只要调起收银台成功,支付都会回调成功,开发者依据返回的 code 值,进行后续业务逻辑处理
    1.19.4

    回调失败

    object 类型,属性如下:
    属性名
    类型
    说明
    最低支持版本
    errMsg
    string
    API 支付错误码:
      10000- 支付失败
      10001- 调起微信失败
      10002- 微信未安装
    1.19.4

    扫码体验

    代码示例

    tt.pay({ orderInfo: { order_id: "6819903302604491021", order_token: "CgsIARCABRgBIAQoARJOCkx+WgXqCUIwTel2V3siEGZ0++poigIM+SMMxtMx798Vj0ZYzoTYBqeNslodUC9X5KAOHkR1YbSBz6I6pXATh5faIGy7R72A9vwm0OczGgA=", }, service: 5, success(res) { if (res.code == 0) { // 支付成功处理逻辑,只有res.code=0时,才表示支付成功 // 但是最终状态要以商户后端结果为准 } }, fail(res) { // 调起收银台失败处理逻辑 }, });

    Bug & Tip

    Tip:iOS 虚拟物品暂不支持使用支付功能。有虚拟物品支付的开发者,只能在 Android 上使用支付功能。