---
url: "https://pay.weixin.qq.com/doc/v3/partner/4015981654.md"
title: "品牌经营API开发必要参数说明"
doc_id: 4015981654
---

>更新时间：2025.12.15

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

| 参数名 | 用途 | 获取角色 | 获取方式 |
| --- | --- | --- | --- |
| mchid | `mchid` 是服务商在微信支付侧的唯一身份标识，所有接口调用都必须包含此参数，以便微信支付确认商户的身份。当[入驻](https://kf.qq.com/faq/161220iqeAfA1612202yeURB.html)审核成功后，微信支付侧会向商户提供该商户号。 | 超级管理员、技术负责人 | 登录[服务商平台](https://pay.weixin.qq.com/index.php/partner/public/home)，点击【账户中心->个人设置->个人信息】即可查看服务商商户号。 |
| appid | `appid` 是服务商在微信[开放平台](https://open.weixin.qq.com/)（移动应用）或[公众平台](https://mp.weixin.qq.com/)（公众号/小程序）上申请的一个唯一标识。该 `appid` 必须与服务商商户号 `mchid` 进行绑定，因为使用微信支付功能会校验该参数。 | 超级管理员、技术负责人 | 服务商可登录[服务商平台](https://pay.weixin.qq.com/index.php/partner/public/home)，通过路径【产品中心 -\> APPID账号管理 -> 我关联的APPID账号】来查看所有绑定的APPID账号。若未绑定请超级管理员参考：[服务商商户号与AppID账号关联管理](https://kf.qq.com/faq/200520fueQrI200520aQf6Rr.html)。 |
| brand\_id | `brand_id`(品牌ID)品牌方在[品牌经营平台](https://pay.weixin.qq.com/xdc/brandhomeweb/brand/home#/)申请的唯一身份标识，微信支付通过品牌ID确认品牌身份，该品牌应与服务商存在授权关系。 | 超级管理员 | [服务商申请品牌授权](https://pay.weixin.qq.com/doc/v3/partner/4016026183.md)成功后，可登录[合作伙伴平台](https://pay.weixin.qq.com/index.php/partner/public/home)，在“品牌经营中心-合作品牌管理”页面查看已授权的brand\_id。 |
| 服务商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/4013058924.md#%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)，<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)，查看证书内容、 |