开发必要参数说明

更新时间:2024.11.29

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

参数名

用途和获取说明

sp_mchid

sp_mchid是服务商在微信支付侧的唯一身份标识,所有接口调用都必须包含此参数,以便微信支付确认商户的身份。入驻审核成功后,微信支付侧会向商户提供该商户号。开发者需与负责申请商户号的同事联系获取,具体操作如下:登录服务商平台点击【账户中心->个人设置-->个人信息】即可查看服务商商户号。

sp_appid

sp_appid是服务商在微信开放平台(移动应用)或公众平台(公众号/小程序)上申请的一个唯一标识。该sp_appid必须与服务商商户号sp_mchid进行绑定,因为使用微信支付功能会校验该参数。具体流程请参考服务商商户号与AppID账号关联管理

sub_mchid

sub_mchid是子商户(也叫特约商户)在服务商下的唯一身份标识。子商户进件有两种方式:

1、通过服务商平台进件

2、通过接口进件

当子商户进件成功后,微信支付侧会向商户提供该子商户号。子商户号查询有两种方式:

1、服务商平台获取,服务商可登录服务商平台点击【合作伙伴功能-商户基础服务-开发参数配置】即可查看子商户号。

2、接口获取,服务商调用查询申请单状态API接口,会通过参数sub_mchid返回子商户号。

sub_appid

sub_appid是子商户在微信开放平台(移动应用)或公众平台(公众号/小程序)上申请的一个唯一标识。该sub_appid必须与子商户号sub_mchid进行绑定,因为使用微信支付功能会校验该参数。由服务商登录服务商平台为子商户进行绑定,具体流程请参考服务商为子商户配置AppID(即sub_appid)

服务商的APIV3秘钥

微信支付会在以下两种场景中使用APIV3秘钥,因此开发者接入之前需要设置APIv3密钥

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

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

服务商的API证书

服务商发起APIv3接口请求时,需要使用该证书私钥生成请求签名,详见商户API证书获取方法及功能介绍

服务商的平台证书

服务商接收到APIV3接口的返回内容,需要使用该证书公钥进行验签,另外某些敏感信息参数(如姓名、身份证号码)也需要使用该证书公钥加密后传输,详见微信支付平台证书

服务商的微信支付公钥

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

新接入的服务商建议都使用微信支付公钥,详见:微信支付公钥使用介绍;存量使用微信支付平台证书的服务商,可参考指引切换:平台证书切换微信支付公钥指引

 

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