第三方平台
第三方平台概述
创建第三方平台
常见问题排查指南

获取预授权码 pre_auth_code

v2 支持预设置分账比例(建议使用)

用于获取预授权码,预授权码用于小程序授权时的第三方平台方安全验证。 预授权码(pre_auth_code)是第三方平台方实现授权托管的必备信息,每个预授权码有效期为 10 分钟。

服务商开通支付服务权限后可以预设置分账比例,授权小程序同意授权后才真正生效。

请求地址(注意:请求方式、请求路径以及请求参数变化)

POST   https://open.microapp.bytedance.com/openapi/v2/auth/pre_auth_code

 

Query 参数

参数名参数类型是否必须备注
component_access_tokenstring第三方平台 access_token
component_appidstring第三方平台的 appid

Body 参数(json)

参数名参数类型是否必须备注
share_ratioint服务商的分账比例上限,设置范围:0-30 (%),闭区间
share_amountint服务商的分账金额上限,设置范围:0-50 (元/单),闭区间

如果服务商开通支付服务权限,按设定的分账比例、分账金额在授权跳转页做出展示,不传会按默认值 0 设置;

如果服务商没有开通支付服务权限,可以不传或者设为 0(在授权跳转页均不会展示),但是设置非零值会提示参数错误。

Body 参数示例

{
  "share_ratio": 10,
  "share_amount": 15
}

 

返回值

参数名参数类型备注
pre_auth_codestring预授权码
expires_inint预授权码有效期,单位:秒

返回值示例

{
  "pre_auth_code": "xxx",
  "expires_in": 600
}

 

v1 不支持预设置分账比例

用于获取预授权码,预授权码用于小程序授权时的第三方平台方安全验证。 预授权码(pre_auth_code)是第三方平台方实现授权托管的必备信息,每个预授权码有效期为 10 分钟。

请求地址

GET   https://open.microapp.bytedance.com/openapi/v1/create/tp/pre_auth_code

 

Query 参数

参数名参数类型是否必须备注
component_access_tokenstring第三方平台 access_token
component_appidstring第三方平台的 appid

 

返回值

参数名参数类型备注
pre_auth_codestring预授权码
expires_inint预授权码有效期,单位:秒

返回值示例

{
  "pre_auth_code": "xxx",
  "expires_in": 600
}
点击纠错
评价此篇文档