提示

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

程序实现定期更新平台证书的逻辑，不要硬编码验证应答消息签名的平台证书。
定期调用该接口，间隔时间小于12 小时。
加密请求消息中的敏感信息时，使用最新的平台证书（即：证书启用时间较晚的证书）。
首次下载证书，可以使用微信支付提供的证书下载工具。
该接口没有query参数或者path参数，仅需要必要的头部信息，如签名认证信息等。
由于证书存在有效期的限制，微信支付会不定期地更换平台证书以确保交易安全，证书过期前会提前把新证书加入到平台证书下载列表中。

关于证书解密，请查阅【接口规则->开发指南->证书和回调报文解密】

接口说明

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

支持商户：【普通商户】

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

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

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引点击查看

请求参数

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

Header HTTP头参数

Authorization 　必填　string

请参考签名认证生成认证信息

Accept 　必填　string

请设置为application/json

请求示例

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

应答参数

200 OK

data 　必填 array[object]

【验签时使用的平台证书序列号】平台证书的详情，包括此资源的所有定义，业务方需要自行添加

属性

serial_no 　必填 string(32)

【证书序列号】平台证书的主键，唯一定义此资源的标识

effective_time 　选填 integer

【证书启用时间】启用证书的时间，时间格式为RFC3339。每个平台证书的启用时间是固定的。

expire_time 　选填 integer

【证书弃用时间】弃用证书的时间，时间格式为RFC3339。更换平台证书前，会提前24小时修改老证书的弃用时间，接口返回新老两个平台证书。更换完成后，接口会返回最新的平台证书。

encrypt_certificate 　必填 object

【证书信息】证书内容

属性

algorithm 　必填 string(32)

【加密证书的算法】对开启结果数据进行加密的加密算法，目前只支持AEAD_AES_256_GCM。

nonce 　必填 string(16)

【加密证书的随机串】对应到加密算法中的IV。

associated_data 　选填 string(16)

【加密证书的附加数据】加密证书的附加数据，固定为“certificate"。

ciphertext 　必填 string(1048576)

【加密后的证书内容】使用API KEY和上述参数，可以解密出平台证书的明文。证书明文为PEM格式。（注意：更换证书时会出现PEM格式中的证书失效时间与接口返回的证书弃用时间不一致的情况）

应答示例

200 OK

1{
2  "data": [
3      {
4          "serial_no": "5157F09EFDC096DE15EBE81A47057A7232F1B8E1",
5          "effective_time ": "2018-06-08T10:34:56+08:00",
6          "expire_time ": "2018-12-08T10:34:56+08:00",
7          "encrypt_certificate": {
8              "algorithm": "AEAD_AES_256_GCM",
9              "nonce": "61f9c719728a",
10              "associated_data": "certificate",
11              "ciphertext": "sRvt… "
12          }
13      },
14      {
15          "serial_no": "50062CE505775F070CAB06E697F1BBD1AD4F4D87",
16          "effective_time ": "2018-12-07T10:34:56+08:00",
17          "expire_time ": "2020-12-07T10:34:56+08:00",
18          "encrypt_certificate": {
19              "algorithm":"AEAD_AES_256_GCM",
20              "nonce":"35f9c719727b",
21              "associated_data": "certificate",
22              "ciphertext": "aBvt… "
23          }
24      }
25  ]
26}

下载平台证书