---
url: "https://pay.weixin.qq.com/doc/v3/merchant/4012551764.md"
title: "下载平台证书"
doc_id: 4012551764
---

>更新时间：2024.09.13

提示

如果自行实现验证平台签名逻辑的话，需要注意以下事项:

- 程序实现定期更新平台证书的逻辑，不要硬编码验证应答消息签名的平台证书。

- 定期调用该接口，间隔时间小于12 小时。

- 加密请求消息中的敏感信息时，使用最新的平台证书（即：证书启用时间较晚的证书）。

- 首次下载证书，可以使用微信支付提供的[证书下载工具](https://github.com/wechatpay-apiv3/CertificateDownloader)。

- 该接口没有query参数或者path参数，仅需要必要的头部信息，如签名认证信息等。

- 由于证书存在有效期的限制，微信支付会不定期地更换平台证书以确保交易安全，证书过期前会提前把新证书加入到平台证书下载列表中。


关于证书解密，请查阅【接口规则->开发指南->[证书和回调报文解密](https://pay.weixin.qq.com/doc/v3/merchant/4012071382.md)】




## 接口说明

接口的频率限制: 单个商户号1000 次/s

支持商户：【普通商户】

请求方式：【GET】 `/v3/certificates`

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引[点击查看](https://pay.weixin.qq.com/doc/v3/merchant/4012075113.md)

## 请求参数

获取商户当前可用的平台证书列表。微信支付提供该接口，帮助商户后台系统实现平台证书的平滑更换。该请求无需身份认证信息之外的其他参数。

### Header 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| Authorization | string | true | 请参考 [签名认证](https://pay.weixin.qq.com/doc/v3/merchant/4012365342.md#%E8%AF%B7%E6%B1%82%E6%8E%A5%E5%8F%A3%E5%90%8E%E7%AB%AF%E7%AD%BE%E5%90%8D) 生成认证信息 |
| Accept | string | true | 请设置为 `application/json` |
## 应答参数

200 OK

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| data | array[object] | true | **【验签时使用的平台证书序列号】** 平台证书的详情，包括此资源的所有定义，业务方需要自行添加 |
| data.serial_no | string(32) | true | 【证书序列号】 平台证书的主键，唯一定义此资源的标识 |
| data.effective_time | integer | false | 【证书启用时间】 启用证书的时间，时间格式为RFC3339。每个平台证书的启用时间是固定的。 |
| data.expire_time | integer | false | 【证书弃用时间】 弃用证书的时间，时间格式为RFC3339。更换平台证书前，会提前24小时修改老证书的弃用时间，接口返回新老两个平台证书。更换完成后，接口会返回最新的平台证书。 |
| data.encrypt_certificate | object | true | 【证书信息】 证书内容 |
| data.encrypt_certificate.algorithm | string(32) | true | 【加密证书的算法】 对开启结果数据进行加密的加密算法，目前只支持AEAD\_AES\_256\_GCM。 |
| data.encrypt_certificate.nonce | string(16) | true | 【加密证书的随机串】 对应到加密算法中的IV。 |
| data.encrypt_certificate.associated_data | string(16) | false | 【加密证书的附加数据】 加密证书的附加数据，固定为“certificate"。 |
| data.encrypt_certificate.ciphertext | string(1048576) | true | 【加密后的证书内容】 使用API KEY和上述参数，可以解密出平台证书的明文。证书明文为PEM格式。（注意：更换证书时会出现PEM格式中的证书失效时间与接口返回的证书弃用时间不一致的情况） |

请求示例

```
curl -X GET \
  https://api.mch.weixin.qq.com/v3/certificates \
  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
  -H "Accept: application/json"”

```

应答示例

> 200 OK

```
{
  "data": [
      {
          "serial_no": "5157F09EFDC096DE15EBE81A47057A7232F1B8E1",
          "effective_time ": "2018-06-08T10:34:56+08:00",
          "expire_time ": "2018-12-08T10:34:56+08:00",
          "encrypt_certificate": {
              "algorithm": "AEAD_AES_256_GCM",
              "nonce": "61f9c719728a",
              "associated_data": "certificate",
              "ciphertext": "sRvt… "
          }
      },
      {
          "serial_no": "50062CE505775F070CAB06E697F1BBD1AD4F4D87",
          "effective_time ": "2018-12-07T10:34:56+08:00",
          "expire_time ": "2020-12-07T10:34:56+08:00",
          "encrypt_certificate": {
              "algorithm":"AEAD_AES_256_GCM",
              "nonce":"35f9c719727b",
              "associated_data": "certificate",
              "ciphertext": "aBvt… "
          }
      }
  ]
}
```
