发布：2019/5/11 16:28:18作者：管理员 来源：本站 浏览次数：1281
企业微信开发之向员工付款（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
不要将参数全部参与计算签名，否则会返回微信签名错误！
五、实现效果
