---
url: "https://pay.weixin.qq.com/doc/v3/merchant/4013070756.md"
title: "开发必要参数说明"
doc_id: 4013070756
---

>更新时间：2026.06.02

普通商户模式开发前需要先准备以下开发必要参数：

| 参数名 | 用途 | 获取角色 | 获取方式 |
| --- | --- | --- | --- |
| mchid | `mchid`(商户号)商户在[商户平台](https://pay.weixin.qq.com/index.php/core/home/login?return_url=%2F)申请的唯一身份标识，所有接口在调用时都必须传商户号，微信支付通过商户号确认商户身份。 | 超级管理员、[技术负责人](https://pay.weixin.qq.com/doc/v3/merchant/4015423618.md) | 登录[微信商户平台](https://pay.weixin.qq.com/index.php/core/home/login?return_url=%2F)，点击【账户中心->商户信息】即可查看商户号。如还没有商户号请参考：[mchid与appid申请](https://pay.weixin.qq.com/doc/v3/merchant/4012071573.md)。 |
| appid | `appid`(开发者ID)是商户在微信[开放平台](https://open.weixin.qq.com/)(移动应用)或[公众平台](https://mp.weixin.qq.com/)(服务号/政府或媒体类型的公众号/小程序)上的账号开发识别码，该 `appid` 必须与商户号 `mchid` 进行[绑定](https://pay.weixin.qq.com/doc/v3/merchant/4013287010.md)。 | 超级管理员、[技术负责人](https://pay.weixin.qq.com/doc/v3/merchant/4015423618.md) | 登录[微信商户平台](https://pay.weixin.qq.com/index.php/core/home/login?return_url=%2F)，可[查看商户号已绑定的appid](https://pay.weixin.qq.com/doc/v3/merchant/4016328613.md#1%E3%80%81%E6%9F%A5%E8%AF%A2%E5%95%86%E6%88%B7%E5%8F%B7%E7%BB%91%E5%AE%9A%E7%9A%84APPID%E8%B4%A6%E5%8F%B7)，若未绑定请超级管理员参考：[商户号绑定appid指南](https://pay.weixin.qq.com/doc/v3/merchant/4016328613.md#2%E3%80%81%E5%95%86%E6%88%B7%E5%8F%B7%E7%BB%91%E5%AE%9A%E6%96%B0%E7%9A%84APPID%E8%B4%A6%E5%8F%B7%E6%93%8D%E4%BD%9C%E6%8C%87%E5%8D%97)。如还没有APPID请参考：[mchid与appid申请](https://pay.weixin.qq.com/doc/v3/merchant/4012071573.md)。 |
| 商户API证书 | 商户发起APIv3接口请求时，需要使用商户API证书私钥[对请求进行签名](https://pay.weixin.qq.com/doc/v3/merchant/4012365334.md)。 | 超级管理员、[技术负责人](https://pay.weixin.qq.com/doc/v3/merchant/4015423618.md) | 首次获取请登录[微信商户平台](https://pay.weixin.qq.com/)，参考[申请商户API证书流程](https://pay.weixin.qq.com/doc/v3/merchant/4012072428.md)进行下载，下载后请妥善保管，该证书只能下载一次，若遗失或泄露，需在商户平台重新申请下载。 |
| 商户API证书序列号 | 调用APIv3接口时请求头中的必传参数( `serial_no`)，需要与生成签名值时使用的商户API证书对应。 | 超级管理员、[技术负责人](https://pay.weixin.qq.com/doc/v3/merchant/4015423618.md) | 登录[微信商户平台](https://pay.weixin.qq.com/)或通过证书解析工具可获取到商户API证书序列号，详见：[查看商户API证书序列号指南](https://pay.weixin.qq.com/doc/v3/merchant/4012072428.md#Q%EF%BC%9A%E5%A6%82%E4%BD%95%E6%9F%A5%E7%9C%8B%E5%95%86%E6%88%B7API%E8%AF%81%E4%B9%A6%E5%BA%8F%E5%88%97%E5%8F%B7%EF%BC%9F)。 |
| 微信支付公钥<br>(推荐使用，公钥长期有效，管理简单) | 商户会在以下两种场景中使用微信支付公钥：<br>1、接收到APIv3接口的返回内容，需要使用微信支付公钥进行[验签](https://pay.weixin.qq.com/doc/v3/merchant/4013053249.md)；<br>2、调用某些含有敏感信息参数(如姓名、身份证号码)的接口时，需要使用微信支付公钥[加密敏感信息](https://pay.weixin.qq.com/doc/v3/merchant/4013053257.md)后再传输参数。 | 超级管理员、[技术负责人](https://pay.weixin.qq.com/doc/v3/merchant/4015423618.md) | 登录[微信商户平台](https://pay.weixin.qq.com/)，参考[微信支付公钥获取指南](https://pay.weixin.qq.com/doc/v3/merchant/4012153196.md)进行下载。 |
| 微信支付公钥id | 商户会在以下两种场景中使用微信支付公钥id( `Wechatpay-Serial`)：<br>1、接收到APIv3接口的返回内容，请求头中会携带公钥id，商户需使用对应的微信支付公钥进行[验签](https://pay.weixin.qq.com/doc/v3/merchant/4013053249.md)；<br>2、当调用的接口带有使用微信支付公钥[加密的敏感信息](https://pay.weixin.qq.com/doc/v3/merchant/4013053257.md)参数时，需在请求头中传公钥id参数。 | 超级管理员、[技术负责人](https://pay.weixin.qq.com/doc/v3/merchant/4015423618.md) | 登录[微信商户平台](https://pay.weixin.qq.com/)，进入【账户中心 > 账户设置 \> API安全】目录，点击【管理公钥】即可查看到微信支付公钥id。 |
| APIv3密钥 | 商户会在以下两种场景中使用APIv3密钥：<br>1、微信支付会使用APIv3密钥加密回调信息，然后将加密后的密文回调给商户，商户接收到APIv3回调通知的密文后，需使用该密钥进行[解密](https://pay.weixin.qq.com/doc/v3/merchant/4012071382.md)。<br>2、在[下载平台证书](https://pay.weixin.qq.com/doc/v3/merchant/4012551764.md)公钥时，需要使用该密钥进行解密。 | 超级管理员、[技术负责人](https://pay.weixin.qq.com/doc/v3/merchant/4015423618.md) | 首次设置请登录[微信商户平台](https://pay.weixin.qq.com/)，参考[设置APIv3密钥流程](https://pay.weixin.qq.com/doc/v3/merchant/4012072195.md)，<br>设置后无法在商户平台查看，请商户妥善保管，若遗失或泄露须重新设置。 |
| 微信支付平台证书<br>(推荐切换成微信支付公钥，平台证书需要每五年更换一次) | 微信支付平台证书的作用等同于微信支付公钥，主要用于APIv3接口的返回内容的[验签](https://pay.weixin.qq.com/doc/v3/merchant/4013053420.md)和[敏感信息加密](https://pay.weixin.qq.com/doc/v3/merchant/4013053264.md)参数。 | 开发人员通过调用接口下载 | 首次获取平台证书需通过Java命令行下载，后续则可以使用[微信支付平台证书下载](https://pay.weixin.qq.com/doc/v3/merchant/4012551764.md)接口获取，详见：[平台证书简介及使用说明](https://pay.weixin.qq.com/doc/v3/merchant/4012068814.md#4.-%E5%A6%82%E4%BD%95%E8%8E%B7%E5%8F%96%E5%B9%B3%E5%8F%B0%E8%AF%81%E4%B9%A6)。<br>已经使用平台证书的服务商也可[参考指引切换为使用微信支付公钥](https://pay.weixin.qq.com/doc/v3/merchant/4012154180.md)。 |
| 平台证书序列号 | 商户会在以下两种场景中使用平台证书序列号( `Wechatpay-Serial`)：<br>1、接收到APIv3接口的返回内容，请求头中会携带平台证书序列号，商户需使用对应的平台证书进行[验签](https://pay.weixin.qq.com/doc/v3/merchant/4013053420.md)；<br>2、当调用的接口带有使用平台证书[加密的敏感信息](https://pay.weixin.qq.com/doc/v3/merchant/4013053264.md)参数时，需在请求头中传平台证书序列号参数。 | 开发人员通过调用接口获取 | 可通过以下三种方式查看平台证书序列号：<br>1、在调用接口[下载微信支付平台证书](https://pay.weixin.qq.com/doc/v3/merchant/4012551764.md)时，接口会返回平台证书序列号( `serial_no`)参数。<br>2、可使用openssl命令行工具查看证书序列号，详见：[如何查看商户API证书或平台证书序列号](https://pay.weixin.qq.com/doc/v3/merchant/4013053294.md)<br>3、可使用第三方的证书[解析工具](https://myssl.com/cert_decode.html)，查看证书内容、 |
| openid | 用户在公众号内的唯一身份标识，不同公众号类型对应不同的 OpenID，同一个用户在不同的公众号下也对应不同的openid，微信支付部分接口需要传递该参数。 | 开发人员通过调用接口获取 | 可通过以下四种方式获取：<br>H5获取openid详见[网页授权获取用户OpenID](https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html)<br>小程序获取openid详见[小程序获取OpenID](https://developers.weixin.qq.com/miniprogram/dev/api/open-api/login/wx.login.html)<br>JSAPI获取openid详见[公众号获取OpenID](https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html)<br>App获取openid详见[App获取OpenID](https://developers.weixin.qq.com/doc/oplatform/Mobile_App/WeChat_Login/Authorized_API_call_UnionID.html) |