下载平台证书

更新时间:2024.12.30

由于证书有效期限制和交易安全的原因,微信支付会不定期的更换平台证书。微信支付提供了一系列接口,帮助商户后台系统实现平滑的证书更换。

注意

更换指引:

  • 建议开发者使用中控服务器(即统一管理和分发,注意证书的保密和安全性)统一下载和管理微信支付平台证书。其他业务逻辑服务器通过该中控服务器进行报文的验签和解密。
  • 在微信支付更换平台证书之前,待更换的证书会提前24小时加入商户的平台证书列表。中控服务器需要定时查询商户的平台证书列表,并及时下载新的平台证书。
  • 在微信支付更换平台证书期间,商户收到的应答请求和回调通知中会同时存在不同的证书序列号,商户要能正确处理这种情况。
  • 获取平台证书的接口频率限制规则: 单个商户号 1000次/s (查单接口为600次/s)。

最佳实践:

  • 在中控服务器上调用;
  • 定时调用,间隔应小于12小时;
  • 与本地证书序列表对比,如果发现有新增证书序列号,则需要新换的证书。老证书会在1天内失效,应及时清理;
  • 获取到证书后,分发到各业务接口服务器。

# 接口说明

支持商户: 【电商平台】

请求方式: 【GET】

请求URL: /v3/certificates

# 字段说明

# 请求参数

无请求参数

# 返回参数

    Body 包体参数
  • serial_no 必填 string(32)
    证书的序列号
  • encrypt_certificate 必填 string(4096)
    证书内容

# 异常返回

    Body 包体参数
  • code 必填 string(32)
    错误码,枚举值见错误码列表
  • message 选填 string(256)
    返回信息,如非空,为错误原因

# 返回示例

正常返回

1{
2 "data" : [
3 {
4 "serial_no": "",
5 "encrypt_certificate": ""
6 },
7 {
8 "serial_no": "",
9 "encrypt_certificate": ""
10 }
11 ]
12}

异常返回

1{
2 "code":"INVALID_REQUEST",
3 "message":"参数格式校验错误"
4}

# 错误码

公共错误码 (opens new window)

状态码 错误码 描述 解决方案
500 SYSTEMERROR 系统错误 系统异常,请使用相同参数稍后重新调用
400 PARAM_ERROR 参数错误 请使用正确的参数重新调用
400 RESOURCE_ALREADY_EXISTS 存在流程进行中的申请单,请检查是否重入 可通过查询申请状态查看此申请单的申请状态,或更换out_request_no提交新的申请单
403 NO_AUTH 商户权限异常 请确认是否已经开通相关权限
404 RESOURCE_NOT_EXISTS 申请单不存在 确认入参,传入正确的申请单编号
反馈
咨询
目录

微信支付文档中心已升级,你当前所查看的是旧文档中心的内容,旧文档中心将于 2025年 3 月 31日 下线,请移步 [新文档中心] 查看相应的内容