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

>更新时间：2026.06.02

服务商模式开发前需要先准备以下开发必要参数：

| 参数名 | 用途 | 获取角色 | 获取方式 |
| --- | --- | --- | --- |
| sp\_mchid | `sp_mchid` 是服务商在微信支付侧的唯一身份标识，所有接口调用都必须包含此参数，以便微信支付确认商户的身份。当[入驻](https://kf.qq.com/faq/161220iqeAfA1612202yeURB.html)审核成功后，微信支付侧会向商户提供该商户号。 | 超级管理员、技术负责人 | 登录[服务商平台](https://pay.weixin.qq.com/index.php/partner/public/home)，点击【账户中心->个人设置->个人信息】即可查看服务商商户号。如还没有商户号请参考：[mchid与appid申请](https://pay.weixin.qq.com/doc/v3/partner/4012081990.md)。 |
| sp\_appid | `sp_appid` 是服务商在微信[开放平台](https://open.weixin.qq.com/)（移动应用）或[公众平台](https://mp.weixin.qq.com/)（公众号/小程序）上申请的一个唯一标识。该 `sp_appid` 必须与服务商商户号 `sp_mchid` 进行绑定，因为使用微信支付功能会校验该参数。 | 超级管理员、技术负责人 | 服务商可登录[服务商平台](https://pay.weixin.qq.com/index.php/partner/public/home)，通过路径【产品中心 -\> APPID账号管理 -> 我关联的APPID账号】来查看所有绑定的APPID账号。若未绑定请超级管理员参考：[管理商户号绑定的APPID账号](https://pay.weixin.qq.com/doc/v3/partner/4016329059.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/partner/4012081990.md)。 |
| sub\_mchid | `sub_mchid` 是子商户（也叫特约商户）在服务商下的唯一身份标识。子商户进件有两种方式：<br>1、通过[服务商平台进件](https://kf.qq.com/faq/200114EZfmy62001142YVRzy.html)<br>2、通过[接口进件](https://pay.weixin.qq.com/doc/v3/partner/4012062365.md)<br>当子商户进件成功后，微信支付侧会向商户提供该子商户号。 | 超级管理员、技术负责人 | 子商户号查询有两种方式：<br>1、可登录[服务商平台](https://pay.weixin.qq.com/index.php/partner/public/home)，点击【合作伙伴功能-商户基础服务-开发参数配置】即可查看子商户号。<br>2、接口获取，服务商调用[查询申请单状态API](https://pay.weixin.qq.com/doc/v3/partner/4012691376.md)接口，会通过参数 `sub_mchid` 返回子商户号。 |
| sub\_appid | `sub_appid` 是子商户在微信[开放平台](https://open.weixin.qq.com/)（移动应用）或[公众平台](https://mp.weixin.qq.com/)（公众号/小程序）上申请的一个唯一标识。该 `sub_appid` 必须与子商户号 `sub_mchid` 进行绑定，因为使用微信支付功能会校验该参数。由服务商登录[服务商平台](https://pay.weixin.qq.com/index.php/partner/public/home)为子商户进行绑定，具体流程请参考[服务商为子商户配置AppID（即sub\_appid）](https://pay.weixin.qq.com/doc/v3/partner/4016329059.md#%E7%99%BB%E5%BD%95%E6%9C%8D%E5%8A%A1%E5%95%86%E5%B9%B3%E5%8F%B0%E4%B8%BA%E5%AD%90%E5%95%86%E6%88%B7%E5%8F%91%E8%B5%B7APPID%E7%9A%84%E6%8E%88%E6%9D%83%E7%BB%91%E5%AE%9A%E7%94%B3%E8%AF%B7%EF%BC%88%E5%8D%B3sub_appid%EF%BC%89)。 | 超级管理员、技术负责人 | sub\_appid查询有两种方式：<br>1、服务商可登录[服务商平台](https://pay.weixin.qq.com/index.php/partner/public/home)，通过路径【合作伙伴功能 -> 开发参数配置 -> 找到对应子商户号点击“开发配置” -\> 特约商户APPID配置】来查看所有服务商为子商户绑定的APPID。<br>2、子商户可登录[商户平台](https://pay.wechatpay.cn/)，通过路径【产品中心 -\> APPID账号配置 -> 服务商为我关联的APPID账号 】来查看所有服务商为子商户绑定的APPID。 |
| 服务商API证书 | 服务商发起APIv3接口请求时，需要使用服务商API证书私钥[对请求进行签名](https://pay.weixin.qq.com/doc/v3/partner/4012365862.md)。 | 超级管理员、技术负责人 | 首次获取请登录[微信服务商平台](https://pay.weixin.qq.com/index.php/partner/public/home)，参考[申请商户API证书流程](https://pay.weixin.qq.com/doc/v3/partner/4012081992.md)进行下载，下载后请妥善保管，该证书只能下载一次，若遗失或泄露，需在服务商平台重新申请下载。 |
| 服务商API证书序列号 | 调用APIv3接口时请求头中的必传参数( `serial_no`)，需要与生成签名值时使用的服务商API证书对应。 | 超级管理员、技术负责人 | 登录[微信服务商平台](https://pay.weixin.qq.com/index.php/partner/public/home)或通过证书解析工具可获取到服务商API证书序列号，详见：[查看商户API证书序列号指南](https://pay.weixin.qq.com/doc/v3/partner/4012081992.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/partner/4013059017.md)；<br>2、调用某些含有敏感信息参数(如姓名、身份证号码)的接口时，需要使用微信支付公钥[加密敏感信息](https://pay.weixin.qq.com/doc/v3/partner/4013059044.md)后再传输参数。 | 超级管理员、技术负责人 | 登录[微信服务商平台](https://pay.weixin.qq.com/index.php/partner/public/home)，参考[微信支付公钥获取指南](https://pay.weixin.qq.com/doc/v3/partner/4012925323.md)进行下载。 |
| 微信支付公钥id | 服务商会在以下两种场景中使用微信支付公钥id( `Wechatpay-Serial`)：<br>1、接收到APIv3接口的返回内容，请求头中会携带公钥id，服务商需使用对应的微信支付公钥进行[验签](https://pay.weixin.qq.com/doc/v3/partner/4013059017.md)；<br>2、当调用的接口带有使用微信支付公钥[加密的敏感信息](https://pay.weixin.qq.com/doc/v3/partner/4013059044.md)参数时，需在请求头中传公钥id参数。 | 超级管理员、技术负责人 | 登录[微信服务商平台](https://pay.weixin.qq.com/index.php/partner/public/home)，进入【账户中心 > 账户设置 \> API安全】目录，点击【管理公钥】即可查看到微信支付公钥id。 |
| APIv3密钥 | 开发者接入之前需要[设置APIv3密钥](https://kf.qq.com/faq/180830E36vyQ180830AZFZvu.html)，服务商会在以下两种场景中使用到APIv3密钥：<br>1、微信支付会使用APIv3密钥加密回调信息，然后将加密后的密文回调给服务商，服务商接收到APIv3回调通知的密文后，需使用该密钥进行[解密](https://pay.weixin.qq.com/doc/v3/partner/4012082320.md)。<br>2、在[下载平台证书](https://pay.weixin.qq.com/doc/v3/partner/4012715700.md)公钥时，需要使用该密钥进行解密。 | 超级管理员、技术负责人 | 首次设置请登录[微信服务商平台](https://pay.weixin.qq.com/index.php/partner/public/home)，参考[设置APIv3密钥流程](https://pay.weixin.qq.com/doc/v3/partner/4012081991.md#4%E3%80%81%E8%AE%BE%E7%BD%AEAPIv3%E5%AF%86%E9%92%A5)，<br>设置后无法在服务商平台查看，请服务商妥善保管，若遗失或泄露须重新设置。 |
| 微信支付平台证书<br>(推荐切换成微信支付公钥，平台证书需要每五年更换一次) | 微信支付平台证书的作用等同于微信支付公钥，主要用于APIv3接口的返回内容的[验签](https://pay.weixin.qq.com/doc/v3/partner/4013059030.md)和[敏感信息加密](https://pay.weixin.qq.com/doc/v3/partner/4013059053.md)参数。 | 开发人员通过调用接口下载 | 首次获取平台证书需通过Java命令行下载，后续则可以使用[微信支付平台证书下载](https://pay.weixin.qq.com/doc/v3/partner/4012715700.md)接口获取，详见：[平台证书简介及使用说明](https://pay.weixin.qq.com/doc/v3/partner/4012073044.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/partner/4012925289.md)。 |
| 平台证书序列号 | 服务商会在以下两种场景中使用平台证书序列号( `Wechatpay-Serial`)：<br>1、接收到APIv3接口的返回内容，请求头中会携带平台证书序列号，服务商需使用对应的平台证书进行[验签](https://pay.weixin.qq.com/doc/v3/partner/4013059030.md)；<br>2、当调用的接口带有使用平台证书[加密的敏感信息](https://pay.weixin.qq.com/doc/v3/partner/4013059053.md)参数时，需在请求头中传平台证书序列号参数。 | 开发人员通过调用接口获取 | 可通过以下三种方式查看平台证书序列号：<br>1、在调用接口[下载微信支付平台证书](https://pay.weixin.qq.com/doc/v3/partner/4012715700.md)时，接口会返回平台证书序列号( `serial_no`)参数。<br>2、可使用openssl命令行工具查看证书序列号，详见：[如何查看商户API证书或平台证书序列号](https://pay.weixin.qq.com/doc/v3/partner/4013059181.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) |