---
url: "https://pay.weixin.qq.com/doc/v3/partner/4012081992.md"
title: "申请商户API证书"
doc_id: 4012081992
---

>更新时间：2025.10.28

## 功能介绍

商户API证书，是指由商户申请的，用来证实商户身份的证书。API证书由证书授权机构Certificate Authority（简称CA）颁发。证书中包含商户的商户号、公司名称、公钥等信息。请妥善保管API证书文件，防止泄露。

注意：

商户API证书的有效期为5年，自申请成功之日起计算。在有效期内无需定期更新，但需注意证书到期前需提前更换。

## 使用场景

APIv2 中，调用微信支付安全级别较高的接口（如：退款、企业红包、企业付款）

APIv3 中，调用微信支付所有接口的签名都需要用到商户API证书。

商户API证书具体使用说明可参见[开发必要参数说明](https://pay.weixin.qq.com/doc/v3/merchant/4013070756.md)。

## 申请商户API证书

商户号超级管理员登录[商户平台（直连模式）](https://pay.weixin.qq.com/)/[合作伙伴平台（服务商模式）](https://pay.weixin.qq.com/partner/public/home)，在【商户平台】->【账户中心】->【API安全】->【商户API证书】页面申请证书。以下为具体下载步骤：

|     |     |
| --- | --- |
| 步骤一：登录商户平台，点击“账户中心-API安全-申请证书” | 步骤二：在弹出窗口内点击“下载证书工具”按钮下载证书工具，并复制商户号和商户名称 |
| ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/26658ec712f9809523729fab75533a80.png) | ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/ba8d0ffc0db2270fa086b04d6e8ab924.png) |
| 步骤三：安装证书工具并打开，选择证书需要存储的路径后点击“申请证书” | 步骤四：将复制的商户号和商户名称粘贴到【证书工具】中，点击“下一步” |
| ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/662485cd7cff9ee308868bc7a21a1829.png) | ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/d66855537d2fb2a72b0d50d1c68273d6.png) |
| 步骤五：在【证书工具】中，复制证书请求串 | 步骤六：将【证书工具】中复制的请求串粘贴到【商户平台】文本框中，点击“下一步” |
| ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/bec3150ccbbe3c4f18bdc1fbb6f23507.png) | ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/82fde8dbc1e6289b0eb3661e93a01abb.png) |
| 步骤七：安全验证，输入操作密码，短信验证码，点击“确定” | 步骤八：在【商户平台】“复制证书串”环节，点击“复制证书串” |
| ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/674a94a58a1341a1fe8106087b87c410.png) | ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/63fc26b8428c56d1099959b80d377ebd.png) |
| 步骤九：将【商户平台】复制的证书串粘贴到【证书工具】中，点击“下一步” | 步骤十：申请商户API证书成功，点击“查看证书文件夹”，查看已生成的证书文件 |
| ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/3e4fbc33997f95ad8b9b4056095956e0.png) | ![](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/img/910c82fbd19dd14f99af883678888086.png) |

注意：请将生成的证书文件转交给技术人员，由技术人员将证书部署到服务器上（请务必妥善保管证书及私钥，因为私钥文件只能通过证书工具导出，若私钥丢失，则无法找回，只能作废后重新申请。）

## 常见问题

### Q：如何查看商户API证书序列号？

A：

1、登录[商户平台（直连模式）](https://pay.weixin.qq.com/)/[合作伙伴平台（服务商模式）](https://pay.weixin.qq.com/partner/public/home)，在【账户中心】->【API安全】->【商户API证书】页面，点击管理证书即可查看商户API证书序列号。

2、使用第三方的证书[解析工具](https://myssl.com/cert_decode.html)查看证书内容。

3、使用openssl命令行工具查看证书序列号。

```
$ openssl x509 -in {证书文件路径} -noout -serial
serial=1DDE55AD98ED71D6EDD4A4A16996DE7B47773A8C
```

### Q：如何获取商户API证书私钥？

A：商户申请商户API证书时，证书工具会生成商户私钥，并保存在本地证书文件夹的文件 `apiclient_key.pem` 中。私钥也可通过工具从商户的p12证书中导出。请妥善保管好商户证书文件。

提示

请勿将私钥文件暴露在公共场合，如上传至 GitHub 或将其写入客户端代码等。

生成后的证书文件为压缩包，解压后有4个文件，证书p12格式，证书pem格式，证书私钥pem格式，说明。

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

### Q：如何查看商户API证书使用量？

A：登录[商户平台（直连模式）](https://pay.weixin.qq.com/)/[合作伙伴平台（服务商模式）](https://pay.weixin.qq.com/partner/public/home)，在【账户中心】->【API安全】->【商户API证书】页面，点击管理证书即可查看商户API证书昨日使用量。

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

### Q：在商户API证书即将到期时，如果旧证书未申请作废，是否可以在证书到期后直接使用新申请的证书？

A：商户API证书到期时就会自动作废，用过期证书无法调用v3接口，所以请务必在到期前完成证书更换。申请新证书不影响旧证书继续使用，微信支持最多3份API证书同时生效，使用其中任意一份有效证书均可。并且只要不超过数量限制，是否作废旧证书都可以随时申请新证书。

### Q：之前使用的v2版本接口已经申请过商户API证书，现在接入v3版本接口是否需要重新申请商户API证书？

A：不需要。

### Q：商户API证书申请后是立即生效么？是否可以立即替换旧证书使用？

A：是的，可以立即替换。

### Q：商户号只有一个证书怎么作废掉？

A：可以申请一个新证书，然后把旧证书作废。

### Q：商户API证书到期，申请新商户API证书后，需要更换几个参数？

A：

1、APIv3接口需要更换代码中的【商户API证书私钥】和【商户API证书序列号】。

2、APIv2接口需要更换请求接口时携带的apiclient\_cert.p12商户API证书文件，详细参考[商户API证书](https://pay.weixin.qq.com/doc/v2/merchant/4011985891.md#4%E3%80%81API%E8%AF%81%E4%B9%A6)。

### Q：APIv2接口与APIv3接口是否可以使用同一个商户API证书的公钥/私钥？

A：支持。

### Q：申请新API证书是否会影响旧证书的使用？

A：不会。API证书支持最多3份同时生效，使用时请注意证书文件和序列号需要一一对应即可。

### Q：v2接口是否需要更换API证书？

A：部分v2接口需要使用API证书，如退款、下载资金账单、撤销等接口（具体参考接口文档说明），过期前也要更换。