查询子商户管控情况

更新时间：2024.11.18

服务商查询子商户的管控情况。调用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

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--关闭支付分服务结单

可选取值

NO_TRANSACTION_AND_RECHARGE: 关闭收单和充值
NO_PAYMENT: 关闭付款
NO_WITHDRAWAL: 关闭提现
NO_REFUND: 关闭退款
NO_TRANSACTION: 关闭收单
NO_PROFIT_SHARING: 关闭分账分出
NO_PAYMENT_POINT_COMPLETE_ORDER: 关闭支付分服务结单

recovery_specifications 　选填 array[object]

【被管控原因及解脱路径列表】商户被管控的原因及对应解脱路径的列表

属性

limitation_reason 　选填 string(512)

【商户被管控原因描述】被管控的原因说明

recover_way 　选填 string(512)

【商户被该原因管控的解脱路径】商户解脱被该原因管控能力的途径

recover_help_url 　选填 string(1024)

【商户被该原因管控的解脱帮助链接】商户解脱被该原因管控能力的帮助说明URL

limitation_reason_type 　选填 string

【商户被管控原因类型】 LICENSE_ABNORMAL--经营证照异常
NO_TRADE--无交易
SETTLE_ACCOUNT_ABNORMAL--结算信息异常
RISK_ABNORMAL--风险异常
OTHER--其他

可选取值

LICENSE_ABNORMAL: 经营证照异常
NO_TRADE: 无交易
SETTLE_ACCOUNT_ABNORMAL: 结算信息异常
RISK_ABNORMAL: 风险异常
OTHER: 其他

relate_limitations 　选填 array[string]

【商户被该原因管控的能力列表】 NO_TRANSACTION_AND_RECHARGE--关闭收单和充值
NO_PAYMENT--关闭付款
NO_WITHDRAWAL--关闭提现
NO_REFUND--关闭退款
NO_TRANSACTION--关闭收单
NO_PROFIT_SHARING--关闭分账分出
NO_PAYMENT_POINT_COMPLETE_ORDER--关闭支付分服务结单

可选取值

NO_TRANSACTION_AND_RECHARGE: 关闭收单和充值
NO_PAYMENT: 关闭付款
NO_WITHDRAWAL: 关闭提现
NO_REFUND: 关闭退款
NO_TRANSACTION: 关闭收单
NO_PROFIT_SHARING: 关闭分账分出
NO_PAYMENT_POINT_COMPLETE_ORDER: 关闭支付分服务结单

other_relate_limitations 　选填 string

【商户被该原因管控的其他能力描述】除了被该原因管控的能力列表中列举的能力外，其他被该原因管控的能力描述，英文逗号分隔

other_limited_functions 　选填 string

【商户其他被管控能力描述】除了被管控能力列表中列举的能力外，其他被管控的能力描述，英文逗号分隔

应答示例

200 OK

1{
2  "mchid" : "123000110",
3  "limited_functions" : [
4    "NO_TRANSACTION_AND_RECHARGE"
5  ],
6  "recovery_specifications" : [
7    {
8      "limitation_reason" : "经营证照异常",
9      "recover_way" : "修改主体资料",
10      "recover_help_url" : "https://kf.qq.com",
11      "limitation_reason_type" : "LICENSE_ABNORMAL",
12      "relate_limitations" : [
13        "NO_TRANSACTION_AND_RECHARGE"
14      ],
15      "other_relate_limitations" : "关闭相册扫码支付,关闭长按识别支付"
16    }
17  ],
18  "other_limited_functions" : "关闭相册扫码支付,关闭长按识别支付"
19}
20

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	当前服务商与查询的商户号不存在受理关系	请传入存在受理关系的子商户号
400	INVALID_REQUEST	身份校验不通过	请使用普通服务商发起请求
429	RATELIMIT_EXCEEDED	请求过于频繁，请稍后再试	请降低请求的频率

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服