接入流程

接入准备

申请开通支付能力

小程序在申请开通支付能力前，应在小程序【开发者平台-功能管理-支付】界面阅读并同意《担保交易功能通知》，之后方可申请开通使用。

进件

开通条件

小程序需已通过主体认证，且完成基本信息配置。

开通支付账号

进入小程序开发者平台（microapp.bytedance.com）-功能管理-支付-担保交易开通。

资质填写

按提示填写商户、法人信息，管理员信息、结算信息，需由支付宝、微信审核需 2-3 个工作日。

商户基本信息及证件图片

商户类别：可选择个人（持续从事电子商务经营活动满 6 个月且期间经营收入累计超过 20 万元。）/企业/个体工商户/小微
商户名称：需与证件内容一致
商户简称：用于支付时向买方展示
商户证件类型及编号：营业执照（统一社会信用代码）即三证合一之后的
商户证件是否为长期及有效期至
协议确认账号

法人基本信息及证件图片

法人姓名：需与身份证等证件内容展示一致
证件类型及证件号
商户证件是否为长期及有效期至

管理员信息

管理员姓名
管理员手机号码
管理员身份证号
管理员邮箱

结算信息

结算卡属性：对公
开户银行省份、城市等
开户银行、开户支行
结算卡卡名及卡号：仅支持储蓄卡，不支持信用卡
银行预留手机号
支付宝结算类型、支付宝结算账号

验证签约

验证后即进入等待审核环节，审核时间预计 2-3 个工作日。

微信支付签约认证环节需使用管理员微信扫码进行确认。

完成后重新进入支付页面则如下显示：

微信和支付宝进件成功后，用户可以通过微信和支付宝在小程序内进行支付。

支付设置

支付设置中需对该小程序的 URL、Token、SALT 进行配置。

商户号：小程序平台自动分配
URL：服务端地址，必须以 https 开头，支持 443 端口
Token：小程序平台向开发者服务端发送请求时的密钥，必须为英文或数字，长度为 3-32 个字符
SALT：向小程序平台发送请求时的密钥

支付授权（服务商模式）

对于使用第三方平台模式开发小程序的用户。需要针对小程序担保支付，根据文档字节小程序第三方接入文档进行专门的支付行为授权，并且完成服务商的进件，才可以继续在第三方平台模式下接入担保支付能力。

为了便于服务商对进件与账户信息的管理。担保支付通过提供接口获取进件与账户页面 URL 方式完成进件。具体参考接口第三方进件部分。

第三方进件（服务商模式）

如果在业务场景中涉及小程序，服务商之外的第三方参与交易，则需要在完成服务商进件后，以服务商身份请求接口，参考第三方进件接口为第三方获取进件页面与账户页面 URL，完成进件。

支付能力接入

服务端接入

用户在商户侧通过接口完成商品的预下单
商户后端生成商品订单信息，并调用小程序平台后端预下单接口进行预下单
商户后端将预下单获取的 orderInfo 返回给商户前端

前端（小程序）接入

前端（小程序）调用 tt.pay 接口，调起小程序收银台，发起支付流程
前端（小程序）接收支付结果回调，进行后续业务处理

前端（小程序）接入

商户前端在接收到后端返回的 orderInfo 后就可以直接调用 tt.pay 拉起收银台了

输入

属性	类型	必填	说明
success	function	否	接口调用成功的回调函数
fail	function	否	接口调用失败的回调函数
orderInfo	object	是	调起小程序支付收银台订单信息
service	number	是	固定值：5

orderInfo 属性如下：

属性	类型	必填	说明
order_id	string	是	商户后端在字节跳动平台预下单获取的订单号
order_token	string	是	商户后端在字节跳动平台预下单获得的订单 Token

orderInfo 是相对于非担保交易收银台参数变化最大的部分；在新的担保交易模式下，商户服务端在小程序平台服务端下单（参考服务端接入），获得 orderInfo，并最终透传至 tt.pay，传输链路上的字段更少。

输出

success 返回参数说明

属性	类型	说明
code	number	支付状态码：0-支付成功，1-支付超时，2-支付失败，3-支付关闭，4-支付取消，9-订单状态开发者自行获取

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

代码示例;

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

点击纠错

评价此篇文档

接入流程
接入准备
申请开通支付能力