联合登录方式仅供公司内部 app 业务合作使用,需提前申请配置。

1. 业务侧提供 app 的客户端标识 ua 关键字

ua格式: ua 关键字正则表达式

ua示例:

// 腾讯新闻
const uaReg = /qqnews/i

// QQ浏览器
const uaReg = /\\bMQQBrowser\\/([\\d\\.]+)\\s(?!TBS\\/([\\d]+))(\\w+)/

特殊处理: 如果业务侧 ua 没有关键字信息, 可自定义业务关键字写入 cookie 字段 gy_login_ua,在进入腾讯公益页面之前注入到.qq.com域名下

// cookie示例
gy_login_ua: shareLoginTest // 测试业务

提供的 ua 关键字正则表达式需能唯一识别出当前客户端环境
需提前配置才会生效

2. 注入指定登录态 cookie 字段

注入方式: 在进入腾讯公益页面之前注入到.qq.com域名下

cookie 字段(微信账号):

字段 必填 说明
main_login 登录账号类型,微信填wx, QQ填qq
appid 业务侧的 appid
openid 登录账号的 openid
access_token 登录账号的的 access_token

cookie 字段(QQ 账号):

字段 必填 说明
main_login 登录账号类型,微信填wx, QQ填qq
open_appid 业务侧的 appid
open_openid 登录账号的 openid
open_access_token 登录账号的的 access_token

在进入腾讯公益页面之前注入到.qq.com域名下, 否则读不到登录态
用户在 app 端切换账号时,需清除相关 cookie 字段

3. 注意事项

  • 联合登录方式,需首先打通与腾讯公益的QQ/微信openid转换权限
  • 腾讯精品游戏, 微信帐号体系无法申请openid转换权限,QQ帐号体系不涉及,可根据业务场景再具体判断接入方式
  • 如需强制打通登录态,则需保证,在进入公益页面前,cookie中注入的登录态必须有效
  • 若接入腾讯公益捐赠页面:
    • 业务侧提前配置是否需要强制登录,如强制,则未携带登录态 cookie 字段进入页面后下单会失败。
    • 用户支付的订单会记录在当前传递登录态的账号里,如未传递登录态,则会记录在用户使用的微信支付所属的微信账号里。
© 1998 - 2022 Tencent Inc. all right reserved,powered by tencent.更新时间: 2025-03-06 17:00:45

results matching ""

    No results matching ""

    results matching ""

      No results matching ""