.NET Core 微信公众号小程序6种获取UnionID方法,你知道哪几种?

守給你的承諾、 提交于 2020-04-25 02:17:26

前言

获取UnionID是开发微信公众号/小程序中很有必要的一个环节,特别是针对一个公司拥有多个公众号小程序而推出的机制,实现打通账户一体化,用UnionID来区分多平台的唯一性。

官方的解释:如果开发者拥有多个移动应用、网站应用、和公众帐号(包括小程序),可通过 UnionID 来区分用户的唯一性,因为只要是同一个微信开放平台帐号下的移动应用、网站应用和公众帐号(包括小程序),用户的 UnionID 是唯一的。换句话说,同一用户,对同一个微信开放平台下的不同应用,unionid是相同的。

 

相关开发文章:

.NET Core 小程序开发零基础系列(1)——开发者启用并牵手成功

.NET Core 小程序开发零基础系列(2)——小程序服务通知(模板消息)

.NET Core 微信小程序支付——(统一下单)

.NET Core 微信小程序退款——(统一退款)

 

目录

1、UnionID机制说明

2、UnionID获取的6种途径(代码实现)

3、总结

 

UnionID机制说明

如果开发者拥有多个移动应用、网站应用、和公众帐号(包括小程序),可通过 UnionID 来区分用户的唯一性,因为只要是同一个微信开放平台帐号下的移动应用、网站应用和公众帐号(包括小程序),用户的 UnionID 是唯一的。换句话说,同一用户,对同一个微信开放平台下的不同应用,unionid是相同的。

 

UnionID获取的6种途径(代码实现)

绑定了开发者帐号的小程序,可以通过以下途径获取 UnionID

UnionID获取的6种途径

  1. 调用接口 wx.getUserInfo,从解密数据中获取 UnionID。注意本接口需要用户授权,请开发者妥善处理用户拒绝授权后的情况。

  2. 如果开发者帐号下存在同主体的公众号,并且该用户已经关注了该公众号。开发者可以直接通过 wx.login + code2Session 获取到该用户 UnionID,无须用户再次授权。

  3. 如果开发者帐号下存在同主体的公众号或移动应用,并且该用户已经授权登录过该公众号或移动应用。开发者也可以直接通过 wx.login + code2Session 获取到该用户 UnionID ,无须用户再次授权。

  4. 用户在小程序(暂不支持小游戏)中支付完成后,开发者可以直接通过getPaidUnionId接口获取该用户的 UnionID,无需用户授权。注意:本接口仅在用户支付完成后的5分钟内有效,请开发者妥善处理。

  5. 小程序端调用云函数时,如果开发者帐号下存在同主体的公众号,并且该用户已经关注了该公众号,可在云函数中通过 cloud.getWXContext 获取 UnionID。

  6. 小程序端调用云函数时,如果开发者帐号下存在同主体的公众号或移动应用,并且该用户已经授权登录过该公众号或移动应用,也可在云函数中通过 cloud.getWXContext 获取 UnionID。

第一种UnionID获取

调用接口 wx.getUserInfo,从解密数据中获取 UnionID。注意本接口需要用户授权,请开发者妥善处理用户拒绝授权后的情况。

最常见的一种,很多同学应该用的这种。

流程:用户授权——获取密钥——后端解密——获取UnionID

开放平台绑定小程序如图:

前端授权获取密钥:

 

 

后端解密获取UnionID

varsettingItem = Senparc.Weixin.Config.SenparcWeixinSetting.Items[appID];
JsCode2JsonResult jsonResult = SnsApi.JsCode2Json(settingItem.WxOpenAppId, settingItem.WxOpenAppSecret, param.Code);
if (jsonResult.errcode != ReturnCode.请求成功)
{
    return (false, jsonResult.errmsg);
}

string unionID;
var encryptedData = Senparc.Weixin.WxOpen.Helpers.EncryptHelper.DecodeEncryptedData(jsonResult.session_key, param.EncryptedData, param.IV);
DecodedUserInfo decodedUserInfo = SerializerHelper.GetObject<DecodedUserInfo>(encryptedData);
unionID = decodedUserInfo.unionId;

 

第二种UnionID获取

如果开发者帐号下存在同主体的公众号,并且该用户已经关注了该公众号。开发者可以直接通过 wx.login + code2Session 获取到该用户 UnionID,无须用户再次授权。

流程:关注了公众号——获取UnionID

1、关注同一主体公众号就好了

2、获取UnionID,如下代码

varsettingItem = Senparc.Weixin.Config.SenparcWeixinSetting.Items[appID];
JsCode2JsonResult jsonResult = SnsApi.JsCode2Json(settingItem.WxOpenAppId, settingItem.WxOpenAppSecret, param.Code);
if (jsonResult.errcode != ReturnCode.请求成功)
{
    return (false, jsonResult.errmsg);
}

string unionID;
if (!jsonResult.unionid.IsNullOrEmpty())
{
    unionID = jsonResult.unionid;
    Console.WriteLine($"unionID获取(无需解密):参数EncryptedData={param.EncryptedData},IV={param.IV},unionID={unionID}");
}

 

第三种UnionID获取

如果开发者帐号下存在同主体的公众号或移动应用,并且该用户已经授权登录过该公众号或移动应用。开发者也可以直接通过 wx.login + code2Session 获取到该用户 UnionID ,无须用户再次授权。

流程:与第二步流程类似,可以参数

 

第四种UnionID获取

用户在小程序(暂不支持小游戏)中支付完成后,开发者可以直接通过getPaidUnionId接口获取该用户的 UnionID,无需用户授权。注意:本接口仅在用户支付完成后的5分钟内有效,请开发者妥善处理。

流程:订单支付成功得到相应信息——通过接口请求getPaidUnionId得到UnionID

1、支付流程请参考:.NET Core 微信小程序支付——(统一下单)

2、通过接口请求getPaidUnionId得到UnionID

    以下两种方式任选其一。

    a、微信支付订单号(transaction_id)

https://api.weixin.qq.com/wxa/getpaidunionid?access_token=ACCESS_TOKEN&openid=OPENID&transaction_id=TRANSACTION_ID

    b、微信支付商户订单号和微信支付商户号(out_trade_no 及 mch_id)

https://api.weixin.qq.com/wxa/getpaidunionid?access_token=ACCESS_TOKEN&openid=OPENID&mch_id=MCH_ID&out_trade_no=OUT_TRADE_NO

通过两个接口请求方式就可以得到UnionID

 

第五种UnionID获取

小程序端调用云函数时,如果开发者帐号下存在同主体的公众号,并且该用户已经关注了该公众号,可在云函数中通过 cloud.getWXContext 获取 UnionID。

流程:关注了公众号——通过云函数获取UnionID

官方函数说明:

 

代码示例:

const cloud = require('wx-server-sdk')
exports.main = async (event, context) => {
  const {
    OPENID,
    APPID,
    UNIONID,
    ENV,
  } = cloud.getWXContext()

  return {
    OPENID,
    APPID,
    UNIONID,
    ENV,
  }
}

 

第六种UnionID获取

小程序端调用云函数时,如果开发者帐号下存在同主体的公众号或移动应用,并且该用户已经授权登录过该公众号或移动应用,也可在云函数中通过 cloud.getWXContext 获取 UnionID。

流程:与第五种类似,可以参数。

 

总结

获取UnionID是开发微信众号/小程序很有必要的一个环节,主要为了打通微信多平台体系下的唯一性,6种方式中,其实最关键的一步是将当前开发的应用绑定在开放平台上,希望这篇文章让你对UnionID有些新的认识,也希望这篇实战文章能够真正的帮助到你。

原文出处:https://www.cnblogs.com/hailang8/p/11697311.html

易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!