微信支付开发避坑

写在前面

虽然微信支付的文档被开发者骂了好几年,但遇到问题了还是得去细扣文档,微信官方文档总能把各种坑的答案深埋在文档不起眼的各处,也是费了功夫~~

关键参数汇总

对于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日即可恢复

### 微信小程序支付接口调用时遇到支付场景非法错误的解决方案 当在微信小程序中调用微信支付API时,如果收到“支付场景非法”的错误提示,通常是因为请求参数配置不当或不符合微信支付的要求。以下是详细的排查和解决方法: #### 参数验证 确保传递给`wx.requestPayment()`函数的所有必要参数都已正确设置并符合规定[^1]。 - **trade_type**: 此字段指定了交易类型,在小程序环境中应始终设为`JSAPI`。 - **package**: 这个字符串应该由服务器端生成,并且包含了预支付订单的信息。它应当遵循特定格式,例如`prepay_id=xxxxxx`的形式。 - **signType**: 默认情况下推荐使用`MD5`签名算法;也可以选择更安全的方式如`HMAC-SHA256`来增强安全性。 - **timeStamp**, `nonceStr`, 和 `paySign`: 客户端需要根据官方文档中的说明自行计算这些值以完成最终的安全校验过程。 #### 场景合法性检查 除了上述基本参数外,“支付场景非法”还可能源于某些特殊条件未满足。比如,对于某些类型的商户账户来说,可能存在额外限制,不允许其发起某些种类的商品销售活动。因此建议仔细阅读最新的[微信支付开发者指南](https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/pages/index.shtml)[^2],确认当前操作是否违反了任何政策条款。 #### 日志记录与调试工具利用 为了更好地定位问题所在,可以在开发阶段启用详细的日志输出功能,以便于追踪每一步骤的数据流动情况。此外,还可以借助微信提供的在线测试环境以及相关SDK内的诊断模式来进行深入分析。 ```javascript // JavaScript代码片段展示如何构建合法有效的支付请求对象 const paymentRequest = { "appId": appID, "timeStamp": timestamp.toString(), "nonceStr": nonceString, "package": packageValue, // 应该是从后台获取到的有效包名 "signType": signType.toUpperCase(), // MD5 或 HMACSHA256 "paySign": paySignature // 使用指定密钥按照一定规则算出来的签名串 }; try{ wx.requestPayment({ ...paymentRequest, success(res){ console.log('支付成功', res); }, fail(err){ console.error('支付失败:', err.errMsg); // 输出具体的错误信息帮助进一步调查原因 } }); }catch(e){ console.warn('发生异常:', e.message); } ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值