私钥和证书

介绍商户API私钥、证书和微信支付平台证书的获取和使用方式

商户API证书

商户API证书是指由商户申请的，包含商户的商户号、公司名称、公钥信息的证书。

微信支付API v3使用由证书授权机构(Certificate Authority ，简称CA)签发颁发的证书。商户需下载证书工具生成证书请求串，并将证书请求串提交到商户平台后才能获得商户API证书文件。

• 新接入商户请参考什么是API证书？如何获取API证书？。

• 已经接入并使用微信支付颁发证书的商户请参考微信支付API证书升级指引（技术人员）。API v3已不支持使用微信支付颁发的证书。

• 证书升级不影响已有服务。

• 微信支付颁发的证书，将在升级后14天后失效。请务必尽快用新证书替换服务器上的老证书。

商户API私钥

商户申请商户API证书时，会生成商户私钥，并保存在本地证书文件夹的文件apiclient_key.pem中。私钥也可以通过工具从商户的p12证书中导出。请妥善保管好你的商户私钥文件。

不要把私钥文件暴露在公共场合，如上传到Github，写在客户端代码等。

平台证书

平台证书是指由微信支付负责申请的，包含微信支付平台标识、公钥信息的证书。商户可以使用平台证书中的公钥进行验签。

微信支付平台证书请调用“获取平台证书接口“获取。

不同的商户，对应的微信支付平台证书是不一样的

平台证书会周期性更换。商户应定时通过API下载新的证书。请参考我们的更新指引，不要依赖人工更新证书。

声明所使用的证书

某些情况下，将需要更新密钥对和证书。为了保证更换过程中不影响API的使用，请求和应答的HTTP头部中包括证书序列号，以声明签名或者加密所用的密钥对和证书。

• 商户签名使用商户私钥，证书序列号包含在请求HTTP头部的Authorization的serial_no

• 微信支付签名使用微信支付平台私钥，证书序列号包含在应答HTTP头部的Wechatpay-Serial

• 商户上送敏感信息时使用微信支付平台公钥加密，证书序列号包含在请求HTTP头部的Wechatpay-Serial

请参考如何查看证书序列号。