---
url: "https://pay.weixin.qq.com/doc/v2/merchant/4011935211.md"
title: "常见问题"
doc_id: 4011935211
---

>更新时间：2026.05.19

## 前端常见问题

### Q：JSAPI调起支付报错：此公众号并没有这些scope的权限，错误码：10005？

A：参考以下几点排查：

1、建议检查一下公众号的功能。比如是不是在订阅号/未认证的公众号里面尝试调用认证服务号的功能。

2、微信支付认证过期或者APPID填写错误。

3、请使用snsapi\_userinfo的授权登录方式即可解决

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/1c1389725586bfcac630cb82b3ab0460.png)

### Q：JSAPI调起支付报错：商家暂时没有此类交易权限，请联系商家客服？

A：参考以下几点排查：

1、请检查你的下单接口是否指定了支付用户的身份，需单独开通指定身份支付权限方可使用

2、请确认你使用的商户号是否有jsapi支付的权限，可登录商户平台-产品中心查看

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/1ac1547072c3d6237c3e59a36984f644.png)

### Q：JSAPI调起支付报错：当前页面的URL未注册：http://www.weixin.qq.com/pay.do？

A：请检查下单接口中使用的商户号是否在[商户平台](http://pay.weixin.qq.com)配置了对应的支付目录。

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/3cb513f49c2ad35f71897646fbfcb5c8.png)

### Q：JSAPI调起支付报错：redirect\_url域名与后台配置不一致，错误码：10003？

A：参考以下几点排查：

1、本错误是公众号获取openid接口报的错误，接口文档：[http://mp.weixin.qq.com/wiki?t=resource/res\_main&id=mp1421140842](https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421140842)

2、检查下单接口传的appid与获取openid接口的appid是否同一个（需一致）

3、检查appid对应的[公众号后台](http://mp.weixin.qq.com)，是否配置的授权域名和获取openid的域名一致。授权域名配置路径：公众平台--设置--公众号设置--功能设置--网页授权域名

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/7f0b5c4d94ab32f4cb2b8addb779fd69.png)

### Q：JSAPI调起支付报错：该商户暂不支持通过外部拉起微信完成支付？

A：Jsapi支付只能从微信浏览器内发起支付请求

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/d30c31091f6babc0722a88dc09edb796.png)

### Q：公众号支付报错：{errMsg: "chooseWXPay:fail, the permission value is offline verifying"}？

A：请按照以下几点检查：

1、请勿在模拟器中实行发起支付，请在真机发起；

2、微信公众号支付授权目录填写实际发起支付的url地址。

举例：

页面：http://www.newfms.com/order/pay/id-115

此处填：http://www.newfms.com/order/pay/

### Q：JSAPI调起支付报错"JSAPI缺少参数total\_fee"

A：请按照以下两点检查：

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

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

## 后端常见问题

### Q：用户调用统一下单接口之后取消支付，若想对该订单进行再次支付需要如何处理？

A：可以使用原单号原参数重入获取新的prepay\_id调起支付。

### Q：申请退款返回err\_code\_des"订单金额或退款金额与之前请求不一致，请核实后再试"，需要如何处理？

A：请确保订单金额（total\_fee）与下单金额一致，如果进行多次退款操作，请确认每次的out\_refund\_no（商户退款单号）参数都是唯一的，若重复请更换新的退款单号后再次尝试。

### Q：统一下单设置的订单失效时间(time\_expire)最晚可以多久？

A：最长时间为15天，超过会自动调整为15天。

### Q：在商户平台页面操作的退款，怎么同步到自己的系统内部呢？

A：商户平台操作退款，可以登录【商户平台-交易中心-退款管理-退款配置】设置回调通知地址，设置完成后即可接收[退款结果通知](https://pay.weixin.qq.com/doc/v2/merchant/4011935223.md)，返回的是v2接口xml格式。

### Q：调用 v2 接口报错 “400 The SSL certificate error”，原因是什么？

A：参考以下几点排查：

1、商户API证书与商户号不匹配，如误用了其他商户的证书。

2、商户API证书已过期，可以登录【商户平台 - 账户中心 - API安全 - 申请API证书】查看证书是否过期并[申请新API证书](https://kf.qq.com/faq/161222NneAJf161222U7fARv.html)。

3、未按要求[携带商户API证书](https://pay.weixin.qq.com/doc/v2/merchant/4011985891.md#4%E3%80%81API%E8%AF%81%E4%B9%A6)（部分v2接口需携带商户API证书，如退款）。

### Q：JSAPI下单返回报错"appid与openid不匹配"

A：下单传的openid不存在或者不是从对应appid下获取的，获取方式详见[参数说明](https://pay.weixin.qq.com/doc/v2/merchant/4011939975.md#14%E3%80%81Openid)。

### Q：JSAPI调起支付报错"调用支付JSAPI缺少参数:package"？

A：参考以下几点排查：

1、请检查调起支付的参数是否传入了package参数；

2、请检查package参数格式是否为prepay\_id=xxx，例如："package": "prepay\_id=wx201612032137789b201de80e0661234657"（需与统一下单接口返回的prepay\_id一致）。

### Q：调起支付报错“支付验证签名失败”原因是什么？

A：参考以下几点排查：

1、检查请求参数是否正确

- 下单的appid的参数为小写字母“i”，而调起支付的appId参数为大写字母“I”

- 检查所有参数是否与调起支付文档完全一致

- 请求数据的编码是否正确，微信支付接口编码要求统一为UTF-8

- 签名原串是否存在被URLencode编码的参数，微信支付的签名原串要求使用参数的原值进行签名

- 请求参数是否存在特殊字符，或者字段长度不符的情况


2、检查商户号APIv2密钥是否正确

- APIv2密钥设置路径：微信商户平台-->账户中心-->账户设置-->API安全-->设置API密钥

- 设置生效时间：一般为立刻生效，少数情况下会延迟几分钟，APIv2密钥没有修改次数限制，但有修改时间间隔限制

- APIv2密钥设置是影响此商户号下所有接口的，请谨慎设置。如怀疑APIv2密钥错误，又担心影响其他接口，可以尝试设置与原先设置的一样的APIv2密钥


### Q：统一下单接口报错：<err\_code\_des><!\[CDATA\[字段 detail 长度超限\]\]></err\_code\_des>，什么原因？

A：detail最长支持6144字节。

### Q：统一下单接口中的 detail字段，其数据类型是对象（Object）还是数组（Array）？​

A：​ detail字段的类型为JSON 格式的字符串。在该字符串的内部结构中，数据组织形式为对象（Object），而非数组。

### Q：v2场景里支持分期付吗

A：不支持，V2下单无法支持商户贴息，也就无法支持分付的分期还。

### Q：请求统一下单接口报错提示“商户涉嫌违规，已限制支付权限”，这是什么原因？​

A：​ 表示服务商账号已被微信支付侧处置（封禁或限制）。请登录商户平台查看具体违规原因及解封指引。