---
url: "https://pay.weixin.qq.com/doc/v3/partner/4012082628.md"
title: "获取国家商用密码证书和密钥"
doc_id: 4012082628
---

>更新时间：2024.07.25

## 1. 获取国密API证书和公私钥

### 1.1. 下载证书工具

1.1.1.登录微信支付[商户平台](https://pay.wechatpay.cn/index.php/core/cert/api_cert#/api-cert-manage) ，进入API证书管理页（需商户号超级管理员操作）：

页面路径：微信支付商户平台 \- 账户中心 \- API安全 - 申请API证书 - 管理证书 - 申请新证书

操作图示：

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/841068c25a781d76fddb53b6f83cbc19.png)

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/4a0a3aae97e26de8cf570192ce7939d3.png)

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/60c812418ee1aef9ab21611300f95e8d.png)

1.1.2.下载证书工具（根据电脑系统选择对应版本并安装）

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/869c8e388743252975aac9bd04b42eb1.png)

### 1.2. 生成公私钥文件

1.2.1.在商户平台的生成API证书页面，复制商户信息

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/76e4ab7e7ef5fe4d2a0332a569bd7615.png)![](/merchant-articles/development/media/gm-05.png)

1.2.2.打开证书工具 - 选择证书类型

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/7263bf9505ae22d35ba437acc06285a8.png)

1.2.3.粘贴商户信息 - 生成请求串

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/6bb472e8fe5cf66e6af56fa602e655be.png)

1.2.4.保存私钥文件到本地。保存时，不建议修改文件名称（默认为“序列号\_证书算法版本”），以免后续找不到私钥文件。

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/266e2277970ce065418383a659850cdb.png)

### 1.3. 上传CSR并生成API证书

1.3.1.在证书工具，复制请求串，并返回商户平台

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/d215e404e649eff31e4c9d628189a63c.png)

1.3.2.在商户平台的验证身份页，粘贴证书请求串并确认

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/492c5b0a1a52a0d4ef2a31c5db1576ca.png)

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/125022cb28aa8a2fc0b7501b1644ba76.png)

1.3.3.输入「 操作密码+短信验证 」即可生成API证书

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/9e782fce118565d2875eb107332ca074.png)

### 1.4. 下载API证书

返回商户平台，进入API证书管理页，下载API证书。保存时，不建议修改文件名称（默认为“序列号\_证书算法版本”），以免后续找不到API证书文件。

![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/74e848f9d86a67de9b6789d09e8b2750.png)

## 2. 获取国密平台证书

调用[获取平台证书接口](https://pay.weixin.qq.com/doc/v3/merchant/4012551764.md) 获取，该接口新增一个请求参数algorithm\_type：

SM2：获取国密算法的平台证书，请求URL示例：https://api.mch.weixin.qq.com/v3/certificates?algorithm\_type=SM2

RSA：获取RSA算法的平台证书

ALL：获取所有类型的平台证书

不填：默认获取RSA算法的平台证书

## 3. 获取APIv3密钥

APIv3密钥需登录商户平台设置，详情参考：[APIv3秘钥设置指引](https://kf.qq.com/faq/180830E36vyQ180830AZFZvu.html)

回调和证书解密使用的SM4密钥说明：把当前的APIv3密钥通过国密SM3 hash计算生成摘要（256bit），取摘要前面的128bit作为新的SM4密钥（[微信支付官方Java SDK](https://github.com/wechatpay-apiv3/wechatpay-java) 已处理该逻辑，使用SDK的商户只需配置APIv3密钥即可）