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

前言

获取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有些新的认识，也希望这篇实战文章能够真正的帮助到你。