微信支付-开发者文档

返回上一层文档首页 / 下载平台证书API

下载平台证书API

最新更新时间：2019.09.09 版本说明

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

更换指引：

● 建议开发者使用中控服务器（即统一管理和分发，注意证书的保密和安全性）统一下载和管理微信支付平台证书。其他业务逻辑服务器通过该中控服务器进行报文的验签和解密。

● 在微信支付更换平台证书之前，待更换的证书会提前24小时加入商户的平台证书列表。中控服务器需要定时查询商户的平台证书列表，并及时下载新的平台证书。

● 在微信支付更换平台证书期间，商户收到的应答请求和回调通知中会同时存在不同的证书序列号，商户要能正确处理这种情况。

● 获取平台证书的接口频率限制规则: 单个商户号 1000次/s (查单接口为600次/s)。

最佳实践：

在中控服务器上调用；

定时调用，间隔应小于12小时；

与本地证书序列表对比，如果发现有新增证书序列号，则需要新换的证书。老证书会在1天内失效，应及时清理；

获取到证书后，分发到各业务接口服务器。

接口说明

适用对象：电商平台

请求URL：https://api.mch.weixin.qq.com/v3/certificates

请求方式：GET

path指该参数为路径参数

query指该参数需在请求URL传参

body指该参数需在请求JSON传参

请求参数

无请求参数

返回参数

参数名	变量	类型[长度限制]	必填	描述
序列号	serial_no	string[1,32]	是	证书的序列号
证书	encrypt_certificate	string[1,4096]	是	证书内容

异常返回

参数名	变量	类型[长度限制]	必填	描述
返回状态码	code	string[1,32]	是	错误码，枚举值见错误码列表示例值：INVALID_REQUEST
返回信息	message	string[1,256]	否	返回信息，如非空，为错误原因示例值：参数格式校验错误

返回示例


{
    "data" : [
        {
            "serial_no": "",
            "encrypt_certificate": ""
        },
        {
            "serial_no": "",
            "encrypt_certificate": ""
        }
    ]
}

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

错误码公共错误码

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

微信支付合作伙伴平台