企业微信开发之发放企业红包（C#）

一、企业微信API

地址：http://work.weixin.qq.com/api/doc#11543

二、参数说明

1、发送企业红包

请求方式：POST（HTTPS）
请求地址：https://api.mch.weixin.qq.com/mmpaymkttransfers/sendworkwxredpack
是否需要证书：是
数据格式：xml

具体参数说明请参见API接口文档

2、具体实现代码

WxPayData data = new WxPayData();
data.SetValue("nonce_str", WxPayApi.GenerateNonceStr());                                //随机字符串
data.SetValue("mch_billno", WxPayApi.GenerateOutTradeNo());  　　　　　　　　　　　　　　　　//商户订单号
data.SetValue("mch_id", WxPayConfig.MCHID);　　　　　　　　　　　　　　　　　　　　　　　　　　　//商户号
data.SetValue("wxappid", WxPayConfig.APPID);　　　　　　　　　　　　　　　　　　　　　　　　　　//公众账号ID
data.SetValue("sender_name", "ly");      　　　　　　　　　　　　　　　　　　　　　　　　　　　　//发送者名称
data.SetValue("sender_header_media_id", "1G6nrLmr5EC3MMb_-zK1dDdzmd0p7cNliYu9V5w7o8K0"); //发送者头像，此id为微信默认的头像(如果想自定义头像，请参见第三部分)
string openid = ConvertToOpenidByUserId(_accessToken,"");
var openInfo =  JsonConvert.DeserializeObject<U_OpenInfo>(openid);
data.SetValue("re_openid", openInfo.openid);  　　　　　　　　　　　　　　　　　　　　　　　　　　//用户openid
data.SetValue("total_amount", );           　　　　　　　　　　　　　　　　　　　　　　　　　　//付款金额，单位分  最低一元钱
data.SetValue("wishing", "七夕情人节快乐！");   　　　　　　　　　　　　　　　　　　　　　　　　　　//红包祝福语
data.SetValue("act_name", "XX活动");          　　　　　　　　　　　　　　　　　　　　　　　　　　//活动名称
data.SetValue("remark", "快来抢");      　　　　　　　　　　　　　　　　　　　　　　　　　　　　　 //备注
data.SetValue("scene_id", "PRODUCT_4");      　　　　　　　　　　　　　　　　　　　　　　　　　　 //场景(金额大于200元时必填)
data.SetValue("workwx_sign", data.MakeWorkWxSign("redPacket"));  　　　　　　　　　　　　　　 //企业微信签名
data.SetValue("sign", data.MakeSign());                         　　　　　　　　　　　　　　  //微信支付签名
string xml = data.ToXml();
const string postUrl = "https://api.mch.weixin.qq.com/mmpaymkttransfers/sendworkwxredpack";  //发送企业红包接口地址
string response = PostWebRequest(postUrl, xml, Encoding.UTF8, true);                         //调用HTTP通信接口提交数据到API
WxPayData result = new WxPayData();
result.FromXml(response);

public class WxPayData
{
    //采用排序的Dictionary的好处是方便对数据包进行签名，不用再签名之前再做一次排序
    private SortedDictionary<string, object> m_values = new SortedDictionary<string, object>();

    /// <summary>
    /// 设置某个字段的值
    /// </summary>
    /// <param name="key">字段名</param>
    /// <param name="value">字段值</param>
    public void SetValue(string key, object value)
    {
        m_values[key] = value;
    }

    /// <summary>
    /// 根据字段名获取某个字段的值
    /// </summary>
    /// <param name="key">字段名</param>
    /// <returns>对应的字段值</returns>
    public object GetValue(string key)
    {
        object o = null;
        m_values.TryGetValue(key, out o);
        return o;
    }

    /// <summary>
    /// 判断某个字段是否已设置
    /// </summary>
    /// <param name="key">字段名</param>
    /// <returns>若字段key已被设置，则返回true，否则返回false</returns>
    public bool IsSet(string key)
    {
        object o = null;
        m_values.TryGetValue(key, out o);
        if (null != o)
            return true;
        else
            return false;
    }
    /// <summary>
    /// 将Dictionary转成xml
    /// </summary>
    /// <returns>经转换得到的xml串</returns>
    public string ToXml()
    {
        //数据为空时不能转化为xml格式
        if ( == m_values.Count)
        {
            LogHelper.LogHelper.WriteLog("WxPayData数据为空!");
            throw new WxPayException("WxPayData数据为空!");
        }

        string xml = "<xml>";
        foreach (KeyValuePair<string, object> pair in m_values)
        {
            //字段值不能为null，会影响后续流程
            if (pair.Value == null)
            {
                LogHelper.LogHelper.WriteLog("WxPayData内部含有值为null的字段!" + pair.Key + ":" + pair.Value);
                throw new WxPayException("WxPayData内部含有值为null的字段!");
            }

            if (pair.Value is int)
            {
                xml += "<" + pair.Key + ">" + pair.Value + "</" + pair.Key + ">";
            }
            else if (pair.Value is string)
            {
                xml += "<" + pair.Key + ">" + "<![CDATA[" + pair.Value + "]]></" + pair.Key + ">";
            }
            else//除了string和int类型不能含有其他数据类型
            {
                LogHelper.LogHelper.WriteLog("WxPayData字段数据类型错误!");
                throw new WxPayException("WxPayData字段数据类型错误!");
            }
        }
        xml += "</xml>";
        return xml;
    }

    /// <summary>
    /// 将xml转为WxPayData对象并返回对象内部的数据
    /// </summary>
    /// <param name="xml">待转换的xml串</param>
    /// <returns>经转换得到的Dictionary</returns>
    public SortedDictionary<string, object> FromXml(string xml)
    {
        if (string.IsNullOrEmpty(xml))
        {
            LogHelper.LogHelper.WriteLog("将空的xml串转换为WxPayData不合法!");
            throw new WxPayException("将空的xml串转换为WxPayData不合法!");
        }

        XmlDocument xmlDoc = new XmlDocument();
        xmlDoc.LoadXml(xml);
        XmlNode xmlNode = xmlDoc.FirstChild;//获取到根节点<xml>
        XmlNodeList nodes = xmlNode.ChildNodes;
        foreach (XmlNode xn in nodes)
        {
            XmlElement xe = (XmlElement)xn;
            m_values[xe.Name] = xe.InnerText;//获取xml的键值对到WxPayData内部的数据中
        }

        try
        {
            //2015-06-29 错误是没有签名
            if (m_values["return_code"].ToString() != "SUCCESS")
            {
                return m_values;
            }
            CheckSign();//验证签名,不通过会抛异常
        }
        catch (WxPayException ex)
        {
            throw new WxPayException(ex.Message);
        }

        return m_values;
    }

    /// <summary>
    /// 将xml转为WxPayData对象并返回对象内部的数据
    /// </summary>
    /// <param name="xml">待转换的xml串</param>
    /// <returns>经转换得到的Dictionary</returns>
    public SortedDictionary<string, object> XmlToEntity(string xml)
    {
        if (string.IsNullOrEmpty(xml))
        {
            LogHelper.LogHelper.WriteLog("将空的xml串转换为WxPayData不合法!");
            throw new WxPayException("将空的xml串转换为WxPayData不合法!");
        }

        XmlDocument xmlDoc = new XmlDocument();
        xmlDoc.LoadXml(xml);
        XmlNode xmlNode = xmlDoc.FirstChild;//获取到根节点<xml>
        XmlNodeList nodes = xmlNode.ChildNodes;
        foreach (XmlNode xn in nodes)
        {
            XmlElement xe = (XmlElement)xn;
            m_values[xe.Name] = xe.InnerText;//获取xml的键值对到WxPayData内部的数据中
        }

        try
        {
            //2015-06-29 错误是没有签名
            if (m_values["return_code"].ToString() != "SUCCESS")
            {
                return m_values;
            }
            // CheckSign();//验证签名,不通过会抛异常
        }
        catch (WxPayException ex)
        {
            throw new WxPayException(ex.Message);
        }

        return m_values;
    }

    /// <summary>
    /// Dictionary格式转化成url参数格式
    /// </summary>
    /// <returns>url格式串, 该串不包含sign字段值</returns>
    public string ToUrl()
    {
        string buff = "";
        foreach (KeyValuePair<string, object> pair in m_values)
        {
            if (pair.Value == null)
            {
                LogHelper.LogHelper.WriteLog("WxPayData内部含有值为null的字段!" + pair.Key + ":" + pair.Value);
                throw new WxPayException("WxPayData内部含有值为null的字段!");
            }

            if (pair.Key != "sign" && pair.Value.ToString() != "")
            {
                buff += pair.Key + "=" + pair.Value + "&";
            }
        }
        buff = buff.Trim('&');
        return buff;
    }

    /// <summary>
    /// 生成签名，详见签名生成算法
    /// </summary>
    /// <returns>签名, sign字段不参加签名</returns>
    public string MakeSign()
    {
        //转url格式
        string str = ToUrl();
        //在string后加入API KEY
        str += "&key=" + WxPayConfig.KEY;
        //MD5加密
        var md5 = MD5.Create();
        var bs = md5.ComputeHash(Encoding.UTF8.GetBytes(str));
        var sb = new StringBuilder();
        foreach (byte b in bs)
        {
            sb.Append(b.ToString("x2"));
        }
        //所有字符转为大写
        return sb.ToString().ToUpper();
    }

    /// <summary>
    /// 检测签名是否正确
    /// </summary>
    /// <returns>正确返回true，错误抛异常</returns>
    public bool CheckSign()
    {
        //如果没有设置签名，则跳过检测
        if (!IsSet("sign"))
        {
            LogHelper.LogHelper.WriteLog("WxPayData签名存在但不合法!");
            throw new WxPayException("WxPayData签名存在但不合法!");
        }
        //如果设置了签名但是签名为空，则抛异常
        else if (GetValue("sign") == null || GetValue("sign").ToString() == "")
        {
            LogHelper.LogHelper.WriteLog("WxPayData签名存在但不合法!");
            throw new WxPayException("WxPayData签名存在但不合法!");
        }

        //获取接收到的签名
        string return_sign = GetValue("sign").ToString();

        //在本地计算新的签名
        string cal_sign = MakeSign();

        if (cal_sign == return_sign)
        {
            return true;
        }

        LogHelper.LogHelper.WriteLog("WxPayData签名验证错误!");
        throw new WxPayException("WxPayData签名验证错误!");
    }

    /// <summary>
    /// 获取Dictionary
    /// </summary>
    /// <returns></returns>
    public SortedDictionary<string, object> GetValues()
    {
        return m_values;
    }
}

WxPayData类

public class WxPayException:Exception
{
    public WxPayException(string msg)
        : base(msg)
    {

    }
}

WxPayException类

　

public class WxPayApi
{
    protected Hashtable Parameters = new Hashtable();
    /// <summary>
    /// 根据当前系统时间加随机序列来生成订单号
    /// </summary>
    /// <returns>@return 订单号</returns>
    public static string GenerateOutTradeNo()
    {
        var ran = new Random();
        return string.Format("{0}{1:yyyyMMddHHmmss}{2}", WxPayConfig.MCHID, DateTime.Now, ran.Next());
    }

    /// <summary>
    /// 生成时间戳，标准北京时间，时区为东八区，自1970年1月1日 0点0分0秒以来的秒数
    /// </summary>
    /// <returns>@return 时间戳</returns>
    public static string GenerateTimeStamp()
    {
        TimeSpan ts = DateTime.UtcNow - new DateTime(, , , , , , );
        return Convert.ToInt64(ts.TotalSeconds).ToString();
    }

    /// <summary>
    /// 生成随机串，随机串包含字母或数字
    /// </summary>
    /// <returns> @return 随机串</returns>
    public static string GenerateNonceStr()
    {
        //Random random = new Random();
        //return GetMD5(random.Next(1000).ToString(), "GBK");
         return Guid.NewGuid().ToString().Replace("-", "");
    }
    /// <summary>
    /// 获取md5加密字符串
    /// </summary>
    /// <param name="encypStr"></param>
    /// <param name="charset"></param>
    /// <returns></returns>
    protected static string GetMD5(string encypStr, string charset)
    {
        byte[] bytes;
        //创建md5对象
        MD5CryptoServiceProvider provider = new MD5CryptoServiceProvider();
        //使用GB2312编码方式把字符串转化为字节数组．
        try
        {
            bytes = Encoding.GetEncoding(charset).GetBytes(encypStr);
        }
        catch (Exception)
        {
            bytes = Encoding.GetEncoding("GB2312").GetBytes(encypStr);
        }
        return BitConverter.ToString(provider.ComputeHash(bytes)).Replace("-", "").ToUpper();
    }

 protected void SetParameter(string parameter, string parameterValue)
        {
            if (!string.IsNullOrEmpty(parameter))
            {
                if (this.Parameters.Contains(parameter))
                {
                    this.Parameters.Remove(parameter);
                }
                this.Parameters.Add(parameter, parameterValue);
            }
        }

}

WxPayApi类

public class WxPayConfig
 {

        //=======【基本信息设置】=====================================
        /* 微信公众号信息配置
        * APPID：绑定支付的APPID（必须配置）
        * MCHID：商户号（必须配置）
        * KEY：商户支付密钥，参考开户邮件设置（必须配置）
        * APPSECRET：公众帐号secert（仅JSAPI支付的时候需要配置）
        */
        public static readonly string APPID = "";  //全部写你自己的

        public static readonly string APPSECRET = "";

        public static readonly string PAYMENTSECRET ="";

        public static readonly string MCHID = "";    //商户id号

        public static readonly string KEY = "";

        //=======【证书路径设置】=====================================
        /* 证书路径,注意应该填写绝对路径（仅退款、撤销订单时需要）
        */
        public static readonly string SSLCERT_PATH = "cert/apiclient_cert.p12";
        public static readonly string SSLCERT_PASSWORD =MCHID ;

}

WxPayConfig类

3、注意事项

(1)计算企业微信签名

字符串最后拼的secret是企业微信管理端支付应用页面的secret（见下图）

而不是企业微信的secret。（如下图）切记！！！

(2)还是计算企业微信签名

发红包ap有且仅有如下几个字段参与签名（这点代码里有体现）：
  act_name
  mch_billno
  mch_id
  nonce_str
  re_openid
  total_amount
  wxappid

不要将参数全部参与计算签名，否则会返回微信签名错误！

三、上传临时素材

1、在发红包的API接口中有一个参数为"sender_header_media_id"即发送者头像，可以通过企业微信开放上传素材接口获取

请求方式：POST（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE

使用http multipart/form-data上传文件， 文件标识名为”media”.
参数说明：

参数	必须	说明
access_token	是	调用接口凭证
type	是	媒体文件类型，分别有图片（image）、语音（voice）、视频（video），普通文件(file)
media	是	form-data中媒体文件标识，有filename、filelength、content-type等信息

权限说明：完全公开，media_id在同一企业内应用之间可以共享。

返回数据：

{
   "errcode": ,
   "errmsg": ""，
   "type": "image",
   "media_id": "1G6nrLmr5EC3MMb_-zK1dDdzmd0p7cNliYu9V5w7o8K0",
   "created_at": ""
}

2、具体实现

/// <summary>
/// 上传临时素材
/// </summary>
/// <param name="filePath"></param>
/// <returns></returns>
public string UploadTempResource(string filePath)
{
    const string url = "https://qyapi.weixin.qq.com/cgi-bin/media/upload?access_token={0}&type=image";
    var uploadUrl = string.Format(url, _accessToken);
    var mediaId = "1G6nrLmr5EC3MMb_-zK1dDdzmd0p7cNliYu9V5w7o8K0";
    using (var client = new WebClient())
    {
        var cm = CacheManager<string>.GetInstance();
        if (cm.Get("media_id") == null)
        {
            byte[] resource = client.UploadFile(new Uri(uploadUrl), filePath);
            string retdata = Encoding.UTF8.GetString(resource);
            var data = JsonConvert.DeserializeObject(retdata) as JObject;
            if (data != null)
            {
                mediaId = data["media_id"].ToString();
                cm.Add("media_id", mediaId,  *  * );
            }
        }
        return mediaId;
    }
}

四、实现效果

有需要的可以下载源码