下载平台证书
更新时间:2024.12.30由于证书有效期限制和交易安全的原因,微信支付会不定期的更换平台证书。微信支付提供了一系列接口,帮助商户后台系统实现平滑的证书更换。
注意
更换指引:
- 建议开发者使用中控服务器(即统一管理和分发,注意证书的保密和安全性)统一下载和管理微信支付平台证书。其他业务逻辑服务器通过该中控服务器进行报文的验签和解密。
- 在微信支付更换平台证书之前,待更换的证书会提前24小时加入商户的平台证书列表。中控服务器需要定时查询商户的平台证书列表,并及时下载新的平台证书。
- 在微信支付更换平台证书期间,商户收到的应答请求和回调通知中会同时存在不同的证书序列号,商户要能正确处理这种情况。
- 获取平台证书的接口频率限制规则: 单个商户号 1000次/s (查单接口为600次/s)。
最佳实践:
- 在中控服务器上调用;
- 定时调用,间隔应小于12小时;
- 与本地证书序列表对比,如果发现有新增证书序列号,则需要新换的证书。老证书会在1天内失效,应及时清理;
- 获取到证书后,分发到各业务接口服务器。
# 接口说明
支持商户: 【电商平台】
请求方式: 【GET】
请求URL: /v3/certificates
# 字段说明
# 请求参数
无请求参数
# 返回参数
- serial_no 必填证书的序列号
- encrypt_certificate 必填证书内容
Body 包体参数
# 异常返回
- code 必填错误码,枚举值见错误码列表
- message 选填返回信息,如非空,为错误原因
Body 包体参数
# 返回示例
正常返回
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}
# 错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
500 | SYSTEMERROR | 系统错误 | 系统异常,请使用相同参数稍后重新调用 |
400 | PARAM_ERROR | 参数错误 | 请使用正确的参数重新调用 |
400 | RESOURCE_ALREADY_EXISTS | 存在流程进行中的申请单,请检查是否重入 | 可通过查询申请状态查看此申请单的申请状态,或更换out_request_no提交新的申请单 |
403 | NO_AUTH | 商户权限异常 | 请确认是否已经开通相关权限 |
404 | RESOURCE_NOT_EXISTS | 申请单不存在 | 确认入参,传入正确的申请单编号 |
文档是否有帮助