C井微信公众号支付接口对接
cbao 2018-11-03
这次是第二次对接微信公众号的支付了，第一次代码写的很乱，没有找现成的SDK，感觉里面乱七八糟的东西太多不够清爽，而我仅仅是做一个小功能，对接又不复杂干脆自己做。
不想重复做轮子的朋友可以参考一下：Senparc C# SDK
这里我只说一下公众号内支付，APP以及其他的支付，等我以后用得到的时候再总结。
简单的说对接过程分为4步
1、拿到用户的openid
2、使用微信接口下单获取preorder_id
3、前端H5调用微信支付对话框
4、接收微信支付结果的通知
好了，现在开始具体过程介绍
0.公众号信息准备
1、公众号的appid，appsecret
登录微信公众平台，在开发一栏里找到基本配置
2、微信支付平台的商户id(mch_id), 支付key(这个是自己设置的)
1.获取用户openid
每个用户在公众号里都有一个唯一的openid，公众号可以通过openid获取用户的信息，当然获取用户信息是需要用户同意的。但是只获取openid不需要用户同意。
这里没提到的内容可以参考官方文档，：微信网页授权
要获取openid，首先要获取code，然后根据code获取openid。这个过程是为了要用户授权，也就是下面的绿色页面。
获取code跳转到这个链接：
https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect
参数
appid：是公众号的唯一标识
redirect_uri：是授权后重定向的回调链接地址，请使用urlEncode对链接进行处理
response_type：返回类型，请填写code
scope：是应用授权作用域，snsapi_base （不弹出授权页面，直接跳转，只能获取用户openid），snsapi_userinfo （弹出授权页面，可通过openid拿到昵称、性别、所在地。并且，即使在未关注的情况下，只要用户授权，也能获取其信息）
state：否 重定向后会带上state参数，开发者可以填写a-zA-Z0-9的参数值，最多128字节
#wechat_redirect 是 无论直接打开还是做页面302重定向时候，必须带此参数
在这里我们scope参数使用snsapi_base，使用snsapi_userinfo 会弹出绿色页面，但是结果是一样的。
如果没出错的话，页面会跳转到指定的redirect_uri页面，并附带上code和state参数。
获取code后，请求以下链接获取access_token：
https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code
参数
appid：公众号的唯一标识
secret：公众号的appsecret
code：填写第一步获取的code参数
grant_type：填写authorization_code
正确时返回的JSON数据包如下
{ "access_token":"ACCESS_TOKEN",
"expires_in":7200,
"refresh_token":"REFRESH_TOKEN",
"openid":"OPENID",
"scope":"SCOPE" }
1
2
3
4
5
看到这里面的openid这个参数没？这时就可以取用了，获取到的refresh_token可以保存起来，以后直接用refresh_token获取openid。
2.获取prepay_id
使用微信公众号支付必须在微信留个案底，需要把订单信息提交给微信，这时候就需要使用统一下单接口，官方文档
处于安全角度，使用这个接口需要对传输的信息加密，为了避免篡改，需要用到支付key，过程是这样的：
1、生成一个随机数：32位，可以创建一个Guid。
2、生成安全签名：把提交到微信的参数按照首字母字典排序(a-z)，编辑成key=value&key=value…的形式，然后末尾加上key，用md5加个密。
3、创建提交的xml
4、使用post提交到微信接口
· 把要传的参数使用字典排序(除了sign)：
SortedDictionary<String, String> param = new SortedDictionary<string, string>();
param.Add("appid", appid);
param.Add("attach", attach);
param.Add("body", body);
param.Add("mch_id", config.mchid);
param.Add("nonce_str", Guid.NewGuid().ToString().Replace("-", "").ToUpper());
param.Add("notify_url", notifyurl);
param.Add("openid", openid);
param.Add("out_trade_no", orderno);
param.Add("spbill_create_ip", System.Web.HttpContext.Current.Request.UserHostAddress);
param.Add("total_fee", ((Int32)(price * 100)).ToString());
param.Add("trade_type", "JSAPI");
1
2
3
4
5
6
7
8
9
10
11
12
· 参数生成字符串
private String GetUnEncyptKey(SortedDictionary<String, String> sort)
{
List<String> lstParam = new List<String>();
foreach (var item in sort)
{
lstParam.Add(String.Format("{0}={1}", item.Key, item.Value));
}
return String.Join("&", lstParam);
}
1
2
3
4
5
6
7
8
9
· MD5加密
/// <summary>
/// 签名字符串
/// </summary>
/// <param name="prestr">需要签名的字符串</param>
/// <param name="key">密钥</param>
/// <param name="_input_charset">编码格式</param>
/// <returns>签名结果</returns>
public static string Sign(string prestr, string key, string _input_charset)
{
StringBuilder sb = new StringBuilder(32);
prestr = prestr +"&key="+ key;
MD5 md5 = new MD5CryptoServiceProvider();
byte[] t = md5.ComputeHash(Encoding.GetEncoding(_input_charset).GetBytes(prestr));
for (int i = 0; i < t.Length; i++)
{
sb.Append(t[i].ToString("x").PadLeft(2, '0'));
}
return sb.ToString();
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
· 把刚才生成的sign加入到SortedDictionary中然后生成xml：
param.Add("sign", "签名值");
1
/// <summary>
/// 把提交的参数参数转换为xml
/// </summary>
/// <param name="requestInfo"></param>
/// <returns></returns>
public static String GetPostXML(SortedDictionary<String, String> requestInfo)
{
List<String> xml = new List<String>();
xml.Add("<xml>");
SortedDictionary<String, String> post_param = ExcludeEmpty(requestInfo);
foreach (var item in post_param)
{
if (item.Key == "detail")
{
xml.Add(String.Format("<{0}><![CDATA[{1}]]</{0}>", item.Key, item.Value));
}
else {
xml.Add(String.Format("<{0}>{1}</{0}>", item.Key, item.Value));
}
}
xml.Add("</xml>");
return String.Join("", xml);
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
(微信的detail 是使用CDATA防止xml转义的，其他参数不能采用)
好了，把XML使用POST提交到接口吧，地址是：https://api.mch.weixin.qq.com/pay/unifiedorder
返回结果也是xml的，可以返序列化。使用这段代码可以直接反序列化成实体类：
/// <summary>
/// 反序列化xml
/// </summary>
/// <param name="xml">XML字符串</param>
/// <returns></returns>
public static T Deserialize<T>(string xml)
{
try
{
String typename=typeof(T).Name;
xml = xml.Replace("<xml>", "<" + typename + ">").Replace("</xml>", "</" + typename + ">");
using (StringReader sr = new StringReader(xml))
{
XmlSerializer xmldes = new XmlSerializer(typeof(T));
return (T)xmldes.Deserialize(sr);
}
}
catch (Exception e)
{
return default(T);
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
好了，正常情况下就可以获取到prepay_id了。
3.前端H5调用微信支付对话框
请参考官方文档
对接过统一下单接口，这个过程就很简单了。按照这个文档做就好了。这里的随机字符串和签名都是重新生成的，生成方式和前面说的一样。
前端页面JS:
function onBridgeReady() {
WeixinJSBridge.invoke(
'getBrandWCPayRequest', {
"appId": "wx8888888888888888", //公众号名称，由商户传入
"timeStamp": "1414561699", //时间戳，自1970年以来的秒数
"nonceStr": "5K8264ILTKCH16CQ2502SI8ZNMTM67VS", //随机串
"package": "prepay_id=123456789",
"signType": "MD5", //微信签名方式：
"paySign": "C380BEC2BFD727A4B6845133519F3AD6" //微信签名
},
function (res) {
if (res.err_msg == "get_brand_wcpay_request:ok") {
//支付成功，后续自行处理
}
else
{
//支付取消，或者其他错误，自行处理
}
});
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
好了，到现在支付就完成了，下面还需要获取一下支付通知，最终确认一下支付状态。
4.接收支付通知
请自行阅读一下，官方文档：https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_7
简单说明一下文档中return_code 和result_code 分别表示通信结果和业务（支付）执行结果。收到参数后自己记录一下信息，尤其是支付单号transaction_id，然后再按照约定格式返回一个xml表示成功就可以了。
必须要注意的是，一定要对收到的参数进行签名，验证收到的消息来源是否来自微信，千万不可懒。因为加密所需的key只有你和微信知道，所以加密结果可能能对起来。如果key泄漏了会很危险，因为其他人可能会伪造一个结果，告诉你支付成功了。key可以在微信支付平台中修改。
最后
这次对接过程还比较顺利，没有遇到什么坑，记得第一次做微信接口的时候，不知道是文档我没理解，还是其他什么原因，用了很长事件。当然只按照上面说的是不行的，这里只是提供一个思路和几个辅助的代码段，还需要按照你自己的业务逻辑进行改造，至于其他接口大同小异，不在叙述了。
