常见问题

1，package参数格式错误，正确的package参数格式应该prepay_id=xxx，例如package:"prepay_id=wx201222229874569b201de80e089456213"。

2，package参数为空，请按照文档要求上传正确的参数。

1/**
2 * 检测当前是否运行在微信内置浏览器中
3 */
4function detectWeChatBrowser() {
5  // 确保 navigator 对象存在（避免特殊运行环境报错）
6  if (typeof navigator === 'undefined') {
7    console.warn('当前环境无 navigator 对象，无法检测浏览器类型');
8    return;
9  }
10
11  // 使用 includes 替代 indexOf，语义更清晰（ES6 特性，现代浏览器均支持）
12  const isWeChat = navigator.userAgent.includes('MicroMessenger');
13  //若需支持 IE11 等不支持 includes的旧浏览器，可将 includes替换为 indexOf !== -1
14  //const isWeChat = navigator.userAgent.indexOf('MicroMessenger') !== -1;
15
16  // 三元表达式简化条件输出
17  console.log(isWeChat ? '微信内置浏览器' : '外部浏览器');
18}
19
20// 执行检测
21detectWeChatBrowser();

A：可以判断用户取消支付，无法判断密码输入错误，密码输入错误不是终态，用户还可以继续输入密码。

• 小程序支付：requestPayment:fail cancel（用户取消支付），参考小程序调起支付。

• App支付：errCode=-2（用户取消支付），参考APP调起支付。

• JSAPI支付：get_brand_wcpay_request:cancel（用户取消支付），参考JSAPI调起支付。

注意：前端回调并不保证它绝对可靠，不可只依赖前端回调判断订单支付状态，订单状态需以后端查询订单和支付成功回调通知为准。

Q：调起支付提示“交易失败，今日收款超出单日收款最大金额”

A：
小微商户日收款额度为1万-30万，以当日实际收款提示情况为准，信用卡日收款限额为1000元，月收款限额调整为10000元。
其他类型商户没有限额，可通过合作伙伴平台站内信或下方指引，查询是否有违约记录。

商户违约记录查询与申诉指引（移动端）：https://kf.qq.com/faq/240129aQZjiM240129QRBFRV.html
微信支付商户自查违约记录/申诉指引（电脑端）：https://kf.qq.com/faq/240129iuEZBJ240129meAR3u.html

A：微信小游戏不支持调用JSAPI支付，需要使用小游戏虚拟支付。

Q：JSAPI调起支付报错：system:access_denied

A：参考以下几点排查：

1、小程序不支持内嵌web-view发起JSAPI支付

2、调起支付的页面url过长会导致微信webview鉴权异常，需要商户精简下url长度。

Q：JSAPI调起支付报错：“调用支付JSAPI缺少参数: appld”

A：参考以下几点排查：
1、请检查调起支付的参数是否传入了appId；

2、如使用的是JS-SDK中的wx.chooseWXpay方法拉起支付，该方法调起支付时的appId依赖wx.config获取，请检查wx.config注入是否成功。

Q：下单接口返回”此商家的收款功能已被限制，暂无法支付。商家可登录微信商户平台/微信支付商家助手小程序/经营账户页面查看原因和解决方案“报错如何处理？

A：商户号超级管理员可通过“微信支付商家助手”公众号，点击“我的商家”；或小程序搜索“微信支付商家助手”关键字进入“微信支付商家助手”小程序，进行解脱。
具体步骤请参考：
  商户违约记录查询与申诉指引（移动端）：https://kf.qq.com/faq/240129aQZjiM240129QRBFRV.html
  微信支付商户自查违约记录/申诉指引（电脑端）：https://kf.qq.com/faq/240129iuEZBJ240129meAR3u.html

Q：下单报错："受理关系不存在"。

A：子商户号与服务商商户号没有受理关系，即子商户号不是这个服务商下的进件的。

Q：调用接口报错：“商户未申请过证书。请到商户平台上申请证书授权机构颁发的证书。详情可参考:http://kf.qq.com/faq/180824JvUZ3i180824YvMNJj.html。”

A：请核实请求头传入的mchid商户号有没有申请商户API证书，如未申请，请参考商户API证书申请指引。

Q：在微信支付中，transaction_id与prepay_id这两个字段有什么区别？

A：
1、 prepay_id ：商户调用微信支付下单接口成功后返回的预支付交易会话标识，用于拉起支付（如JSAPI、APP支付等），有效期为2小时
2、transaction_id ：支付成功后由微信支付系统生成的订单号，用于唯一标识一笔成功支付的交易，仅在支付成功回调或查单接口中返回。

Q：调用接口报错：“平台私钥解密失败”

A：平台私钥解密失败可能由以下原因导致：
1、加密敏感数据时使用的公钥信息不正确，需确认是否使用的是微信支付平台证书中的公钥或微信支付公钥。
2、请求接口上送的请求头 Wechatpay-Serial 证书序列号和加密使用的平台证书公钥或微信支付公钥不匹配；
3、加密方式不符合规范，需确保使用RSAES-OAEP算法（推荐使用SHA-256作为哈希算法）。

建议检查证书配置和加密逻辑，并参考微信支付公钥加密敏感信息指引或平台证书加密敏感信息指引文档排查。

Q：v3支付回调通知解密报错：“init client setting err:decrypt downloaded certificate failed: cipher: message authentication failed”。

A：请参考以下几点排查：
1、解密使用的APIv3密钥错误。
2、检查密文是否被截断或篡改（需完整传递ciphertext、associated_data、nonce）。

Q：支付回调怎么测试？

A：微信支付未提供线上测试回调接口。如需测试支付回调功能，建议通过生产环境验证，在真实支付场景中测试回调地址是否能正常接收通知。

注意：回调地址需确保公网可访问的，详细参考回调通知注意事项。

Q：下单报错：{"code":"SIGN_ERROR","message":"商户证书序列号有误。请使用签名私钥匹配的证书序列号"}，什么原因？

A：请求的Authorization头中的商户API证书序列号serial_no，与用于计算签名的商户API证书私钥不匹配。可参考如何计算签名指引排查。

Q：下单报错：{ "code": "PARAM_ERROR","message": "http header中的mchid与post payload中的mchid不匹配"}，是什么原因？

A：请求头中的mchid与请求体中的mchid不一致，请检查参数传递是否正确。

Q：第一次下单未支付，第二次用同一个out_trade_no再次调用可以吗？

A：可以。需保证所有参数与首次下单一致（如 appid、mchid、金额、商品描述等），否则会报“201 商户订单号重复”错误。

Q：下单返回商户订单号重复是什么原因？

A：同一个商户订单号(out_trade_no)，不允许更换参数或更换其他下单接口重复下单。

Q：回调验签报错：“Last unit does not have enough valid bits”，是什么原因，如何处理？

A：

• 原因：这是签名探测流量导致的报错。探测流量的签名值不是合法的Base64，会触发“Last unit does not have enough valid bits”这类Base64解码错误。

• 快速判断：查看回调头 Wechatpay-Signature 的值，若以“WECHATPAY/SIGNTEST/”为前缀，即可确认是探测流量签名。

• 处理建议：对探测流量回调，正常返回失败（非2xx），不要按业务成功处理，等待后续微信返回带有正确签名的正式回调。