常见问题
更新时间：2025.09.04Q：发起商家转账报错：{"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作为哈希算法）；
建议检查证书配置和加密逻辑，并参考微信支付公钥加密敏感信息指引或平台证书加密敏感信息指引文档排查。
