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

属性名

类型

说明

最低支持版本

code

number

0：支付成功
1：支付超时
2：支付失败
3：支付关闭
4：支付取消
9：订单状态开发者自行获取

只要调起收银台成功，支付都会回调成功，开发者依据返回的 code 值，进行后续业务逻辑处理

1.19.4

回调失败

object 类型，属性如下：

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

属性名

类型

说明

最低支持版本

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 上使用支付功能

下一篇：小程序文档指引