wxPay用法的理解分享

uoaccw

本帖最后由 uoaccw 于 2024-1-31 17:10 编辑

wxPay 已有升级版本模块 wxPayPlus, 请使用升级版。

通过阅读模块文档及微信开放平台文档，及论坛相关帖子，总结了一些认识，分享一下。
https://developer.yonyou.com/docs/Client-API/Open-SDK/wxPayPlus
https://pay.weixin**.**/wiki/doc/api/app/app.php?chapter=9_1
https://pay.weixin**.**/wiki/d ... hapter=9_12&index=2
https://pay.weixin**.**/wiki/doc/api/app/app.php?chapter=4_3

实现微信支付只需要两步：
1. 统一下单接口
商户系统先调用该接口在微信支付服务后台生成预支付交易单，返回正确的预支付交易回话标识后再在APP里面调起支付。
接口链接

URL地址：https://api.mch.weixin**.**/pay/unifiedorder

2. 调起支付接口（wxPay模块的payOrder()）

APP端调起支付的参数列表
接口链接
无

我们先看第一个下单：

模块文档上说，为安全考虑，下单应放到服务端，而不是在APP内调用模块的getOrderId()。那么该如何做呢，其实就是服务端给微信的下单接口（https://api.mch.weixin**.**/pay/unifiedorder）发一个http请求，关键的是参数要按微信文档的要求拼写正确，格式就是xml字符串。必填参数10个，如下表。

<xml>
<appid>wx2421b1c4370ec43b</appid>
<body>支付测试</body>
<mch_id>10000100</mch_id>
<nonce_str>1add1a30ac87aa2db72f57a2375d8fec</nonce_str>
<notify_url>http://wxpay**.**/pub_v2/pay/notify.v2.php</notify_url>
<out_trade_no>1415659990</out_trade_no>
<spbill_create_ip>14.23.150.211</spbill_create_ip>
<total_fee>1</total_fee>
<trade_type>APP</trade_type>
<sign>0CB01533B8C1EF103065174F50BCA001</sign>
</xml>

复制代码

最后一个参数sign是按照微信的要求计算出来的：
第一步，设所有发送或者接收到的数据为集合M，将集合M内非空参数值的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串stringA。
特别注意以下重要规则：

◆ 参数名ASCII码从小到大排序（字典序）；
◆ 如果参数的值为空不参与签名；
◆ 参数名区分大小写；
◆ 验证调用返回或微信主动通知签名时，传送的sign参数不参与签名，将生成的签名与该sign值作校验。
◆ 微信接口可能增加字段，验证签名时必须支持增加的扩展字段

第二步，在stringA最后拼接上key得到stringSignTemp字符串，并对stringSignTemp进行MD5运算，再将得到的字符串所有字符转换为大写，得到sign值signValue。
◆ key设置路径：微信商户平台(pay.weixin**.**)-->账户设置-->API安全-->密钥设置
举例：

假设传送的参数如下：

      appid：             wxd930ea5d5a258f4f
mch_id：             10000100
device_info：       1000
body：             test
nonce_str：       ibuaiVcKdpRxkhJA

第一步：对参数按照key=value的格式，并按照参数名ASCII字典序排序如下：
      stringA="appid=wxd930ea5d5a258f4f&body=test&device_info=1000&mch_id=10000100&nonce_str=ibuaiVcKdpRxkhJA";

第二步：拼接API密钥：

stringSignTemp=stringA+"&key=192006250b4c09247ec02edce69f6a2d" //注：key为商户平台设置的密钥key
sign=MD5(stringSignTemp).toUpperCase()="9A0A8659F005D6984697E2CA0A9CF3B7" //注：MD5签名方式

按照要求计算出sign后，拼接出XML字符串，商户系统服务端发送http请求，如果参数无误，微信服务端就会返回一个xml字符串,格式如下，其中prepay_id（预支付交易会话标识）会在下一步用到：

<xml>
<return_code><![CDATA[SUCCESS]]></return_code>
<return_msg><![CDATA[OK]]></return_msg>
<appid><![CDATA[wx2421b1c4370ec43b]]></appid>
<mch_id><![CDATA[10000100]]></mch_id>
<nonce_str><![CDATA[IITRi8Iabbblz1Jc]]></nonce_str>
<openid><![CDATA[oUpF8uMuAJO_M2pxb1Q9zNjWeS6o]]></openid>
<sign><![CDATA[7921E432F65EB8ED0CE9755F0E86D72F]]></sign>
<result_code><![CDATA[SUCCESS]]></result_code>
<prepay_id><![CDATA[wx201411101639507cbf6ffd8b0779950874]]></prepay_id>
<trade_type><![CDATA[APP]]></trade_type>
</xml>

复制代码

既然获得了微信返回的prepay_id，下面就可以调起微信进行支付了。通过wxPay模块的payOrder(), 如下

var myDate = new Date();
var now = Date.parse(new Date()) / 1000;
var stringA = "appid=wx123456789&noncestr=abccba&package=Sign=WXPay&partnerid=123456789&prepayid=" + prepay_id+ "&timestamp=" + now;
var stringSignTemp = stringA + "&key=123456789abc123456789";
var sign = md5(stringSignTemp).toUpperCase(); // 为安全考虑，sign计算放到服务端，可以通过ajax传递给APP端
var wxPay = api.require('wxPay');
wxPay.payOrder({
apiKey: 'wx123456789',
orderId: prepay_id,
mchId: '123456789',
nonceStr: 'abccba',
timeStamp: now,
package: 'Sign=WXPay',
sign: sign
}, function(ret, err) {
if (ret.status) {
//支付成功
} else {
alert(err.code);
}
});

复制代码

这一步的sign 和下单接口的sign没有关系，不能用下单接口的sign。计算sign用微信文档上列出的参数名，不要用模块文档上的。如下图。
请求参数

字段名	变量名	类型	必填	示例值	描述
应用ID	appid	String(32)	是	wx8888888888888888	微信开放平台审核通过的应用APPID
商户号	partnerid	String(32)	是	1900000109	微信支付分配的商户号
预支付交易会话ID	prepayid	String(32)	是	WX1217752501201407033233368018	微信返回的支付交易会话ID
扩展字段	package	String(128)	是	Sign=WXPay	暂填写固定值Sign=WXPay
随机字符串	noncestr	String(32)	是	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	随机字符串，不长于32位。推荐随机数生成算法
时间戳	timestamp	String(10)	是	1412000000	时间戳，请见接口规则-参数规定
签名	sign	String(32)	是	C380BEC2BFD727A4B6845133519F3AD6	签名，详见签名生成算法注意：签名方式一定要与统一下单接口使用的一致

另一位开发者分享的带服务端代码的wxPay微信支付分享帖：

https://community.yonyou.com/thread-70594-1-1.html

足球大师

刚刚调通。几个坑，1.模块签名的几个字段只有如下几个。且必须是小写，刚开始没注意“appid”误写成“appId”, 调试了很长时间。
         wxPayData.SetValue("appid", appId);
         wxPayData.SetValue("partnerid", mchId);
         wxPayData.SetValue("prepayid", prepayId);
         wxPayData.SetValue("noncestr", noncestr);
         wxPayData.SetValue("package", "Sign=WXPay");
         wxPayData.SetValue("timestamp", tmStamp);
2，第二个坑，模块里传参数的apiKey其实是appid，刚开始以为是微信后台给APP颁发的apiKey，其实不是。就是appId。
3，第三个坑，就是发起调用的APP签名和包名必须和微醺开发平台里设置的APP签名和包名完全一致。，第一次调用失败，微信提示了一下包名不正确，后面就再也没任何提示了，全是-1.这挺了很长时间。
4，第二次签名和第一次签名方法要一样，我用的是默认MD5签名方法。
5，签名的字段里初了要求的6个外我没有添加任何其他的，行不行不知道

gigie

感谢分享。

ad666666

楼主，我跟你的方法一样，有个问题想问一下，如果代码正确，在手机端wifi调试的话能否正常调用支付

福大亨

分享是一种胸怀，谢谢！

福大亨

ad666666 发表于 2018-6-22 17:17
楼主，我跟你的方法一样，有个问题想问一下，如果代码正确，在手机端wifi调试的话能否正常调用支付 ...

这个没有问题的，我自己调试的时候就完成了支付。

爱玩的小孩

我用同样的代码，为什么老是弹-1 。

[2018-07-31 17:33:02] [WiFi log] nonceStr

C912A253D1E9BA40E2C597ED2376640 at pay.html : 83
[2018-07-31 17:33:02] [WiFi log] timeStamp:1533029583 at pay.html : 84
[2018-07-31 17:33:02] [WiFi log] prepay_id:wx311733037518753dae3aa2cd3592554082 at pay.html : 85
[2018-07-31 17:33:02] [WiFi log] sign:A16924714A1DFE2A0D761114D25A342B at pay.html : 86

沐琴

payOrder 无法拉起微信，没有任何提示，代码是这样的ret是ajax里问后端拿的数据，如下：
{"code":"0","data":{"nonce_str":"r8MFQGnsOBS72QlO","appid":"wx750ba6e15714f96c","sign":"F292D9884A59BBD8810FDDD41875B3B9","trade_type":"APP","mch_id":"1511889501","prepay_id":"wx231454233553456d06f7041e3828257729","timestamp":1535007261},"message":"success"}

sign已经是重新签名过的，用的是微信官方的java sdk：
这是统一下单
Map<String, String> $res = $wxpay.unifiedOrder($wechat);
这是签名
String $sign = WXPayUtil.generateSignature($signData, I.env("i.wx.key"));
$signData 是这几个参数，确定没有问题
$signData.put("appid", $res.get("appid"));
$signData.put("partnerid", $res.get("mch_id"));
$signData.put("prepayid", $res.get("prepay_id"));
$signData.put("noncestr", $res.get("nonce_str"));
$signData.put("package", "Sign=WXPay");
$signData.put("timestamp", Convert.toStr($time));
如图，在js那边调用payOrder 的时候，loader会退出并且重新进入，拉不起微信，payOrder的回调里有两个打印，一个err，一个ret，都不打印，也就是说，payOrder没有被执行
这是什么情况，按道理来说，就算我参数是乱填的，也能拉起微信，然后提示签名错误这样的提示吧

沐琴

沐琴发表于 2018-8-23 15:02
payOrder 无法拉起微信，没有任何提示，代码是这样的ret是ajax里问后端拿的数据，如下：
{"code":"0","data ...

xiaog

沐琴发表于 2018-8-23 15:05
var wxPay = api.require('wxPay');
console.log(JSON.stringify(wxPay));
wxPay.payOrder({

遇到同样的问题了，你解决了么？

张会雷

缺少的 $key 是自己在微信支付商户平台自己设置的32位key