小微商户新增对应APPID关联API

应用场景

服务商给小微商户配置绑定关系;

注意:
API只支持新增配置,不支持修改, 如服务商需要修改请先登录微信服务商后台手工删除后重新配置。
可以绑定服务商公司名字相同的公众号、小程序、开放平台应用的APPID; 如果提交绑定了subappid,支付接口就一定要传;

接口链接

URL地址: https://api.mch.weixin.qq.com/secapi/mch/addsubdevconfig

是否需要证书

请求参数

名称 变量名 必填 类型 示例值 描述
公众帐号ID appid String(32) wx931386123456789e 服务商的公众账号 ID
商户号 mch_id String(32) 1451234567 服务商的商户号
小微商户号 sub_mch_id String(32) 10000101 服务商报备的小微商户识别码
关联APPID sub_appid String(32) wx931386123456789e 绑定服务商道公众号、小程序、APP支付等对应的APPID
签名 sign String(32) C380BEC2BFD727A4B6845133519F3AD6 签名,详见签名生成算法

返回结果

名称 变量名 必填 类型 示例值 描述
返回状态码 return_code String(16) SUCCESS SUCCESS/FAIL 此字段是通信标识,非交易标识,交易是否成功需要查看result_code来判断
返回信息 return_msg String(128) 签名失败 返回信息,如非空,为错误原因 签名失败 参数格式校验错误
以下字段在return_code为SUCCESS的时候有返回
名称 变量名 必填 类型 示例值 描述
业务结果 result_code String(32) FAIL SUCCESS/FAIL
签名 sign String(32) C380BEC2BFD727A4B6845133519F3AD6 微信返回的签名,银行服务商需验证签名,详见签名生成算法
错误代码 err_code String(32) INVALID_REQUEST  
错误代码描述 err_code_des String(128) 子商户号信息有误,请检查修改后重试 结果信息描述

错误列表:

错误码 名称 描述 解决方案
INVALID_REQUEST 不支持http get方法 请使用post方法,请检查后重新提交 开发联调解决
INVALID_REQUEST Xml格式错误 输入xml参数格式错误,请检查后重新提交
SIGNERROR 验签 签名校验失败,请检查后重试
INVALID_REQUEST 使用utf-8编码格式 XXX未使用UTF-8编码,请检查后重试 
例如:公众号支付域名未使用UTF-8编码,请检查后重试
PARAM_ERROR 长度限制 XXX填写有误,请检查后重新提交 人工检查过滤
PARAM_ERROR 正则校验 XXX内容格式有误,请检查后重试  
INVALID_REQUEST 录入权限 暂无权限,请检查后重试 检查权限
INVALID_REQUEST 需要证书 获取客户端证书序列号失败 
获取客户端证书特征名称(DN)域失败 
证书校验失败,请检查后重试
检查证书
INVALID_REQUEST 校验公众号和服务商关系 appid与mchid无绑定关系,请检查修改后重试 检查输入参数
INVALID_REQUEST 校验服务商和子商户关系 子商户号信息有误, 请检查修改后重试  
INVALID_REQUEST 校验公众号是否合法 校验appid发生错误, 请检查修改后重试