商户进件
特约商户进件
基础支付
JSAPI支付
APP支付
H5支付
Native支付
小程序支付
合单支付
付款码支付
经营能力
支付即服务
点金计划
行业方案
电商收付通(商户进件)
电商收付通(普通支付)
电商收付通(合单支付)
电商收付通(分账)
电商收付通(补差)
电商收付通(退款)
电商收付通(余额查询)
电商收付通(商户提现)
电商收付通(下载账单)
智慧商圈
微信支付分停车服务
营销工具
代金券
商家券
委托营销
支付有礼
小程序发券插件
H5发券
图片上传(营销专用)
现金红包
资金应用
分账
连锁品牌分账
风险合规
商户开户意愿确认
消费者投诉2.0
其他能力
图片上传
视频上传

下载平台证书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

申请单不存在

确认入参,传入正确的申请单编号


技术咨询

文档反馈