支付产品
- 付款码支付
- Native支付
- JSAPI支付
- APP支付
- 小程序支付
- H5支付
- 委托代扣
资金类产品
- 分账（发起交易）
- 分账（操作分账）
- 分账（发起退款）
- 分账（账单及资金查询）
其他产品

创建H5支付域名修改申请单

更新时间：2025.01.07

商户可以通过该接口为自身和子商户发起H5支付域名修改申请。

注意：

因产品迭代，H5支付权限可使用子商户进件接口申请。

详情查看：

子商户进件（产品介绍）
子商户进件（接入前准备）
子商户进件（开发指引）
子商户进件（API列表）

1. 接口说明

适用对象：机构模式

请求URL：https://apihk.mch.weixin.qq.com/v3/global/merchant/h5/permission/domain/applications

请求方式：POST

Path 指该参数为路径参数

Query 指该参数为URL参数

Body 指该参数需在请求JSON传参

2. 请求参数

参数名	变量	类型[长度限制]	必填	描述
子商户号	sub_mchid	string[1, 32]	否	Body 当前机构/服务商下的子商户号。子商户号不存在时表示修改父商户的H5支付域名注意：仅适用于机构模式示例值：2491935631
H5支付域名	domains	array	是	Body 拉起H5支付的域名，不超过5个。注意：提交的修改的域名列表审核通过后将会覆盖已有支付域名列表。示例值：["qq.com"]
子商户H5经营网址	website_url	string[1, 128]	是	Body 包含该子商户的主营业务、销售商品/服务及价格、用户可在线下单购买的网址示例值：https://qq.com
经营网址商业页面截图	website_business_page_pics	array	否	Body 若经营网址未上线，则此字段必传。Media ID，通过上传图片API获得示例值：["6uqyGjvHzOhsLleGFQVRF"]
经营网址首页截图	website_homepage_pics	array	否	Body 若经营网址未上线，则此字段必传。Media ID，通过上传图片API获得示例值：["6uqyGjvHzOhsLleGFQVRF"]
子商户经营网址状态	website_state	string	否	Body 子商户经营网址状态，包括已上线和未上线。不传默认表示已上线 HAS_LAUNCHED：经营网址已上线 UN_LAUNCHED：经营网址未上线注意：仅适用于机构模式示例值：HAS_LAUNCHED
商户提供的审核结果回调接口	notify_url	string[1, 128]	否	Body 必须为https协议。如果链接无法访问，商户将无法接收到微信通知。通知url必须为直接可访问的url，不能携带参数。《域名修改回调文档》示例值：https://pay.weixin.qq.com/wxpay/pay.action
商户申请单号	out_applyment_id	string[6, 32]	是	Body 商户系统内部申请单号，只能是数字、大小写字母_-*且在同一个商户号下唯一示例值：123456

请求示例

JSON

1{
2  "domains": "",
3  "notify_url": "https://pay.weixin.qq.com/wxpay/pay.action",
4  "sub_mchid": "2491935631",
5  "website_business_page_pics": "",
6  "website_homepage_pics": "",
7  "website_state": "HAS_LAUNCHED",
8  "website_url": "https://qq.com",
9  "out_applyment_id": "123456"
10}

3. 返回参数

正常返回

参数名	变量	类型[长度限制]	必填	描述
子商户号	sub_mchid	string[1, 32]	是	当前机构/服务商下的子商户号注意：仅适用于机构模式示例值：2491935631
子商户经营网址状态	website_state	string	是	子商户经营网址状态，包括已上线和未上线 HAS_LAUNCHED：经营网址已上线 UN_LAUNCHED：经营网址未上线示例值：HAS_LAUNCHED
H5支付域名	domains	array	是	Body 拉起H5支付的域名，不超过5个。注意：提交的修改的域名列表审核通过后将会覆盖已有支付域名列表。示例值：["qq.com"]
子商户H5经营网址	webiste_url	string[1, 128]	是	包含该子商户的主营业务、销售商品/服务及价格、用户可在线下单购买的网址。注意：仅适用于机构模式示例值：https://qq.com
经营网址商业页面截图	website_business_page_pics	array	否	若经营网址未上线，则此字段必传。Media ID，通过上传图片API获得示例值：["6uqyGjvHzOhsLleGFQVRF"]
经营网址首页截图	website_homepage_pics	array	否	若经营网址未上线，则此字段必传。Media ID，通过上传图片API获得示例值：["6uqyGjvHzOhsLleGFQVRF"]
申请单号	applyment_id	int	是	申请单的唯一标识示例值：1000000
驳回原因	audit_reject_detail	string[1, 500]	否	申请单被驳回的原因，当申请单被驳回时此字段会显示具体的驳回原因示例值：经营网址首页截图内容违法
申请单状态	applyment_state	string	否	H5支付域名修改申请单状态 PENDING：待创建，申请单暂未创建，可稍后查询或检查进件状态是否正常 UNDER_REVIEW：审核中，申请单已创建，并且已进入审核阶段 APPROVED：已通过，申请单已审核通过 REJECTED：已驳回，申请单已驳回，请留意驳回原因字段 audit_reject_detail 示例值：PENDING
商户提供的审核结果回调接口	notify_url	string[1, 128]	否	必须为https协议。如果链接无法访问，商户将无法接收到微信通知。通知url必须为直接可访问的url，不能携带参数。《域名修改回调文档》示例值：https://pay.weixin.qq.com/wxpay/pay.action
商户申请单号	out_applyment_id	string[6, 32]	是	商户系统内部申请单号，只能是数字、大小写字母_-*且在同一个商户号下唯一示例值：123456

异常返回

参数名

变量

类型[长度限制]

必填

描述

返回状态码

code

string[1, 32]

是

错误码，枚举值见错误码列表
示例值：INVALID_REQUEST

返回信息

message

string[1, 256]

是

返回信息，如非空，为错误原因
示例值：参数格式校验错误

详细的错误描述

detail

object

否

当code为PARAM_ERROR时返回，详细说明见下

详细的错误描述

返回示例

正常示例

1{
2  "applyment_id": 1000000,
3  "applyment_state": "PENDING",
4  "audit_reject_detail": "经营网址首页截图内容违法",
5  "domains": "",
6  "notify_url": "https://pay.weixin.qq.com/wxpay/pay.action",
7  "sub_mchid": "2491935631",
8  "webiste_url": "https://qq.com",
9  "website_business_page_pics": "",
10  "website_homepage_pics": "",
11  "out_applyment_id": "123456",
12  "website_state": "HAS_LAUNCHED"
13}

异常示例

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. 错误码

状态码	错误码	描述	解决方案
500	SYSTEM_ERROR	系统错误	系统异常，请使用相同参数稍后重新调用
429	FREQUENCY_LIMIT_EXCEED	频率过快，请稍后重试	频率过快，请稍后重试
400	INVALID_REQUEST	未获得H5支付权限，禁止修改H5域名	先完成H5支付权限申请后重新发起调用
400	PARAM_ERROR	经营网址未上线，请上传经营服务页面截图	上传经营网址截图后重新发起调用
400	INVALID_REQUEST	商户基础信息缺失，如商户证书编号、联系人、邮箱等，请登录商户平台修改后再试。（机构请访问：机构商户平台；普通服务商请访问：服务商平台）	商户资料缺失，请访问对应的链接进行补充后重新提交
400	INVALID_REQUEST	商户证书过期，请登录商户平台更新后再试。（机构请访问：机构商户平台；普通服务商请访问：服务商平台）	商户证书过期，请访问对应的链接进行修改后重新提交
400	INVALID_REQUEST	提交的H5经营网址或支付域名存在风险，请联系对接BD处理。	经营网址或者H5支付域名命中黑名单，请联系运营人员申请豁免
400	INVALID_REQUEST	父子关系有误，请检查子商户是否属于该服务商。	父子商户关系不成立，请核实后重试
400	PARAM_ERROR	经营网址未上线，请上传经营网址首页截图	请上传首页截图再发起重试
400	PARAM_ERROR	请上传公司注册证书、公司介绍和业务描述	请上传公司注册证书、公司介绍和业务描述后发起重试