企业微信开发之向员工付款（C#）

一、企业微信API

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

二、参数说明

1、向员工付款

请求方式：POST（HTTPS）
请求地址：https://api.mch.weixin.qq.com/mmpaymkttransfers/promotion/paywwsptrans2pocket
是否需要证书：请求需要双向证书。 详见证书使用
请求方式：POST
数据格式：xml

参数说明：

字段名	字段	必填	示例值	类型	说明
公众账号appid	appid	是	wx8888888888888888	String	微信分配的公众账号ID（企业号corpid即为此appid）
商户号	mch_id	是	1900000109	String(32)	微信支付分配的商户号
设备号	device_info	否	013467007045764	String(32)	微信支付分配的终端设备号
随机字符串	nonce_str	是	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	String(32)	随机字符串，不长于32位
微信支付签名	sign	是	C380BEC2BFD727A4B6845133519F3AD6	String(32)	参见“签名算法”
商户订单号	partner_trade_no	是	10000098201411111234567890	String	商户订单号，需保持唯一性(只能是字母或者数字，不能包含有符号)
用户openid	openid	是	oxTWIuGaIt6gTKsQRLau2M0yL16E	String	商户appid下，某用户的openid
校验用户姓名选项	check_name	是	FORCE_CHECK	String	NO_CHECK：不校验真实姓名 FORCE_CHECK：强校验真实姓名
收款用户姓名	re_user_name	否	马花花	String	收款用户真实姓名。 如果check_name设置为FORCE_CHECK，则必填用户真实姓名
金额	amount	是	10099	int	企业微信企业付款金额，单位为分
付款说明	desc	是	六月出差报销费用	String	向员工付款说明信息。必填
Ip地址	spbill_create_ip	是	192.168.0.1	String	调用接口的机器Ip地址
企业微信签名	workwx_sign	是	C380BEC2BFD727A4B6845133519F3AD6	String(128)	参见“签名算法”
付款消息类型	ww_msg_type	是	NORMAL_MSG	String	NORMAL_MSG：普通付款消息 APPROVAL _MSG：审批付款消息
审批单号	approval_number	否	201705160008	String	ww_msg_type为APPROVAL _MSG时，需要填写approval_number
审批类型	approval_type	否	1	int	ww_msg_type为APPROVAL _MSG时，需要填写1
项目名称	act_name	是	产品部门报销	String	项目名称

2、请求示例

 <xml>
     <appid>wxe062425f740c30d8</appid>
     <mch_id>1900000109</mch_id>
     <device_info>013467007045764</device_info>
     <nonce_str>3PG2J4ILTKCH16CQ2502SI8ZNMTM67VS</nonce_str>
     <sign>C97BDBACF37622775366F38B629F45E3</sign>
     <partner_trade_no>100000982017072019616</partner_trade_no>
     <openid>ohO4Gt7wVPxIT1A9GjFaMYMiZY1s</openid>
     <check_name>NO_CHECK</check_name>
     <re_user_name>张三</re_user_name>
     <amount>100</amount>
     <desc>六月出差报销费用</desc>
     <spbill_create_ip>10.2.3.10</spbill_create_ip>
     <workwx_sign>99BCDAFF065A4B95628E3DB468A874A8</workwx_sign>
     <ww_msg_type>NORMAL_MSG</ww_msg_type>
     <act_name>示例项目</act_name>
 </xml>

三、实现代码

                     WxPayData data = new WxPayData();
                     data.SetValue("appid", WxPayConfig.APPID);//公众账号ID
                     data.SetValue("mch_id", WxPayConfig.MCHID);//商户号
                     data.SetValue("nonce_str", WxPayApi.GenerateNonceStr());

                     data.SetValue("partner_trade_no",WxPayApi.GenerateOutTradeNo());
                     string openid = ConvertToOpenidByUserId(_accessToken,"");
                     var openInfo =  JsonConvert.DeserializeObject<U_OpenInfo>(openid);
                     data.SetValue("openid", openInfo.openid);    //商户appid下，某用户的openid
                     data.SetValue("check_name", "NO_CHECK");    //校验用户姓名选项(NO_CHECK：不校验真实姓名FORCE_CHECK：强校验真实姓名)
                     data.SetValue("amount",);               //金额，单位为分
                     data.SetValue("desc","六月份出差报销");//付款说明
                     data.SetValue("spbill_create_ip", "192.168.0.1");//Ip地址
                     data.SetValue("ww_msg_type", "NORMAL_MSG");    //付款消息类型
                     data.SetValue("act_name", "示例项目");   //项目名称
                     data.SetValue("workwx_sign", data.MakeWorkWxSign("payment"));  //企业微信签名
                     data.SetValue("sign", data.MakeSign());            //微信支付签名
                     string xml = data.ToXml();
                     string response = PostWebRequest(postUrl, xml, Encoding.UTF8, true);//调用HTTP通信接口提交数据到API
                     WxPayData result = new WxPayData();
                     result.FromXml(response);

        /// <summary>
         /// Post数据接口
         /// </summary>
         /// <param name="postUrl">接口地址</param>
         /// <param name="jsonData">提交json数据</param>
         /// <param name="dataEncode">编码方式</param>
         /// <param name="isUseCert">是否使用证书</param>
         /// <returns></returns>
         protected string PostWebRequest(string postUrl, string jsonData, Encoding dataEncode, bool isUseCert = false)
         {
             string ret = string.Empty;
             try
             {
                 byte[] byteArray = dataEncode.GetBytes(jsonData); //转化
                 HttpWebRequest webReq = (HttpWebRequest)WebRequest.Create(new Uri(postUrl));
                 webReq.Method = "POST";
                 webReq.ContentType = "application/x-www-form-urlencoded";

                 webReq.ContentLength = byteArray.Length;
                 if (isUseCert)
                 {
                     string path = AppDomain.CurrentDomain.BaseDirectory;
                     X509Certificate2 cert = new X509Certificate2(path + WxPayConfig.SSLCERT_PATH, WxPayConfig.SSLCERT_PASSWORD);
                     webReq.ClientCertificates.Add(cert);
                 }
                 Stream newStream = webReq.GetRequestStream();
                 newStream.Write(byteArray, , byteArray.Length);//写入参数
                 newStream.Close();
                 HttpWebResponse response = (HttpWebResponse)webReq.GetResponse();
                 StreamReader sr = new StreamReader(response.GetResponseStream(), Encoding.UTF8);
                 ret = sr.ReadToEnd();
                 sr.Close();
                 response.Close();
                 newStream.Close();
             }
             catch (Exception ex)
             {
                 return ex.Message;
             }
             return ret;
         }

四、注意事项

计算企业微信签名

付款ap有且仅有如下几个字段参与签名：
amount
appid
desc
mch_id
nonce_str
openid
partner_trade_no
ww_msg_type

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

五、实现效果