查询子商户管控情况

更新时间:2025.09.26

服务商查询子商户的管控情况。调用API必须经过商户API验签、签名

接口说明

支持商户:【普通服务商】

请求方式:【GET】/v3/mch-operation-manage/merchant-limitations/sub-mchid/{sub_mchid}

请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

请求参数

Header  HTTP头参数

 Authorization  必填 string

请参考签名认证生成认证信息


 Accept  必填 string

请设置为application/json


path  路径参数

 sub_mchid  必填   string(32)

【子商户号】 子商户的商户号

请求示例

curl
Java
Go

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/mch-operation-manage/merchant-limitations/sub-mchid/123000110 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数
折叠全部参数

200 OK

 mchid  必填   string

【子商户的商户号】 子商户的商户号


 limited_functions  选填   array[string]

【商户被管控能力列表】 商户以下能力被管控时会返回

可选取值

  • NO_TRANSACTION_AND_RECHARGE:  关闭收单和充值

  • NO_PAYMENT:  关闭付款

  • NO_WITHDRAWAL:  关闭提现

  • NO_REFUND:  关闭退款

  • NO_TRANSACTION:  关闭收单

  • NO_PROFIT_SHARING:  关闭分账分出

  • NO_PAYMENT_POINT_COMPLETE_ORDER:  关闭支付分服务结单


 other_limited_functions  选填   string

【商户其他被管控能力描述】 若商户除了被管控能力列表中列举的能力外还有其它能力被管控则返回给商户(如有多项以英文逗号分隔)


 recovery_specifications  选填   array[object]

【被管控原因及解脱路径列表】 商户被管控的原因及对应解脱路径的列表,若商户被管控时会返回

属性

 limitation_case_id  选填   string

【商户被该原因管控的单据号】 唯一标记本次管控动作的ID,可用来和“管控流水订阅通知”中的“业务单号”做关联


 limitation_reason_type  选填   string

【商户被管控原因类型】 若商户被管控时会返回

可选取值

  • LICENSE_ABNORMAL:  经营证照异常

  • NO_TRADE:  无交易

  • SETTLE_ACCOUNT_ABNORMAL:  结算信息异常

  • RISK_ABNORMAL:  风险异常

  • OTHER:  其他

  • INSPECT_ABNORMAL:  巡检异常

  • INVALID_REPRESENTATIVE_INFORMATION:  法定代表人/负责人资料异常

  • INVALID_BUSINESS_STATUS:  经营状态异常

  • INVALID_BUSINESS_LICENSE:  经营证照资料异常

  • INVALID_BENEFICIARY_INFORMATION:  受益所有人资料异常


 limitation_reason  选填   string(512)

【商户被管控原因】 被管控的原因,若商户被管控时会返回


 limitation_reason_describe  选填   string

【商户被管控原因描述】 在该原因下,被管控的原因描述,若商户被管控时会返回


 relate_limitations  选填   array[string]

【商户被该原因管控的能力列表】 在该原因下,若商户以下能力被管控时会返回

可选取值

  • NO_TRANSACTION_AND_RECHARGE:  关闭收单和充值

  • NO_PAYMENT:  关闭付款

  • NO_WITHDRAWAL:  关闭提现

  • NO_REFUND:  关闭退款

  • NO_TRANSACTION:  关闭收单

  • NO_PROFIT_SHARING:  关闭分账分出

  • NO_PAYMENT_POINT_COMPLETE_ORDER:  关闭支付分服务结单


 other_relate_limitations  选填   string

【商户被该原因管控的其他能力描述】 在该原因下,若商户除了relate_limitations所罗列的被管控能力,还有其他被管控的能力时会返回(如有多项以英文逗号分隔)


 recover_way  选填   string

【商户被该原因管控的解脱路径】 在该原因下,若存在解脱路径时会返回

可选取值

  • IRRECOVERABLE:  不可恢复

  • MODIFY_SUBJECT_INFORMATION:  修改主体资料

  • MODIFY_SETTLE_ACCOUNT_INFORMATION:  修改结算银行账户

  • VERIFY_INACTIVE_MERCHANT_IDENTITY:  核实商户身份

  • SUBMIT_OFFLINE_BUSINESS_SCENARIO_INFORMATION:  提交线下经营场景信息

  • SUBMIT_INFORMATION_FOR_APPEAL:  提交相关信息申诉

  • RESOLVE_TRANSACTION_DISPUTES:  解决交易纠纷

  • MODIFY_ADMINISTRATOR_INFORMATION:  修改超级管理员

  • CALL_CUSTOMER_SERVICE_AT_95017:  拨打微信支付客服电话95017

  • UPDATE_BUSINESS_SCENARIO_INFORMATION:  更新经营场景信息

  • SUBMIT_CDD_INFORMATION:  填写尽调信息

  • WAITING_FOR_PLATFORM_REVIEW:  等待平台审核

  • SUBMIT_UBO_INFORMATION:  补充受益所有人信息

  • SIGN_ANTI_FRAUD_PLEDGE_AND_VERIFY_FACE:  签署反诈承诺书并刷脸核实身份

  • CONTACT_APPROPRIATE_AUTHORITY_FOR_CONSULTATION:  联系有权机关咨询

  • MODIFY_ABBREVIATION_INFORMATION:  修改商户简称


 recover_way_param  选填   string(1024)

【商户被该原因管控的解脱路径参数】 若解脱路径recover_way为“填写尽调信息”、“补充受益所有人信息”,需通过提交尽调来解脱,此处会返回“尽调单号”;若解脱路径recover_way为“提交相关信息申诉”,需通过提交资料来解脱,此处会返回“商户管理记录单号”;若解脱路径recover_way为“联系有权机关咨询”,此处会返回有权机关信息


 recover_help_url  选填   string(1024)

【商户被该原因管控的解脱帮助链接】 在该原因下,若存在解脱帮助说明时会返回


 limitation_action_type  选填   string

【处置方式】 管控处置方式类型,默认是立即管控

可选取值

  • LIMIT_ACTION_TYPE_IMMEDIATE_CONTROL:  立即管控

  • LIMIT_ACTION_TYPE_DELAY_CONTROL:  延迟管控


 limitation_start_date  选填   string(64)

【预计管控开始时间】 当且仅当处置方式为延迟管控时返回,遵循rfc3339标准格式,格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE,YYYY-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss表示时分秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35+08:00表示,北京时间2015年5月20日13点29分35秒。


 limitation_date  选填   string(64)

【商户被该原因管控的时间】 若商户被管控时会返回,延迟管控但是未到管控时间时不会返回,遵循rfc3339标准格式,格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE,YYYY-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss表示时分秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35+08:00表示,北京时间2015年5月20日13点29分35秒。

应答示例

200 OK

1{
2  "mchid" : "123000110",
3  "limited_functions" : [
4    "NO_TRANSACTION_AND_RECHARGE"
5  ],
6  "other_limited_functions" : "关闭相册扫码支付,关闭长按识别支付",
7  "recovery_specifications" : [
8    {
9      "limitation_case_id" : "A20250819155047774441874",
10      "limitation_reason_type" : "LICENSE_ABNORMAL",
11      "limitation_reason" : "入驻后180天无账户动账",
12      "limitation_reason_describe" : "当前商户号入驻后长时间无账户动账,请重新确认开户意愿并核实身份",
13      "relate_limitations" : [
14        "NO_TRANSACTION_AND_RECHARGE"
15      ],
16      "other_relate_limitations" : "关闭相册扫码支付,关闭长按识别支付",
17      "recover_way" : "MODIFY_SUBJECT_INFORMATION",
18      "recover_way_param" : "100200300112233",
19      "recover_help_url" : "https://kf.qq.com",
20      "limitation_action_type" : "LIMIT_ACTION_TYPE_IMMEDIATE_CONTROL",
21      "limitation_start_date" : "2025-06-08T10:34:56+08:00",
22      "limitation_date" : "2025-06-08T10:34:56+08:00"
23    }
24  ]
25}
26

 

错误码

以下是本接口返回的错误码列表。详细错误码规则,请参考微信支付接口规则-错误码和错误提示

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

400

INVALID_REQUEST

当前服务商与查询的商户号不存在受理关系

请传入存在受理关系的子商户号

400

INVALID_REQUEST

身份校验不通过

请使用普通服务商发起请求

429

RATELIMIT_EXCEEDED

请求过于频繁,请稍后再试

请降低请求的频率

 

元宝AI
反馈
目录
置顶