联合登录方式仅供公司内部 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 字段进入页面后下单会失败。
- 用户支付的订单会记录在当前传递登录态的账号里,如未传递登录态,则会记录在用户使用的微信支付所属的微信账号里。