开发必要参数说明

更新时间:2025.08.20

品牌经营平台模式开发前需要先准备以下开发必要参数:

参数名

用途

获取角色

获取方式

brand_id

brand_id(品牌ID)在品牌经营平台申请的唯一身份标识,所有接口在调用时都必须传品牌ID,微信支付通过品牌ID确认品牌身份。

管理员

可参考brand_id申请文档中 brand_id 获取方式。

品牌API证书

品牌商户发起品牌API接口请求时,需要使用品牌API证书私钥对请求进行签名

管理员、技术负责人

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

品牌API证书序列号

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

管理员、技术负责人

登录品牌经营平台或通过证书解析工具可获取到品牌API证书序列号,详见:查看品牌API证书序列号指南

微信支付公钥

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

1、接收到品牌API接口的返回内容,需要使用微信支付公钥进行验签

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

管理员、技术负责人

登录品牌经营平台,参考微信支付公钥获取指南进行下载。

 

微信支付公钥ID

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

1、接收到接口的返回内容,请求头中会携带公钥ID,品牌商户需使用对应的微信支付公钥进行验签

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

管理员、技术负责人

登录品牌经营平台,【账号管理 > 安全中心】目录,点击【管理公钥】即可查看到微信支付公钥ID。

品牌API密钥

微信支付会使用品牌API密钥加密回调信息,然后将加密后的密文回调给品牌商户,品牌商户接收到回调通知的密文后,需使用该密钥进行解密

 

管理员、技术负责人

首次设置请登录品牌经营平台,参考设置品牌API密钥流程

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

 

元宝AI
反馈
目录
置顶