Modify Domain Modification Application
This API is used to modify a rejected web payment domain modification request.
This API is used to modify a rejected web payment domain modification request.
• 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)
Applicable object: Institutional mode Service Provider Mode
API rules:https://apihk.mch.weixin.qq.com/v3/global/merchant/h5/permission/domain/applications/{applyment_id}
Request method:Patch
Name | Variable Name | Type | Required | Description |
---|---|---|---|---|
Application ID |
applyment_id | int | Yes |
Path Unique ID of the H5 authorization application. Example: 1000000 |
Web payment domain |
domains | array | Yes |
Body The domain that pulls web payment. Note that the submitted domain list will overwrite the original effective domain list. Example: ["qq.com"] |
Sub-merchant's website status |
website_state | string | No |
Body The status of the sub-merchant's website. Valid values: HAS_LAUNCHED: The website has been launched. UN_LAUNCHED: The website is not launched. Example: HAS_LAUNCHED |
Sub-merchant's website URL |
website_url | string[1, 128] | No |
Body The URL of the website on which the sub-merchant's business categories, products/services and prices are displayed and users can place orders. Example: https://qq.com |
Website business page screenshot |
website_business_page_pics | array | No |
Body This field is required when the website is not launched. The value is a media ID, which can be obtained via the image upload API Example: ["6uqyGjvHzOhsLleGFQVRF"] |
Website homepage screenshot |
website_homepage_pics | array | No |
Body This field is required when the website is not launched. The value is a media ID, which can be obtained via the image upload API Example: ["6uqyGjvHzOhsLleGFQVRF"] |
{
"domains": ["qq.com"],
"website_business_page_pics": ["6uqyGjvHzOhsLleGFQVRF"],
"website_homepage_pics": ["6uqyGjvHzOhsLleGFQVRF"],
"website_state": "HAS_LAUNCHED",
"website_url": "https://qq.com"
}
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 |
Sub-merchant's website status |
website_state | string | Yes |
The status of the sub-merchant's website. Valid values: HAS_LAUNCHED: The website has been launched. UN_LAUNCHED: The website is not launched. Example: HAS_LAUNCHED |
Web payment domain |
domains | array | Yes |
The domain that pulls web payment. Note that the submitted domain list will overwrite the original effective domain list. Example: ["qq.com"] |
Sub-merchant's website URL |
webiste_url | string[1, 128] | Yes |
The URL of the website on which the sub-merchant's business categories, products/services and prices are displayed and users can place orders. Example: https://qq.com |
Website business page screenshot |
website_business_page_pics | array | No |
This field is required when the website is not launched. The value is a media ID, which can be obtained via the image upload API Example: ["6uqyGjvHzOhsLleGFQVRF"] |
Website homepage screenshot |
website_homepage_pics | array | No |
This field is required when the website is not launched. The value is a media ID, which can be obtained via the image upload API Example: ["6uqyGjvHzOhsLleGFQVRF"] |
Application ID |
applyment_id | int | Yes |
Unique ID of the request. Example: 1000000 |
Rejection reason |
audit_reject_detail | string[1, 500] | No |
The reason why the request is rejected. Example: Illegal content of website homepage screenshot |
Request status |
applyment_state | string | No |
The status of the web payment domain modification request. Valid values: PENDING: The request is not created. Query again later or check whether the submission is normal. UNDER_REVIEW: The request is created and under review. APPROVED: The request is approved. REJECTED: The request is rejected. See audit_reject_detail for the rejection reason. Example: PENDING |
Callback API provided by merchants to receive review results |
notify_url | string[1, 128] | No |
The HTTPS protocol is required. If the URL cannot be accessed, the merchant will not receive any WeChat notifications. The notification URL must be directly accessible without any parameters. For more information, please refer to Domian Modification Result Notification Example: https://pay.weixin.qq.com/wxpay/pay.action |
Merchant request ID |
out_applyment_id | string[6, 32] | Yes |
Internal request ID in the merchant system. The request ID can only contain numbers, letters, underscores (_), hyphens (-), and asterisks (*), and is unique under the same merchant ID. Example: 123456 |
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. |
{
"applyment_id": 1000000,
"applyment_state": "PENDING",
"audit_reject_detail": "Illegal content of website homepage screenshot",
"domains": ["qq.com"],
"notify_url": "https://pay.weixin.qq.com/wxpay/pay.action",
"sub_mchid": "2491935631",
"webiste_url": "https://qq.com",
"website_business_page_pics": ["6uqyGjvHzOhsLleGFQVRF"],
"website_homepage_pics": ["6uqyGjvHzOhsLleGFQVRF"],
"out_applyment_id": "123456",
"website_state": "HAS_LAUNCHED"
}
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 | PARAM_ERROR | The website has not launched. Upload the business page screenshot. | Please re-initiate the call after uploading a screenshot of the business website. |
400 | INVALID_REQUEST | Unable to update the information when a request is not in the "Rejected" status | The application under review cannot be modified. Please wait for the rejection and then make the necessary changes. |
400 | INVALID_REQUEST | There is missing merchant basic information, such as merchant certificate number, contact, and email. Log in to the merchant platform to modify the information and try again.(Institution portal:Institutional Merchant Platform;service provider portal:Service Merchant Platform) | Merchant information is missing. Please visit the corresponding link to supplement and resubmit. |
400 | INVALID_REQUEST | Merchant certificate expired. Log in to the merchant platform to update the information and try again.(Institution portal:Institutional Merchant Platform;service provider portal:Service Merchant Platform) | Merchant certificate has expired. Please visit the corresponding link to make the necessary changes and resubmit. |
400 | INVALID_REQUEST | The submitted website or H5 payment domain name is at risk. Contact your BD for assistance. | The business website or H5 payment domain is blacklisted. Please contact the operation personnel to apply for an exemption. |
400 | PARAM_ERROR | The request number does not exist. Check and try again. | The request number does not exist. Check and try again. |
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. |
400 | PARAM_ERROR | The website has not launched. Upload the website homepage screenshot. | Please upload the screenshot of the homepage and try again. |
400 | PARAM_ERROR | Upload the Company Registration Certificate, Company Introduction and Description of the Business. | Please upload the company registration certificate, company introduction, and business description and try again. |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP证