什么是APIv3密钥?如何获取APIv3密钥

更新时间:2024.11.20

1、功能介绍

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

2、使用说明

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

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

3、设置要求

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

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

3、将技术人员设置为“安全联系人”,同步接收相关的风险提醒

(商户平台->账户中心->安全中心->安全联系人页面添加)

4、如何设置APIv3密钥

1、(需要商户号的超级管理员才能操作)操作路径:

登录【微信支付商户平台 ->  账户中心 ->  账户设置 ->  API安全】->  APIv3密钥 -> 设置

 

2、请注意阅读弹框中事项,若已沟通点击“已沟通”

 

3、设置APIv3密钥,输入需要设置的密钥,点击“确定”

(请事先将需要设置的密钥用文档记录;设置成功后不支持查看,仅支持修改重新设置)

 

4、安全验证,按提示输入操作密码+手机验证码,提交确认即可设置成功

 

5、APIv3密钥设置成功,请联系贵司技术人员,使用新密钥

5、如何更新APIv3密钥

5.1 更换的注意事项

1)商户超级管理员与所有相关服务的技术沟通,明确更换APIv3密钥的方案、时间点,建议选择没有或较少交易时间段,修改APIv3密钥,并在线上服务进行更换,在微信支付商户平台修改密钥后,则旧密钥会立即失效,若线上仍存在使用旧密钥的服务,会导致API调用失败。

2)修改密钥之前,建议暂停相关业务服务,例如发出系统维护公告;

3)按照本文操作完成更换,完成后恢复业务服务使用。

5.2 更换的操作说明

修改APIv3密钥<操作步骤示例图>