---
url: "https://pay.weixin.qq.com/doc/v3/partner/4012081991.md"
title: "配置APIv3密钥"
doc_id: 4012081991
---

>更新时间：2025.10.28

## 1、功能介绍

微信支付APIv3的下载平台证书接口以及处理回调通知中，为防止报文被他人其他人恶意篡改，服务器会对数据进行加密。商户收到报文后，要解密出明文，解密过程中用的key就是APIv3密钥。（注意：APIv3密钥属于敏感信息，请妥善保管不要泄露，如果怀疑信息泄露，请重设密钥。）

## 2、使用说明

1、APIv3密钥的设置与修改不影响APIv2密钥。

2、APIv3密钥与APIv2密钥是隔离的，设置该密钥时，不会导致APIv2密钥发生变化。

3、APIv3密钥主要用于平台证书解密、回调信息解密，具体使用方式可参见[证书和回调报文解密](https://pay.weixin.qq.com/doc/v3/merchant/4012071382.md)文档。

## 3、设置要求

1、请与贵司技术人员沟通设置的APIv3密钥（密钥为32个字符，支持数字和大小写字母组合）

2、确保技术人员保管APIv3密钥，防止泄露。

3、将技术人员设置为“[技术负责人账号](https://pay.weixin.qq.com/doc/v3/merchant/4015423618.md)”，同步接收相关的风险提醒。

## 4、设置APIv3密钥

超级管理员登录[微信商户平台](https://pay.weixin.qq.com/)，进入【账户中心 > 账户设置 \> API安全】目录，点击“设置APIv3密钥”。

|     |     |
| --- | --- |
| 步骤一：登录商户平台，进入【账户中心-API安全-解密回调-APIv3密钥】点击“设置” | 步骤二：确认弹出窗口的内容已和技术人员沟通好后点击“已沟通” |
| ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/94b9a50f8c125d69e611cc99d94fe05e.png) | ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/621d74d959de01159dc7116b66e7310e.png) |
| 步骤三：输入需要设置的APIv3密钥，点击“确定”<br>（注意：请牢记设置的密钥，设置成功后不支持查看，只支持重新设置；密钥为32个字符，支持数字和大小写字母组合） | 步骤四：安全验证，输入操作密码，短信验证码，点击“确定”即可设置成功 |
| ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/9aaacd056c937fbc33a3bac8ea9f5601.png) | ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/cb3dc8eabd796b09a02ac8bf8a2672e4.png) |
| 步骤五：点击“完成”，APIv3密钥设置成功，请联系贵司技术人员，使用新密钥 |  |
| ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/1f9f15150ca0e7962bce37e8b54ee6be.png) |  |

## 5、修改APIv3密钥

注意事项：

- 修改前请与贵司内部技术人员沟通是否明确需要修改，避免未沟通直接修改而影响业务使用；

- 修改密钥之前，建议暂停相关业务服务，例如发出系统维护公告；

- 技术人员，在所有相关服务中更换为新的APIv3密钥，并测试验证服务可用。


超级管理员登录【[微信支付商户平台](https://pay.weixin.qq.com/) ->  账户中心 ->  账户设置 ->  API安全 ->  APIv3密钥 -> 修改】

|     |     |
| --- | --- |
| 步骤一：登录商户平台，进入【账户中心-API安全-解密回调-APIv3密钥】点击“修改” | 步骤二：阅读弹框中事项，若已沟通点击“已沟通” |
| ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/169f0b421caaa2984b676a4b287348c9.png) | ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/f9d8009b277a48330640fd121db7906a.png) |
| 步骤三：输入需要设置的APIv3密钥，点击“确定”<br>（注意：请牢记设置的密钥，设置成功后不支持查看，只支持重新设置；密钥为32个字符，支持数字和大小写字母组合） | 步骤四：安全验证，按提示输入手机验证码，点击“确定”即可修改成功 |
| ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/9fee7928b91f66e7044682e221c22be9.png) | ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/a4279ac8f61655bb1ad647a243834db3.png) |
| 步骤五：点击“完成”，APIv3密钥修改成功，请联系贵司技术人员，使用修改后的新密钥 |  |
| ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/079b6505fff71de58af0d32d1a23f3bb.png) |  |