写在前面
虽然微信支付的文档被开发者骂了好几年,但遇到问题了还是得去细扣文档,微信官方文档总能把各种坑的答案深埋在文档不起眼的各处,也是费了功夫~~
关键参数汇总
对于JSAPI支付,二维码支付,小程序支付所需的几个关键参数:
wx.appId: xxxxxxx ##小程序或公众号appid
wx.mchId: xxxxxx ##支付商家的id
wx.key: xxxxx ##商家支付密钥( key设置路径:微信商户平台(pay.weixin.qq.com)-->账户设置-->API安全-->密钥设置)
wx.certPath: ##安全证书路径,也是在API安全中获取,下载下来是一个压缩包,里边有p12文件,退款等操作需要证书才可以
wx.notify_url: https://xxx ##支付回调接口,公网可访问
开发中的常见问题
支付签名验证失败
首先理解签名是什么,签名就是一个字符串经过加密算法得到的一个字符串,请求微信的支付接口时,需要根据签名进行安全认证,这个签名是由传入的参数得来的
最常见的一个错误,原因有很多,总结一下遇到的:
- 调用统一下单接口时,参与签名的参数为空字符串,报错支付签名验证失败。检查参数是否为空
- 调用统一下单接口成功,但是小程序调取微信支付:支付签名验证失败。对于这个问题,小程序端在调取微信支付的时候需要传递的参数如下:
这个错误就说明paySign有问题,建议后端在调用完统一下单接口获取到prepay_id之后不要直接返回给前端,而是后端进行参数的二次加密,帮忙处理之后生成paySign再返回给前端,前端可以直接拿参数去调用微信支付接口
//这里的signKey就是API安全设置的key
String prepay_id = result.get("prepay_id");
resultObj.put("appId",appId );
resultObj.put("timeStamp", String.valueOf(System.currentTimeMillis()).substring(0, 10) );
resultObj.put("nonceStr", WXPayUtil.generateNonceStr());
resultObj.put("package", "prepay_id=" + prepay_id);
resultObj.put("signType", "MD5");
String paySign = WXPayUtil.generateSignature(resultObj, signKey, MD5);
resultObj.put("paySign", paySign);
这里还有一个坑
我在后台处理完二次加密之后,小程序调支付接口还是会出现支付签名验证失败的问题,再次对比参数拼接之后的字符串,发现我把参数名转为小写了,而文档是区分大小写的。
签名算法
所以还是要好好看文档啊~~
支付场景非法
这是由于调用统一下单接口时trade_type字段传的值不对
我是小程序支付,应该是JSAPI,结果我传了一个NATIVE二维码支付
还要注意openid以及product_id是否需要传递
调用JSAPI支付缺少参数: total_fee
这个问题一般是在调起微信支付时参数传递有误
特别注意package字段的形式,需要带上“prepay_id=”
商家支付权限冻结
如果12个月以上没有进行过微信支付交易,会被冻结
如果商家资料齐全合法,在商家平台-》消息中心 会有被冻结的消息,有一个恢复权限的按钮,点击申请1-3日即可恢复