API列表 / H5支付权限申请 / 查询子商户H5支付权限状态

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

最新更新时间：2024.01.25 版本说明

商户可以通过该接口查询子商户的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


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

{
    "appid": "wx2421b1c4370ec43b"
}


									{
										"stock_id": ".NET",
									}


									{
										"stock_id": "Python",
									}

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时返回，详细说明见下

参数名	变量	类型[长度限制]	必填	描述
指示错误参数的位置	field	string[1, 256]	是	当错误参数位于请求body的JSON时，填写指向参数的JSON Pointer 当错误参数位于请求的url或者querystring时，填写参数的变量名示例值：#/properties/payer
错误参数的值	value	string[1, 256]	是	错误参数的值示例值：1346177081915535577
具体错误原因	issue	string[1, 256]	是	具体错误原因示例值：与ALLOF schema不符
错误参数的位置	location	string[1, 256]	否	body：错误参数位于请求body的JSON中 url：错误参数位于请求url中 query：错误参数位于请求的querystring中示例值：body

收起

返回示例

正常示例异常示例

{
  "authorization_state": "AUTHORITY_TO_TEST",
  "sub_mchid": "2491935631"
}

 
{
	"code": "INVALID_REQUEST",
	"message": "Parameter format verification error",
	"detail": {
		"field": "#/properties/payer",
		"value": "1346177081915535577",
		"issue": "与ALLOF schema不符",
		"location": "body"
	}
}

4. 错误码

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

页面导航

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

支付产品

资金类产品

其他产品

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

1. 接口说明

2. 请求参数

请求示例

3. 返回参数

正常返回

异常返回

返回示例

4. 错误码