常见问题
更新时间：2025.09.26Q：发起商家转账报错：{"code":"NO_AUTH","message":"当前商户号接入升级版本功能，暂不支持使用升级前功能，请在产品中心-商家转账-前往功能查看接口文档"}
A：商户已开通商家转账新模式，不能再使用商家转账到零钱接口，可查阅新模式接口文档：新模式接口文档
Q：发起转账报错：单号已存在但信息不一致，请查单后比较确认
A：重复使用商户转账单号进行转账，且本次转账与上次转账的参数存在差异。
Q：新商家转账用户收款时效性是多久？即发起支付后，用户一直未确认收款，转账单多久会失效？
A：用户收款的时效是24小时，如用户不确认将在24小时后关闭单据，资金退回至商户的出资账户。
在用户未确认前，商户可以根据自己的业务需求，撤销转账。
如用户未确认收款，请勿在撤销或者等待单据关闭前，又发起一笔新的转账，避免重复出资带来资损。
Q：发起转账报错：{"code":"PARAM_ERROR","message":"需传入转账场景报备信息，请检查"}
A：传入的报备信息不符合规范，请参考转账场景报备信息字段传参说明
Q：单笔转账最低额度是多少？
A：单笔转账额度最低为0.1元
Q：撤销转账接口是否支持不传body？
A：支持，同时也可支持传入空的json串
Q：发起转账报错：{"code":"INVALID_REQUEST";"message":"暂不支持展示当前传入的用户收款感知"}
A：发起转账时接口主动传入的“user_recv_perception（用户收款感知）”暂不支持，各场景展示的默认内容和支持传入的内容详见按转账场景发起转账的相关说明
Q：发起转账报错：{code: "INVALID_REQUEST"; message: "超过单笔转账上下限，核实产品设置是否准确"}
A：发起转账时接口传入的“transfer_amount（转账金额）”超过单笔转账额度，可前往商户平台 > 产品中心 > 运营工具 > 商家转账 > 前往功能 > 转账额度，查看当前设置的单笔转账额度
Q：新的商户号可以接入老版本的商家转账到零钱吗？
A：新商户只能接入商家转账，不能接入商家转账到零钱
Q：如何开通商家转账到零钱功能？
A：商家转账到零钱功能已暂停接入，商户可接入新的商家转账功能，可查阅新模式接口文档：新模式接口文档
Q：多个商户使用同一个回调地址，收到回调的时候如何区分不同的商户以便用不同的APIv3密钥对回调通知内容进行解密？
A：提前将各商户的微信公钥ID或微信支付平台证书序列号与商户号进行一对一存储（如数据库或配置文件），在收到回调通知时，从HTTP请求头 Wechatpay-Serial 中获取对应的微信公钥ID或微信支付平台证书序列号。将提取的微信支付公钥ID或微信支付平台证书序列号与存储的对应关系比对，确定当前回调对应的商户号。根据匹配到的商户号，取出该商户在微信商户平台设置的APIv3密钥，用于后续的回调通知内容解密。
Q：发起商家转账后，商户平台能否手动操作撤销？
A：不能，只能通过调用撤销转账接口。
Q：发起商家转账报错：{"code":"USER_ERROR";"message":"当前商户存在异常，暂时无法进行转账。"}
A：可通过商户平台站内信或下方指引，查询是否有违约记录，如未查到请联系在线技术支持。
商户违约记录查询与申诉指引（移动端）：https://kf.qq.com/faq/240129aQZjiM240129QRBFRV.html |
Q：调用商家转账接口报错：“此IP地址不允许调用接口，请按开发指引设置”
A：调用商家转账接口需要配置IP白名单，请参考设置接口安全IP。
Q：商家转账的转账场景填错了，需要如何修改？
A：若商户号的转账场景填写错误，需要关闭后重新走申请流程。具体步骤为：
关闭操作：登录商户平台>产品中心>运营工具>商家转账-关闭权限；
开通操作：登录商户平台>产品中心>运营工具>商家转账>申请开通，按页面指引完成开通。
Q：商家转账提示“收款人姓名校验不通过，请核实信息”
A：user_name（收款用户姓名）必须与微信用户实名一致，注意此参数需要使用微信支付公钥加密（推荐），请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引；也可以使用微信支付平台证书公钥加密，参考获取平台证书序列号、平台证书加密敏感信息指引。
Q：商家转账接口报错：{"code":"INVALID_REQUEST","message'":"用户姓名与收款微信实名不一致"}
A：请核实传递的user_name（收款用户姓名）和openid对应微信的用户实名是否一致。
Q：调用商家转账接口报错：{"code":"PARAM_ERROR","message":"0.3元以下不允许输入姓名校验"}
A：金额小于0.3元的不支持传user_name（收款用户姓名）字段。
Q：申请电子回单后，一般多久能处理完（查询电子回单状态为FINISHED已完成）？
A：一般1个小时内可以到FINISHED已完成，建议商户在申请电子回单后每10分钟查询一次。
Q：调用接口报错：“平台私钥解密失败”
A：平台私钥解密失败可能由以下原因导致：
1、加密敏感数据时使用的公钥信息不正确，需确认是否使用的是微信支付平台证书中的公钥或微信支付公钥；
2、请求接口上送的请求头 Wechatpay-Serial 证书序列号和加密使用的平台证书公钥或微信支付公钥不匹配；
3、加密方式不符合规范，需确保使用RSAES-OAEP算法（推荐使用SHA-256作为哈希算法）；
建议检查证书配置和加密逻辑，并参考微信支付公钥加密敏感信息指引或平台证书加密敏感信息指引文档排查。
Q：申请电子回单后，一般多久能处理完（查询电子回单状态为FINISHED已完成）？
A：一般1个小时内可以到FINISHED已完成，建议商户在申请电子回单后每10分钟查询一次。
Q：发起商家转账返回报错{"code":"INVALID_REQUEST","message":"Openid格式错误或者不属于商家公众账号，请检查"}
A：发起转账传的openid不存在或者不是对应appid下获取的，需传入正确的openid，openid获取方式详见参数说明。
Q：调起用户确认收款提示"package_info信息有误，请返回联系商家处理"
A：请检查前端传入的package参数是否正确，需要和发起转账返回的package_info一致。
Q：用户确认收款提示"订单已超时，请返回商家重新发起收款"
A：发起转账后超过24h转账单会关单，请不要对已关闭的转账单拉起确认收款。
Q：商家转账调起用户确认收款接口提示：“转账单号错误”。
A：请检查调起用户确认收款接口传入的package参数是否正确，需要和发起转账接口返回的package_info一致。
注意：APP调起方式需要对参数的值进行UrlEncode处理。
Q：商家转账的每个用户单日金额限制，是按照自然日计算，还是按照24小时制计算？
A：按照自然日计算，每日0点解除限制。
Q：调用发起转账接口报错：“未传入完整且对应的转账场景报备信息，请根据接口文档检查”。
A：传入的转账场景报备信息不符合规范，请参考转账场景报备信息字段传参说明
Q：商家转账”调起用户确认收款”时提示“商家APPID错误，请返回商家重新发起收款”。
A：调用requestMerchantTransfer接口所传递“appId”的参数值校验未通过，请参考以下几点排查：
检查大小写是否正确，发起转账接口appid的“i”是小写，而调起用户确认收款的appId的“I”是大写；
检查调用发起转账接口时所传appid参数值与调起用户确认接口requestMerchantTransfer所传appId参数值是否一致；
检查调用“requestMerchantTransfer”接口参数中参数“appId”参数值是否有传，是否有多出空格、appId是否为一个正确的appId，参数值类型是否为“string”。
Q：商家转账调起用户确认收款接口提示：“商户号错误，请返回商家重新发起收款”。
A：请检查调起用户确认收款接口传入的mchId参数是否正确，是否有传值，需要和发起转账接口传入的mchid是同一个。
Q：商家转账调起用户确认收款接口报错：“system:access_denied”
A：不支持小程序webview内嵌的h5页面调起用户确认收款接口，不支持电脑拉起，只能在小程序页面内或者微信客户端浏览器页面内拉起。
Q：发起转账成功后，使用同一商户单号(out_bill_no)其他参数有变化重复调用会报错吗？
A：如果其他参数一致，并在3天重入有效期内可以返回成功，其他参数有变化则会返回报错。
Q：资金流水上显示，商家转账资金锁定，是因为用户没有确认收款吗？
A：不是，当商户发起转账受理成功后，就会有商家转账资金锁定类型的出资记录。
