---
url: "https://pay.weixin.qq.com/doc/v3/partner/4012803072.md"
title: "查询子商户管控情况 "
doc_id: 4012803072
---

>更新时间：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 使用该域名将访问异地的接入点，指引[点击查看](https://pay.weixin.qq.com/doc/v3/merchant/4012075113.md)

## 请求参数

### Header 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| Authorization | string | true | 请参考 [签名认证](https://pay.weixin.qq.com/doc/v3/merchant/4012365342.md#%E8%AF%B7%E6%B1%82%E6%8E%A5%E5%8F%A3%E5%90%8E%E7%AB%AF%E7%AD%BE%E5%90%8D) 生成认证信息 |
| Accept | string | true | 请设置为 `application/json` |
### Path 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| sub_mchid | string(32) | true | 【子商户号】 子商户的商户号 |
## 应答参数

200 OK

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| mchid | string | true | 【子商户的商户号】 子商户的商户号 |
| limited_functions | array[string] | false | 【商户被管控能力列表】 商户以下能力被管控时会返回<br>可选取值<br><ul><li>`NO_TRANSACTION_AND_RECHARGE`:  关闭收单和充值</li><li>`NO_PAYMENT`:  关闭付款</li><li>`NO_WITHDRAWAL`:  关闭提现</li><li>`NO_REFUND`:  关闭退款</li><li>`NO_TRANSACTION`:  关闭收单</li><li>`NO_PROFIT_SHARING`:  关闭分账分出</li><li>`NO_PAYMENT_POINT_COMPLETE_ORDER`:  关闭支付分服务结单</li></ul> |
| other_limited_functions | string | false | 【商户其他被管控能力描述】 若商户除了被管控能力列表中列举的能力外还有其它能力被管控则返回给商户（如有多项以英文逗号分隔） |
| recovery_specifications | array[object] | false | 【被管控原因及解脱路径列表】 商户被管控的原因及对应解脱路径的列表，若商户被管控时会返回 |
| recovery_specifications.limitation_case_id | string | false | 【商户被该原因管控的单据号】 唯一标记本次管控动作的ID，可用来和“管控流水订阅通知”中的“业务单号”做关联 |
| recovery_specifications.limitation_reason_type | string | false | 【商户被管控原因类型】 若商户被管控时会返回<br>可选取值<br><ul><li>`LICENSE_ABNORMAL`:  经营证照异常</li><li>`NO_TRADE`:  无交易</li><li>`SETTLE_ACCOUNT_ABNORMAL`:  结算信息异常</li><li>`RISK_ABNORMAL`:  风险异常</li><li>`OTHER`:  其他</li><li>`INSPECT_ABNORMAL`:  巡检异常</li><li>`INVALID_REPRESENTATIVE_INFORMATION`:  法定代表人/负责人资料异常</li><li>`INVALID_BUSINESS_STATUS`:  经营状态异常</li><li>`INVALID_BUSINESS_LICENSE`:  经营证照资料异常</li><li>`INVALID_BENEFICIARY_INFORMATION`:  受益所有人资料异常</li></ul> |
| recovery_specifications.limitation_reason | string(512) | false | 【商户被管控原因】 被管控的原因，若商户被管控时会返回 |
| recovery_specifications.limitation_reason_describe | string | false | 【商户被管控原因描述】 在该原因下，被管控的原因描述，若商户被管控时会返回 |
| recovery_specifications.relate_limitations | array[string] | false | 【商户被该原因管控的能力列表】 在该原因下，若商户以下能力被管控时会返回<br>可选取值<br><ul><li>`NO_TRANSACTION_AND_RECHARGE`:  关闭收单和充值</li><li>`NO_PAYMENT`:  关闭付款</li><li>`NO_WITHDRAWAL`:  关闭提现</li><li>`NO_REFUND`:  关闭退款</li><li>`NO_TRANSACTION`:  关闭收单</li><li>`NO_PROFIT_SHARING`:  关闭分账分出</li><li>`NO_PAYMENT_POINT_COMPLETE_ORDER`:  关闭支付分服务结单</li></ul> |
| recovery_specifications.other_relate_limitations | string | false | 【商户被该原因管控的其他能力描述】 在该原因下，若商户除了relate\_limitations所罗列的被管控能力，还有其他被管控的能力时会返回（如有多项以英文逗号分隔） |
| recovery_specifications.recover_way | string | false | 【商户被该原因管控的解脱路径】 在该原因下，若存在解脱路径时会返回<br>可选取值<br><ul><li>`IRRECOVERABLE`:  不可恢复</li><li>`MODIFY_SUBJECT_INFORMATION`:  修改主体资料</li><li>`MODIFY_SETTLE_ACCOUNT_INFORMATION`:  修改结算银行账户</li><li>`VERIFY_INACTIVE_MERCHANT_IDENTITY`:  核实商户身份</li><li>`SUBMIT_OFFLINE_BUSINESS_SCENARIO_INFORMATION`:  提交线下经营场景信息</li><li>`SUBMIT_INFORMATION_FOR_APPEAL`:  提交相关信息申诉</li><li>`RESOLVE_TRANSACTION_DISPUTES`:  解决交易纠纷</li><li>`MODIFY_ADMINISTRATOR_INFORMATION`:  修改超级管理员</li><li>`CALL_CUSTOMER_SERVICE_AT_95017`:  拨打微信支付客服电话95017</li><li>`UPDATE_BUSINESS_SCENARIO_INFORMATION`:  补充经营场景信息</li><li>`SUBMIT_CDD_INFORMATION`:  填写尽调信息</li><li>`WAITING_FOR_PLATFORM_REVIEW`:  等待平台审核</li><li>`SUBMIT_UBO_INFORMATION`:  补充受益所有人信息</li><li>`SIGN_ANTI_FRAUD_PLEDGE_AND_VERIFY_FACE`:  签署反诈承诺书并刷脸核实身份</li><li>`CONTACT_APPROPRIATE_AUTHORITY_FOR_CONSULTATION`:  联系有权机关咨询</li><li>`MODIFY_ABBREVIATION_INFORMATION`:  修改商户简称</li><li>`CONFIRM_BUSINESS_TYPE`:  确认经营类型</li><li>`SUBMIT_ONLINE_BUSINESS_SCENARIO_INFORMATION`:  提交线上经营场景信息</li></ul> |
| recovery_specifications.recover_way_param | string(1024) | false | 【商户被该原因管控的解脱路径参数】 若解脱路径recover\_way为“填写尽调信息”、“补充受益所有人信息”，需通过提交尽调来解脱，此处会返回“尽调单号”；若解脱路径recover\_way为“提交相关信息申诉”，需通过提交资料来解脱，此处会返回“商户管理记录单号”；若解脱路径recover\_way为“联系有权机关咨询”，此处会返回有权机关信息；若解脱路径recover\_way为“确认经营类型”，此处会返回“经营类型确认单号” |
| recovery_specifications.recover_help_url | string(1024) | false | 【商户被该原因管控的解脱帮助链接】 在该原因下，若存在解脱帮助说明时会返回 |
| recovery_specifications.limitation_action_type | string | false | 【处置方式】 管控处置方式类型，默认是立即管控<br>可选取值<br><ul><li>`LIMIT_ACTION_TYPE_IMMEDIATE_CONTROL`:  立即管控</li><li>`LIMIT_ACTION_TYPE_DELAY_CONTROL`:  延迟管控</li></ul> |
| recovery_specifications.limitation_start_date | string(64) | false | 【预计管控开始时间】 当且仅当处置方式为延迟管控时返回，遵循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秒。 |
| recovery_specifications.limitation_date | string(64) | false | 【商户被该原因管控的时间】 若商户被管控时会返回，延迟管控但是未到管控时间时不会返回，遵循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秒。 |
## 错误码

以下是本接口返回的错误码列表。详细错误码规则，请参考[微信支付接口规则-错误码和错误提示](https://pay.weixin.qq.com/doc/v3/partner/4012081726.md#%E9%94%99%E8%AF%AF%E7%A0%81%E5%92%8C%E9%94%99%E8%AF%AF%E6%8F%90%E7%A4%BA)

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | PARAM\_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
| 400 | INVALID\_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 [接口规则](https://pay.weixin.qq.com/doc/v3/merchant/4012081709.md) |
| 401 | SIGN\_ERROR | 验证不通过 | 请参阅 [签名常见问题](https://pay.weixin.qq.com/doc/v3/merchant/4012072670.md) |
| 500 | SYSTEM\_ERROR | 系统异常，请稍后重试 | 请稍后重试 |
| 400 | INVALID\_REQUEST | 当前服务商与查询的商户号不存在受理关系 | 请传入存在受理关系的子商户号 |
| 400 | INVALID\_REQUEST | 身份校验不通过 | 请使用普通服务商发起请求 |
| 429 | RATELIMIT\_EXCEEDED | 请求过于频繁，请稍后再试 | 请降低请求的频率 |

请求示例

- [curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4012803072-curl.md)
- [Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4012803072-java.md)
- [Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4012803072-go.md)


应答示例

> 200 OK

```
{
  "mchid" : "123000110",
  "limited_functions" : [
    "NO_TRANSACTION_AND_RECHARGE"
  ],
  "other_limited_functions" : "关闭相册扫码支付,关闭长按识别支付",
  "recovery_specifications" : [
    {
      "limitation_case_id" : "A20250819155047774441874",
      "limitation_reason_type" : "LICENSE_ABNORMAL",
      "limitation_reason" : "入驻后180天无账户动账",
      "limitation_reason_describe" : "当前商户号入驻后长时间无账户动账，请重新确认开户意愿并核实身份",
      "relate_limitations" : [
        "NO_TRANSACTION_AND_RECHARGE"
      ],
      "other_relate_limitations" : "关闭相册扫码支付,关闭长按识别支付",
      "recover_way" : "MODIFY_SUBJECT_INFORMATION",
      "recover_way_param" : "100200300112233",
      "recover_help_url" : "https://kf.qq.com",
      "limitation_action_type" : "LIMIT_ACTION_TYPE_IMMEDIATE_CONTROL",
      "limitation_start_date" : "2025-06-08T10:34:56+08:00",
      "limitation_date" : "2025-06-08T10:34:56+08:00"
    }
  ]
}

```
