Login expired. Please log in again.

Feedback

0/300

Feedback

Submitted successfully

ok

Feedback

Network exception, please try again later

ok

Modify Domain Modification Application

Latest update time:2024.01.25 Release notes

This API is used to modify a rejected web payment domain modification request.

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/domain/applications/{applyment_id}

Request method:Patch


Pathparameter is a path parameter.
Queryparameter needs to be passed in the request URL.
Bodyparameter needs to be passed in the request JSON.

2. Request Parameters

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"]

Request example

{
  "domains": ["qq.com"],
  "website_business_page_pics": ["6uqyGjvHzOhsLleGFQVRF"],
  "website_homepage_pics": ["6uqyGjvHzOhsLleGFQVRF"],
  "website_state": "HAS_LAUNCHED",
  "website_url": "https://qq.com"
}
  
{
    "appid": "wx2421b1c4370ec43b"
}

									{
										"stock_id": ".NET",
									}

									{
										"stock_id": "Python",
									}

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

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

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.
Name Variable Name Type Required Description
The location of incorrect parameter field string[1,256] Yes If the incorrect parameter is in the JSON for request body, it is populated with the JSON Pointer pointing to this parameter. If the incorrect parameter is in the request URL or querystring, it is populated with the variable name of this parameter.
Value of the incorrect parameter value string[1,256] Yes Value of the incorrect parameter
Cause of error issue string[1,256] Yes Cause of error
Location of the incorrect parameter location string[1,256] No body: The incorrect parameter is in the JSON for request body
url: The incorrect parameter is in the request URL
query: The incorrect parameter is in the querystring of the request

Response Example:

{
  "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"
}
 
{
	"code": "INVALID_REQUEST",
	"message": "Parameter format verification error",
	"detail": {
		"field": "#/properties/payer",
		"value": "1346177081915535577",
		"issue": "与ALLOF schema不符",
		"location": "body"
	}
}

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




    Page Navigation
Language

About  WeChat  Pay

Powered By Tencent & Tenpay Copyright©

2005-2024 Tenpay All Rights Reserved.

Contact Us
Wechat Pay Global

WeChat Pay Global

置顶