配置APIv3密钥
更新时间：2025.10.281、功能介绍
微信支付APIv3的下载平台证书接口以及处理回调通知中，为防止报文被他人其他人恶意篡改，服务器会对数据进行加密。商户收到报文后，要解密出明文，解密过程中用的key就是APIv3密钥。（注意：APIv3密钥属于敏感信息，请妥善保管不要泄露，如果怀疑信息泄露，请重设密钥。）
2、使用说明
1、APIv3密钥的设置与修改不影响APIv2密钥。
2、APIv3密钥与APIv2密钥是隔离的，设置该密钥时，不会导致APIv2密钥发生变化。
3、APIv3密钥主要用于平台证书解密、回调信息解密，具体使用方式可参见证书和回调报文解密文档。
3、设置要求
1、请与贵司技术人员沟通设置的APIv3密钥（密钥为32个字符，支持数字和大小写字母组合）
2、确保技术人员保管APIv3密钥，防止泄露。
3、将技术人员设置为“技术负责人账号”，同步接收相关的风险提醒。
4、设置APIv3密钥
超级管理员登录微信商户平台，进入【账户中心 > 账户设置 > API安全】目录，点击“设置APIv3密钥”。
步骤一：登录商户平台，进入【账户中心-API安全-解密回调-APIv3密钥】点击“设置” | 步骤二：确认弹出窗口的内容已和技术人员沟通好后点击“已沟通” |
|
|
步骤三：输入需要设置的APIv3密钥，点击“确定” | 步骤四：安全验证，输入操作密码，短信验证码，点击“确定”即可设置成功 |
|
|
步骤五：点击“完成”，APIv3密钥设置成功，请联系贵司技术人员，使用新密钥 |
|
|
|
5、修改APIv3密钥
注意事项：
修改前请与贵司内部技术人员沟通是否明确需要修改，避免未沟通直接修改而影响业务使用；
修改密钥之前，建议暂停相关业务服务，例如发出系统维护公告；
技术人员，在所有相关服务中更换为新的APIv3密钥，并测试验证服务可用。
超级管理员登录【微信支付商户平台 -> 账户中心 -> 账户设置 -> API安全 -> APIv3密钥 -> 修改】
步骤一：登录商户平台，进入【账户中心-API安全-解密回调-APIv3密钥】点击“修改” | 步骤二：阅读弹框中事项，若已沟通点击“已沟通” |
|
|
步骤三：输入需要设置的APIv3密钥，点击“确定” （注意：请牢记设置的密钥，设置成功后不支持查看，只支持重新设置；密钥为32个字符，支持数字和大小写字母组合） | 步骤四：安全验证，按提示输入手机验证码，点击“确定”即可修改成功 |
|
|
步骤五：点击“完成”，APIv3密钥修改成功，请联系贵司技术人员，使用修改后的新密钥 |
|
|
|
