服务商特约商户关注功能配置API

应用场景

服务商给特约子商户配置推荐关注的功能;

注意:API只支持新增配置,配置后隔30天才能重新修改,所以配置前请确认appid是否正确。

接口链接

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 该字段视支付接口中是否传sub_appid而定,如果没有填sub_appid,此处请填值NULL,否则请填写绑定特约商户或渠道公众号、小程序、APP支付等对应的APPID
推荐关注APPID subscribe_appid String(32) wx931386123456789e 特约商户或渠道的公众号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发生错误, 请检查修改后重试