Query Authorization Status

Update Time:2025.01.07

This API is used to query the web payment authorization status of a sub-merchant.

Note:

  • Due to product iteration, the H5 payment authorization can be applied for using the Merchant Onboarding interface.

  • For more information, please refer to:

Merchant Onboarding(Introduction)
Merchant Onboarding(Preparation)
Merchant Onboarding(Development Guidelines)
Merchant Onboarding(APIs)


1. API Intro

Applicable object: Institutional mode Service Provider Mode

API rules:https://apihk.mch.weixin.qq.com/v3/global/merchant/h5/permission/{sub_mchid}

Request method:GET

 

Path parameter is a path parameter.

Query parameter needs to be passed in the request URL.

Body parameter needs to be passed in the request JSON.


2. Request Parameters

Name

Variable Name

Type

Required

Description

Sub-merchant ID

sub_mchid

string[1, 32]

Yes

Path ID of a sub-merchant under the current institution/service provider.
Example:2491935631

Request example

URL

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

3. Response Parameters

Response for a successful request

Name

Variable Name

Type

Required

Description

Sub-merchant ID

sub_mchid

string[1, 32]

Yes

ID of the sub-merchant under the current institution/service provider.
Example:2491935631

Web payment authorization status

authorization_state

string

Yes

Web payment authorization status of the sub-merchant. Valid values:
AUTHORITY_TO_TEST: Authorized with an ultra-low limit
FORMAL_AUTHORITY: Authorized with an ordinary limit
AUTHORIZED: Authorized with no limit
UNDER_PUNISHMENT: Sub-merchant under penalty
UNAUTHORIZED: Unauthorized
Example:AUTHORITY_TO_TEST

Response for failed request:

Name

Variable Name

Type

Required

Description

Returned status code

code

string[1,32]

Yes

Error code. See the error code list for the enumerated values.

Returned information

message

string[1,256]

Yes

Returned message. It indicates the reason for the error if not empty.

Detailed error description

detail

object

No

It is returned when code is PARAM_ERROR. Details will be described below.

Detailed error description

Response Example:

SUCCESS

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

ERROR

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. Error Codes

Error Codes

Error Message

Description

Solution

500

SYSTEM_ERROR

System error

Call the API again later with the same parameters.

429

FREQUENCY_LIMIT_EXCEED

Frequency limit, please try it later

Frequency limit, please try it later

400

INVALID_REQUEST

The parent-child relationship is invalid. Check if the sub-merchant belongs to the service provider.

The parent-child merchant relationship cannot be established. Please verify and try again.

 

 

About  WeChat  Pay

Powered By Tencent & Tenpay Copyright©

2005-2025 Tenpay All Rights Reserved.

Contact Us
Wechat Pay Global

WeChat Pay Global

Contact Us

Customer Service Tel

+86 571 95017

9:00-18:00 Monday-Friday GMT+8

Business Development

wxpayglobal@tencent.com

Developer Support

wepayTS@tencent.com

Wechat Pay Global

About Tenpay
Powered By Tencent & Tenpay Copyright© 2005-2025 Tenpay All Rights Reserved.