开发必要参数说明

更新时间:2025.06.27

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

参数名

用途

获取角色

获取方式

mchid

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

超级管理员、技术负责人

登录微信商户平台点击【账户中心->商户信息】即可查看商户号。

appid

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

超级管理员、技术负责人

登录微信商户平台,可查看商户号已绑定的appid,若未绑定请超级管理员参考:商户号绑定appid指南

商户API证书

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

超级管理员、技术负责人

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

商户API证书序列号

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

超级管理员、技术负责人

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

微信支付公钥
(推荐使用,公钥长期有效,管理简单)

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

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

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

超级管理员、技术负责人

登录微信商户平台,参考微信支付公钥获取指南进行下载。

 

微信支付公钥id

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

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

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

超级管理员、技术负责人

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

APIv3密钥

微信支付会在以下两种场景中使用APIv3密钥:

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

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

超级管理员、技术负责人

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

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

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

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

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

平台证书只能通过调用接口下载,详见:微信支付平台证书介绍与获取方法

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

平台证书序列号

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

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

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

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

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

 

更多技术问题
技术咨询
反馈
咨询
目录
置顶