查询子商户管控情况
更新时间: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)
【子商户号】 子商户的商户号
请求示例
GET
应答参数
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 【商户被管控原因类型】 若商户被管控时会返回 可选取值
limitation_reason 选填 string(512) 【商户被管控原因】 被管控的原因,若商户被管控时会返回 limitation_reason_describe 选填 string 【商户被管控原因描述】 在该原因下,被管控的原因描述,若商户被管控时会返回 relate_limitations 选填 array[string] 【商户被该原因管控的能力列表】 在该原因下,若商户以下能力被管控时会返回 可选取值
other_relate_limitations 选填 string 【商户被该原因管控的其他能力描述】 在该原因下,若商户除了relate_limitations所罗列的被管控能力,还有其他被管控的能力时会返回(如有多项以英文逗号分隔) recover_way 选填 string 【商户被该原因管控的解脱路径】 在该原因下,若存在解脱路径时会返回 可选取值
recover_way_param 选填 string(1024) 【商户被该原因管控的解脱路径参数】 若解脱路径recover_way为“填写尽调信息”、“补充受益所有人信息”,需通过提交尽调来解脱,此处会返回“尽调单号”;若解脱路径recover_way为“提交相关信息申诉”,需通过提交资料来解脱,此处会返回“商户管理记录单号”;若解脱路径recover_way为“联系有权机关咨询”,此处会返回有权机关信息 recover_help_url 选填 string(1024) 【商户被该原因管控的解脱帮助链接】 在该原因下,若存在解脱帮助说明时会返回 limitation_action_type 选填 string 【处置方式】 管控处置方式类型,默认是立即管控 可选取值
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
错误码
以下是本接口返回的错误码列表。详细错误码规则,请参考微信支付接口规则-错误码和错误提示

