支付产品
- 付款码支付
- Native支付
- JSAPI支付
- APP支付
- 小程序支付
- H5支付
- 委托代扣
资金类产品
- 分账（发起交易）
- 分账（操作分账）
- 分账（发起退款）
- 分账（账单及资金查询）
其他产品

查询子商户H5支付权限状态

更新时间：2025.01.07

商户可以通过该接口查询子商户的H5支付权限状态。

注意：

因产品迭代，H5支付权限可使用子商户进件接口申请。

详情查看：

子商户进件（产品介绍）
子商户进件（接入前准备）
子商户进件（开发指引）
子商户进件（API列表）

1. 接口说明

适用对象：机构模式

请求URL：https://apihk.mch.weixin.qq.com/v3/global/merchant/h5/permission/{sub_mchid}

请求方式：GET

Path 指该参数为路径参数

Query 指该参数为URL参数

Body 指该参数需在请求JSON传参

2. 请求参数

参数名	变量	类型[长度限制]	必填	描述
子商户号	sub_mchid	string[1, 32]	是	Path 当前机构/服务商下的子商户号注意：仅适用于机构模式示例值：2491935631

请求示例

URL

1https://api.mch.weixin.qq.com/v3/global/merchant/h5/permission/2491935631

3. 返回参数

正常返回

参数名	变量	类型[长度限制]	必填	描述
子商户号	sub_mchid	string[1, 32]	是	当前机构/服务商下的子商户号注意：仅适用于机构模式示例值：2491935631
H5支付权限状态	authorization_state	string	是	子商户的H5支付权限状态 AUTHORITY_TO_TEST：超低限额支付权限 50000 CNY/day/person & 500000 CNY/day/sub-merchant FORMAL_AUTHORITY：普通限额支付权限 AUTHORIZED：无限额支付权限 UNDER_PUNISHMENT：商户处于处罚状态 UNAUTHORIZED：未授权示例值：AUTHORITY_TO_TEST

异常返回

参数名

变量

类型[长度限制]

必填

描述

返回状态码

code

string[1, 32]

是

错误码，枚举值见错误码列表

示例值：INVALID_REQUEST

返回信息

message

string[1, 256]

是

返回信息，如非空，为错误原因

示例值：参数格式校验错误

详细的错误描述

detail

object

否

当code为PARAM_ERROR时返回，详细说明见下

详细的错误描述

返回示例

正常示例

1{
2  "authorization_state": "AUTHORITY_TO_TEST",
3  "sub_mchid": "2491935631"
4}

异常示例

1{
2	"code": "INVALID_REQUEST",
3	"message": "Parameter format verification error",
4	"detail": {
5		"field": "#/properties/payer",
6		"value": "1346177081915535577",
7		"issue": "与ALLOF schema不符",
8		"location": "body"
9	}
10}

4. 错误码

状态码	错误码	描述	解决方案
500	SYSTEM_ERROR	系统错误	系统异常，请使用相同参数稍后重新调用
429	FREQUENCY_LIMIT_EXCEED	频率过快，请稍后重试	频率过快，请稍后重试
400	INVALID_REQUEST	父子关系有误，请检查子商户是否属于该服务商	父子商户关系不成立，请核实后重试