微信支付接口常用参数及证书区分

短命女 2023-10-12 22:28 177阅读 0赞

## 注意：服务商模式下，均是使用服务商的以下信息 ##

## 1. 证书 ##

### 1.1商户api证书（v2和v3接口都需要使用） ###

#### 1.1.1获取方式： ####

[什么是商户API证书？如何获取商户API证书？][API_API] （商户api证书  
），里面介绍了如何获取商户证书的详细步骤

#### 1.1.2作用： ####

###### v3接口： ######

使用商户api证书私钥用于生成签名（签名的官方文档: [签名生成-接口规则 | 微信支付商户平台文档中心][-_ _] ） ,一共三个证书文件，一个说明文件（建议阅读一下），商户api证书私钥是apiclient\_key.pem这个文件（代码加载，参考官方文档： [https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay7\_1.shtml），剩下的两个证书文件目前我个人是没有发现在v3接口需要使用，咨询技术支持也是这样回复的。][https_pay.weixin.qq.com_wiki_doc_apiv3_wechatpay_wechatpay7_1.shtml_v3]

![f8b8cdf63290207766d641a45b3aeea3.png][]

###### v2接口： ######

v2接口需要使用证书的接口在文档会有特别提示：

![b07241883f3311828146cb3d36a56c48.png][]

一般开发语言使用的p12证书，详细信息参考链接：[https://pay.weixin.qq.com/wiki/doc/api/jsapi\_sl.php?chapter=4\_3][https_pay.weixin.qq.com_wiki_doc_api_jsapi_sl.php_chapter_4_3]

![8ed6b0629c186895bea3e7db488ca752.png][]

注意:  
1.php使用方法参考文档

![adce3dc0d7cc5368ca36e80b4b6d75b1.png][]

2. .NET环境开发，请确认Framework版本大于2.0，必须在操作系统上双击安装证书apiclient\_cert.p12后才能被正常调用。

![b707be475eb08637e928bb6b7014f18d.png][]

3.apiclient\_cert.p12是商户证书文件，除PHP外的开发均使用此证书文件。官方sdk包含了示例代码，这里展示的是java语言的

![898c8d380e235ac1a9f8a3dedd526372.png][]

#### 1.1.3如何查看 证书使用是否正确（v2和v3接口通用检查方法）： ####

到证书解析的网站解析（ [证书查看][Link 1] ） apiclient\_cert.pem这个文件，查看它的证书序列号，对比商户平台的证书序列号。（下载证书的时候这三个文件一般放在一起，根据apiclient\_cert.pem文件判断使用的是否是正确的

#### 1.1.4商户api证书序列号查看方式及作用（v3接口） ####

查看：管理员帐号登录微信商户管理后台，在API安全里面点击查看证书可以获取。  
作用：构建签名，用于声明所使用的证书

### 1.2微信支付平台证书（v3接口使用） ###

#### 1.2.1获取方式 ####

1：接口获取（官方文档： [平台证书-文档中心-微信支付商户平台][-_-] ，代码（java）： [https://github.com/wechatpay-apiv3/wechatpay-apache-httpclient][https_github.com_wechatpay-apiv3_wechatpay-apache-httpclient]

![6281b8477bbe573f4d599772610562e1.png][]

2：官方工具：（ [SDK，工具 | 微信支付商户平台文档中心][SDK_ _] ）

![e085a676438a4127a0611f71c4da6dbf.png][]

3：postman([https://github.com/wechatpay-apiv3/wechatpay-postman-script][https_github.com_wechatpay-apiv3_wechatpay-postman-script]):配置好可以直接下载，然后解密（解密参考：[证书和回调报文解密-接口规则 | 微信支付商户平台文档中心][-_ _ 1]

![08a691fad6df594505ab4eab6764859d.png][]

即可使用（推荐在测试的时候使用，顺便检查了签名的参数是否正确）

#### 1.2.2作用： ####

1、用户回调信息的验签（验签文档： [签名验证-接口规则 | 微信支付商户平台文档中心][-_ _ 2] ），验签的方法很多，这里就不提供了，【重要】：

![6e1a954ddd81727dab41955e215b207d.png][]

这个顺序不能改变，顺序改变会出现验签失败，接口返回的来的顺序不要修改，可能某些方法会修改顺序（亲测加咨询）。  
2、敏感信息加解密（\[[敏感信息加解密-接口规则 | 微信支付服务商平台文档中心][-_ _ 3]\]）

#### 1.2.3检查微信支付平台证书使用是否正确： ####

1：检查回调信息返回的微信支付平台证书序列号和商户现有的微信支付平台证书序列号是否一致，如果不一致，请重新下载  
2：如果重新下载的微信支付平台证书序列号跟当前回调的微信支付平台证书序列号不一致，则应该是下载的微信支付平台证书的商户号不是当前回调订单的商户

#### 1.2.4微信支付平台证书序列号获取方式及作用 ####

获取：跟微信支付平台证书获取方式一致（对应字段：serial\_no）  
作用：1.回调参数返回给商户，用于验证回到的安全性（也可以用来区分是哪一个商户的回调，因为每个商户的微信支付平台证书序列号不一致）  
2.用户敏感信息加密时，当作加密标识

### 注意：回调返回的和请求接口时返回的证书序列号是微信支付平台证书序列号，不是商户API证书序列号，二者不一样 ###

## 2. apiv3密钥（v3接口使用） ##

### 2.1如何设置： ###

[什么是APIv3密钥？如何设置？][APIv3] （文档说明了如何设置，这里就不提供商户平台的截图了）

### 2.2作用： ###

v3接口下，商户对支付回调的解密（咨询技术支持说逻辑是发给我们的回调通知是使用我们商户平台设置的apiv3密钥进行加密的，所以也是使用它来解密，解密失败有三种可能：1.apiv3密钥错误，跟当时设置的不一样2.使用的apiv3的密钥不是当前订单对应商户号下设置的apiv3密钥）（官方解密： [证书和回调报文解密-接口规则 | 微信支付商户平台文档中心][-_ _ 1] ，亲测报错AEADBadTagException: Tag mismatch! 检查就是apiv3密钥错误导致  
）3.解密的参数不完整，请检查回调参数的完整性

## 3.apiv2密钥（v2接口使用） ##

### 3.1如何设置： ###

[什么是APIv2密钥？如何设置或修改？][APIv2] （文档说明了如何设置，这里就不提供商户平台的截图了）

### 3.2作用： ###

商户调用v2接口时，使用api密钥进行签名，或者对v2接口返回的回调信息进行验签和解密（部分回调需要解密，比如退款回调）

## 注意：apiv3密钥和apiv2密钥不是同一个参数，作用不相同，二者独立设置，且互不影响 ##

[API_API]: https://kf.qq.com/faq/161222NneAJf161222U7fARv.html
[-_ _]: https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay4_0.shtml
[https_pay.weixin.qq.com_wiki_doc_apiv3_wechatpay_wechatpay7_1.shtml_v3]: https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay7_1.shtml
[f8b8cdf63290207766d641a45b3aeea3.png]: https://img-blog.csdnimg.cn/img_convert/f8b8cdf63290207766d641a45b3aeea3.png
[b07241883f3311828146cb3d36a56c48.png]: https://img-blog.csdnimg.cn/img_convert/b07241883f3311828146cb3d36a56c48.png
[https_pay.weixin.qq.com_wiki_doc_api_jsapi_sl.php_chapter_4_3]: https://pay.weixin.qq.com/wiki/doc/api/jsapi_sl.php?chapter=4_3
[8ed6b0629c186895bea3e7db488ca752.png]: https://img-blog.csdnimg.cn/img_convert/8ed6b0629c186895bea3e7db488ca752.png
[adce3dc0d7cc5368ca36e80b4b6d75b1.png]: https://img-blog.csdnimg.cn/img_convert/adce3dc0d7cc5368ca36e80b4b6d75b1.png
[b707be475eb08637e928bb6b7014f18d.png]: https://img-blog.csdnimg.cn/img_convert/b707be475eb08637e928bb6b7014f18d.png
[898c8d380e235ac1a9f8a3dedd526372.png]: https://img-blog.csdnimg.cn/img_convert/898c8d380e235ac1a9f8a3dedd526372.png
[Link 1]: https://myssl.com/cert_decode.html
[-_-]: https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay5_1.shtml
[https_github.com_wechatpay-apiv3_wechatpay-apache-httpclient]: https://github.com/wechatpay-apiv3/wechatpay-apache-httpclient
[6281b8477bbe573f4d599772610562e1.png]: https://img-blog.csdnimg.cn/img_convert/6281b8477bbe573f4d599772610562e1.png
[SDK_ _]: https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay6_0.shtml
[e085a676438a4127a0611f71c4da6dbf.png]: https://img-blog.csdnimg.cn/img_convert/e085a676438a4127a0611f71c4da6dbf.png
[https_github.com_wechatpay-apiv3_wechatpay-postman-script]: https://github.com/wechatpay-apiv3/wechatpay-postman-script
[-_ _ 1]: https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay4_2.shtml
[08a691fad6df594505ab4eab6764859d.png]: https://img-blog.csdnimg.cn/img_convert/08a691fad6df594505ab4eab6764859d.png
[-_ _ 2]: https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay4_1.shtml
[6e1a954ddd81727dab41955e215b207d.png]: https://img-blog.csdnimg.cn/img_convert/6e1a954ddd81727dab41955e215b207d.png
[-_ _ 3]: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/wechatpay/wechatpay4_3.shtml
[APIv3]: https://kf.qq.com/faq/180830E36vyQ180830AZFZvu.html
[APIv2]: https://kf.qq.com/faq/180830UVRZR7180830Ij6ZZz.html