开发必要参数说明

mchid

mchid(商户号)商户在商户平台申请的唯一身份标识，所有接口在调用时都必须传商户号，微信支付通过商户号确认商户身份。

超级管理员、技术负责人

登录微信商户平台，点击【账户中心->商户信息】即可查看商户号。如还没有商户号请参考：mchid与appid申请。

appid

appid(开发者ID)是商户在微信开放平台(移动应用)或公众平台(服务号/政府或媒体类型的公众号/小程序)上的账号开发识别码，该appid必须与商户号mchid进行绑定。 

超级管理员、技术负责人

可通过以下三种方式查询需要绑定APPID账号：

1）若绑定服务号/公众号类型的APPID，商户登录公众平台 ，通过路径【设置与开发 -> 开发接口管理 -> 基本配置 -> 开发者ID(AppID)】查看。

openid

用户在公众号内的唯一身份标识，不同公众号类型对应不同的 OpenID，同一个用户在不同的公众号下也对应不同的openid，微信支付部分接口需要传递该参数。

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

可通过以下四种方式获取：

APIv3密钥

商户会在以下两种场景中使用APIv3密钥：

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

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

超级管理员、技术负责人

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

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

商户API证书

商户发起APIv3接口请求时，需要使用商户API证书私钥对请求进行签名。

超级管理员、技术负责人

首次获取请登录微信商户平台，参考申请商户API证书流程进行下载，下载后请妥善保管，该证书只能下载一次，若遗失或泄露，需在商户平台重新申请下载。

商户API证书序列号

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

超级管理员、技术负责人

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

方案 A：微信支付公钥（推荐）

微信支付公钥
(公钥长期有效，管理简单，新接入按公钥获取即可)

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

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

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

超级管理员、 配置技术负责人账号指引 

登录微信商户平台，参考 产品介绍 进行下载。

微信支付公钥id

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

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

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

超级管理员、 配置技术负责人账号指引 

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

方案 B：微信支付平台证书

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

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

2、与平台证书序列号成对使用。

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

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

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

平台证书序列号

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

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

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

3、与微信支付平台证书成对使用。

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

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

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

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

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