企业微信开发之向员工付款（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,"13212345678"); 
                    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",100);               //金额，单位为分
                    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, 0, 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

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

五、实现效果