开发必要参数说明

sp_mchid

sp_mchid是服务商在微信支付侧的唯一身份标识，所有接口调用都必须包含此参数，以便微信支付确认商户的身份。当入驻审核成功后，微信支付侧会向商户提供该商户号。

超级管理员、技术负责人

登录服务商平台，点击【账户中心->个人设置->个人信息】即可查看服务商商户号。

sp_appid

sp_appid是服务商在微信开放平台（移动应用）或公众平台（公众号/小程序）上申请的一个唯一标识。该sp_appid必须与服务商商户号sp_mchid进行绑定，因为使用微信支付功能会校验该参数。

超级管理员、技术负责人

服务商可登录服务商平台，通过路径【产品中心 -> APPID账号管理 -> 我关联的APPID账号】来查看所有绑定的APPID账号。若未绑定请超级管理员参考：服务商商户号与AppID账号关联管理。

sub_mchid

sub_mchid是子商户（也叫特约商户）在服务商下的唯一身份标识。子商户进件有两种方式：

1、通过服务商平台进件

2、通过接口进件

当子商户进件成功后，微信支付侧会向商户提供该子商户号。

超级管理员、技术负责人

子商户号查询有两种方式：

1、可登录服务商平台，点击【合作伙伴功能-商户基础服务-开发参数配置】即可查看子商户号。

2、接口获取，服务商调用查询申请单状态API接口，会通过参数sub_mchid返回子商户号。

sub_appid

sub_appid是子商户在微信开放平台（移动应用）或公众平台（公众号/小程序）上申请的一个唯一标识。该sub_appid必须与子商户号sub_mchid进行绑定，因为使用微信支付功能会校验该参数。由服务商登录服务商平台为子商户进行绑定，具体流程请参考服务商为子商户配置AppID（即sub_appid）。

超级管理员、技术负责人

sub_appid查询有两种方式：

1、服务商可登录服务商平台，通过路径【合作伙伴功能 -> 开发参数配置 -> 找到对应子商户号点击“开发配置” -> 特约商户APPID配置】来查看所有服务商为子商户绑定的APPID。

2、子商户可登录商户平台，通过路径【产品中心 -> APPID账号配置 -> 服务商为我关联的APPID账号 】来查看所有服务商为子商户绑定的APPID。

服务商API证书序列号

调用APIv3接口时请求头中的必传参数(serial_no)，需要与生成签名值时使用的服务商API证书对应。

超级管理员、技术负责人

登录微信服务商平台或通过证书解析工具可获取到服务商API证书序列号，详见：查看商户API证书序列号指南。

微信支付公钥
(推荐使用，公钥长期有效，管理简单)

服务商会在以下两种场景中使用微信支付公钥：

1、接收到APIv3接口的返回内容，需要使用微信支付公钥进行验签；

2、调用某些含有敏感信息参数(如姓名、身份证号码)的接口时，需要使用微信支付公钥加密敏感信息后再传输参数。

超级管理员、技术负责人

登录微信服务商平台，参考微信支付公钥获取指南进行下载。

微信支付公钥id

服务商会在以下两种场景中使用微信支付公钥id(Wechatpay-Serial)：

1、接收到APIv3接口的返回内容，请求头中会携带公钥id，服务商需使用对应的微信支付公钥进行验签；

2、当调用的接口带有使用微信支付公钥加密的敏感信息参数时，需在请求头中传公钥id参数。 

超级管理员、技术负责人

登录微信服务商平台，进入【账户中心 > 账户设置 > API安全】目录，点击【管理公钥】即可查看到微信支付公钥id。

APIv3密钥

开发者接入之前需要设置APIv3密钥，服务商会在以下两种场景中使用到APIv3密钥：

1、微信支付会使用APIv3密钥加密回调信息，然后将加密后的密文回调给服务商，服务商接收到APIv3回调通知的密文后，需使用该密钥进行解密。

2、在下载平台证书公钥时，需要使用该密钥进行解密。

超级管理员、技术负责人

首次设置请登录微信服务商平台，参考设置APIv3密钥流程，

设置后无法在服务商平台查看，请服务商妥善保管，若遗失或泄露须重新设置。

微信支付平台证书
(推荐切换成微信支付公钥，平台证书需要每五年更换一次)

微信支付平台证书的作用等同于微信支付公钥，主要用于APIv3接口的返回内容的验签和敏感信息加密参数。

开发人员通过调用接口下载

首次获取平台证书需通过Java命令行下载，后续则可以使用微信支付平台证书下载接口获取，详见：平台证书简介及使用说明。

已经使用平台证书的服务商也可参考指引切换为使用微信支付公钥。

平台证书序列号

服务商会在以下两种场景中使用平台证书序列号(Wechatpay-Serial)：

1、接收到APIv3接口的返回内容，请求头中会携带平台证书序列号，服务商需使用对应的平台证书进行验签；

2、当调用的接口带有使用平台证书加密的敏感信息参数时，需在请求头中传平台证书序列号参数。 

开发人员通过调用接口获取

可通过以下三种方式查看平台证书序列号：

1、在调用接口下载微信支付平台证书时，接口会返回平台证书序列号(serial_no)参数。

2、可使用openssl命令行工具查看证书序列号，详见：如何查看商户API证书或平台证书序列号

3、可使用第三方的证书解析工具，查看证书内容、