Query Authorization Status
Update Time:2025.01.07This API is used to query the web payment authorization status of a sub-merchant.
|
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. |
Request example
URL
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. |
Web payment authorization status | authorization_state | string | Yes | Web payment authorization status of the sub-merchant. Valid values: |
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. | |||
|
Response Example:
SUCCESS
ERROR
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. |