关注配置
更新时间：2025.04.07应用场景
服务商给小微商户配置推荐关注的功能；
注意：API只支持新增配置，配置后隔30天才能重新修改，所以配置前请确认appid是否正确。
接口链接
URL地址: https://api.mch.weixin.qq.com/secapi/mkt/addrecommendconf
是否需要证书
是
请求参数
名称 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
商户号 | 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 |
支付凭证推荐小程序appid | receipt_appid | String(32) | wx931386123456789e | 需为通过微信认证的小程序appid，且认证主体与服务商主体一致 | |
随机字符串 | nonce_str | 是 | String(32) | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | 随机字符串，不长于32位。推荐随机数生成算法 |
签名 | sign | 是 | String(64) | C380BEC2BFD727A4B6845133519F3AD6C380BEC2BFD727A4B6845133519F3AD6 | 签名，详见签名生成算法 |
签名算法类型 | sign_type | 是 | String(32) | HMAC-SHA256 | 暂只支持HMAC-SHA256算法。该字段需参与签名sign的计算。 |
返回结果
名称 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
返回状态码 | 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(64) | 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编码，请检查后重试 | |
PARAM_ERROR | 长度限制 | XXX填写有误，请检查后重新提交 | 人工检查过滤 |
PARAM_ERROR | 正则校验 | XXX内容格式有误，请检查后重试 |
|
INVALID_REQUEST | 录入权限 | 暂无权限，请检查后重试 | 检查权限 |
INVALID_REQUEST | 需要证书 | 获取客户端证书序列号失败 | 检查证书 |
INVALID_REQUEST | 校验公众号和服务商关系 | appid与mchid无绑定关系，请检查修改后重试 | 检查输入参数 |
INVALID_REQUEST | 校验服务商和子商户关系 | 子商户号信息有误, 请检查修改后重试 |
|
INVALID_REQUEST | 校验公众号是否合法 | 校验appid发生错误, 请检查修改后重试 |
|
