开发
API
直播能力

接入流程

接入准备

申请开通支付能力

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

进件

开通条件

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

开通支付账号

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

资质填写

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

  1. 商户基本信息及证件图片
  • 商户类别:可选择 个人(持续从事电子商务经营活动满 6 个月且期间经营收入累计超过 20 万元。)/企业/个体工商户/小微
  • 商户名称:需与证件内容一致
  • 商户简称:用于支付时向买方展示
  • 商户证件类型及编号:营业执照(统一社会信用代码)即三证合一之后的
  • 商户证件是否为长期及有效期至
  • 协议确认账号
  1. 法人基本信息及证件图片
  • 法人姓名:需与身份证等证件内容展示一致
  • 证件类型及证件号
  • 商户证件是否为长期及有效期至
  1. 管理员信息
  • 管理员姓名
  • 管理员手机号码
  • 管理员身份证号
  • 管理员邮箱
  1. 结算信息
  • 结算卡属性:对公
  • 开户银行省份、城市等
  • 开户银行、开户支行
  • 结算卡卡名及卡号:仅支持储蓄卡,不支持信用卡
  • 银行预留手机号
  • 支付宝结算类型、支付宝结算账号

验证签约

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

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

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

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

支付设置

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

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

支付授权(服务商模式)

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

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

第三方进件(服务商模式)

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

支付能力接入

服务端接入

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

前端(小程序)接入

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

前端(小程序)接入

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

  1. 输入
属性类型必填说明
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
orderInfoobject调起小程序支付收银台订单信息
servicenumber固定值:5

orderInfo 属性如下:

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

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

  1. 输出

success 返回参数说明

属性类型说明
codenumber支付状态码: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
  },
});
点击纠错
评价此篇文档