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

创建H5支付权限申请单

更新时间：2025.01.07

商户可以通过调用此接口为子商户申请H5支付权限。调用之前需要先签署批量提交协议。如果限额类型（transaction_limit_type）选择不限额度（NO_LIMIT），则在此申请单创建完成后，系统会未子商户自动创建解除限额申请单。发起解除限额申请时，需要确保商户已经获得了普通限额的支付权限。

注意：

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

详情查看：

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

1. 接口说明

适用对象：从业机构（支付机构）

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

请求方式：POST

Path 指该参数为路径参数

Query 指该参数为URL参数

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

2. 请求参数

参数名	变量	类型[长度限制]	必填	描述
公司介绍和业务描述	business_description	string[1, 500]	否	Body 若选择了无限额交易类型，则此字段必须上传示例值：腾讯于1998年11月成立，是一家互联网公司，通过技术丰富互联网用户的生活，助力企业数字化升级。我们的使命是“用户为本科技向善”
子商户号	sub_mchid	string[1, 32]	是	Body 当前机构/服务商下的子商户号注意：仅适用于机构模式示例值：2491935631
H5支付域名	domains	array	是	Body 拉起H5支付的域名，不超过5个。注意：提交的修改的域名列表审核通过后将会覆盖已有支付域名列表。示例值：["qq.com"]
公司注册资质证书	company_register_cert	string[1, 32]	否	Body 若选择了无限额交易类型，则此字段必须上传。Media ID，通过上传图片API获得示例值：6uqyGjvHzOhsLleGFQVRF
限额类型	transaction_limit_type	string	否	Body H5支付限额类型，包括测试网址限额、普通限额、不限额。不传默认为普通限额限制额度：① 1000 CNY/day/person 触及H5支付交易额度，该客户当天无法通过H5渠道向该子商户支付（次日重新累计） ② 50000 CNY/day/sub-merchant 触及H5支付交易额度，该子商户当天无法通过H5渠道收款（次日重新累计） UN_LAUNCHED_WEBSITE_LIMIT：未上线经营网址支付额度限制额度： ① 50000 CNY/day/person，如触及H5支付限额支付限额，则该客户当天无法通过H5渠道向该子商户支付（次日重新累积） ② 500000 CNY/day/sub-merchant，如触及H5支付限额额度，该子商户当天无法通过H5渠道收款（次日重新累计） NORMAL_LIMIT：未补充完整资料时获得普通支付额度 NO_LIMIT：无支付额度限制示例值：UN_LAUNCHED_WEBSITE_LIMIT
经营网址商业页面截图	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
子商户H5经营网址	website_url	string[1, 128]	是	Body 包含该子商户的主营业务、销售商品/服务及价格、用户可在线下单购买的网址。示例值：https://qq.com
商户提供的审核结果回调接口	notify_url	string[1, 128]	否	Body 必须为https协议。如果链接无法访问，商户将无法接收到微信通知。通知url必须为直接可访问的url，不能携带参数。《权限申请回调文档》示例值：https://pay.weixin.qq.com/wxpay/pay.action
申请单类型	applyment_type	string	否	Body H5支付权限申请单类型，包括H5支付权限申请和解除H5支付限额申请。不传默认为H5支付权限申请 APPLY_FOR_PAYMENT_AUTHORITY：申请H5支付权限 APPLY_FOR_RELIEVE_LIMITED：申请解除H5支付限额示例值：APPLY_FOR_PAYMENT_AUTHORITY

请求示例

JSON

1{
2  "applyment_type": "APPLY_FOR_PAYMENT_AUTHORITY",
3  "company_register_cert": "6uqyGjvHzOhsLleGFQVRF",
4  "domains": "",
5  "notify_url": "https://pay.weixin.qq.com/wxpay/pay.action",
6  "sub_mchid": "2491935631",
7  "transaction_limit_type": "UN_LAUNCHED_WEBSITE_LIMIT",
8  "website_business_page_pics": "",
9  "website_homepage_pics": "",
10  "website_state": "HAS_LAUNCHED",
11  "website_url": "https://qq.com"
12}

3. 返回参数

正常返回

参数名	变量	类型[长度限制]	必填	描述
子商户号	sub_mchid	string[1, 32]	是	当前机构/服务商下的子商户号注意：仅适用于机构模式示例值：2491935631
H5支付域名	domains	array	是	拉起H5支付的域名，不超过5个。注意：提交的修改的域名列表审核通过后将会覆盖已有支付域名列表。示例值：["qq.com"]
公司介绍和业务描述	business_description	string[1, 500]	否	若选择了无限额交易类型，则此字段必须上传示例值：腾讯于1998年11月成立，是一家互联网公司，通过技术丰富互联网用户的生活，助力企业数字化升级。我们的使命是“用户为本科技向善”
限额类型	transaction_limit_type	string	是	H5支付限额类型限制额度: ①1000 CNY/day/person if touched the transaction limit of the H5 payment, this customer couldn't pay to this sub-merchant through H5 channel on this day （re-accumulate in the next day） ② 50000 CNY/day/sub-merchant UN_LAUNCHED_WEBSITE_LIMIT：未上线经营网址支付额度 NORMAL_LIMIT：未补充完整资料时获得普通支付额度限制额度：① 50000 CNY/day/person，如触及H5支付限额支付限额，则该客户当天无法通过H5渠道向该子商户支付（次日重新累积） ② 500000 CNY/day/sub-merchant，如触及H5支付限额额度，该子商户当天无法通过H5渠道收款（次日重新累计） NO_LIMIT：无支付额度限制示例值：UN_LAUNCHED_WEBSITE_LIMIT
公司注册资质证书	company_register_cert	string[1, 128]	否	当选择不限额度的支付类型，此字段必传示例值：6uqyGjvHzOhsLleGFQVRF
经营网址商业页面截图	website_business_page_pics	array	否	若经营网址未上线，则此字段必传。Media ID，通过上传图片API获得示例值：["6uqyGjvHzOhsLleGFQVRF"]
经营网址首页截图	website_homepage_pics	array	否	若经营网址未上线，则此字段必传。Media ID，通过上传图片API获得示例值：["6uqyGjvHzOhsLleGFQVRF"]
子商户经营网址状态	website_state	string	是	子商户经营网址状态，包括已上线和未上线 HAS_LAUNCHED：经营网址已上线 UN_LAUNCHED：经营网址未上线示例值：HAS_LAUNCHED
子商户H5经营网址	website_url	string[1, 128]	是	包含该子商户的主营业务、销售商品/服务及价格、用户可在线下单购买的网址。示例值：https://qq.com
申请单号	applyment_id	int	是	申请单的唯一标识示例值：100000
驳回原因	audit_reject_detail	string[1, 500]	否	申请单被驳回的原因，当申请单被驳回时此字段会显示具体的驳回原因示例值：商户证书不符合要求
申请单状态	applyment_state	string	是	H5支付申请单状态 PENDING：待创建，申请单暂未创建，可稍后查询或检查进件状态是否正常 UNDER_REVIEW：审核中，申请单已创建，并且已进入审核阶段 APPROVED：已通过，申请单已审核通过 REJECTED：已驳回，申请单已驳回，请留意驳回原因字段 audit_reject_detail 示例值：PENDING
申请单类型	applyment_type	string	是	H5支付权限申请单类型，包括H5支付权限申请和解除H5支付限额申请 APPLY_FOR_PAYMENT_AUTHORITY：申请H5支付权限 APPLY_FOR_RELIEVE_LIMITED：申请解除H5支付限额示例值：APPLY_FOR_PAYMENT_AUTHORITY
商户提供的审核结果回调接口	notify_url	string[1, 128]	否	必须为https协议。如果链接无法访问，商户将无法接收到微信通知。通知url必须为直接可访问的url，不能携带参数。《权限申请回调文档》示例值：https://pay.weixin.qq.com/wxpay/pay.action

异常返回

参数名

变量

类型[长度限制]

必填

描述

返回状态码

code

string[1, 32]

是

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

返回信息

message

string[1, 256]

是

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

详细的错误描述

detail

object

否

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

详细的错误描述

返回示例

正常示例

1{
2  "applyment_id": 100000,
3  "applyment_state": "PENDING",
4  "applyment_type": "APPLY_FOR_PAYMENT_AUTHORITY",
5  "audit_reject_detail": "商户证书不符合要求",
6  "business_description": "腾讯于1998年11月成立，是一家互联网公司，通过技术丰富互联网用户的生活，助力企业数字化升级。我们的使命是“用户为本 科技向善”",
7  "company_register_cert": "6uqyGjvHzOhsLleGFQVRF",
8  "domains": "",
9  "notify_url": "https://pay.weixin.qq.com/wxpay/pay.action",
10  "sub_mchid": "2491935631",
11  "transaction_limit_type": "UN_LAUNCHED_WEBSITE_LIMIT",
12  "website_business_page_pics": "",
13  "website_homepage_pics": "",
14  "website_state": "HAS_LAUNCHED",
15  "website_url": "https://qq.com"
16}

异常示例

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	已获得支付权限，禁止再次发起测试网址权限申请	已获得支付权限，禁止再次申请测试网址支付权限申请
400	PARAM_ERROR	该接口创建申请单时，限额类型需为“无限额”。	发起解除限额申请时，限额类型需要为 "No transaction limited"
400	PARAM_ERROR	仅支持“已上线”状态的经营网址申请解除限额。其他状态的网址如需调整权限状态请调用“H5支付权限申请”接口。	将经营网址状态改为HAS_LAUNCHED后重新发起调用
400	PARAM_ERROR	经营网址未上线，请上传经营服务页面截图	上传经营网址截图后重新发起调用
400	INVALID_REQUEST	商户基础信息缺失，如商户证书编号、联系人、邮箱等，请登录商户平台修改后再试。（机构请访问：机构商户平台；普通服务商请访问：服务商平台）	商户资料缺失，请访问对应的链接进行补充后重新提交
400	INVALID_REQUEST	商户证书过期，请登录商户平台更新后再试。（机构请访问：机构商户平台；普通服务商请访问：服务商平台）	商户证书过期，请访问对应的链接进行修改后重新提交
400	INVALID_REQUEST	仅支持“正式限额”状态的子商户申请解除限额。其他状态的子商户如需调整权限状态请调用“H5支付权限申请”接口。	先申请获得限额的H5支付权限后再发起解除限额申请
400	INVALID_REQUEST	商户被处罚，不允许申请开通H5支付权限。	商户支付权限被处罚，请先联系运营人员解除
400	INVALID_REQUEST	提交的H5经营网址或支付域名存在风险，请联系对接BD处理。	经营网址或者H5支付域名命中黑名单，请联系运营人员申请豁免
400	INVALID_REQUEST	已有流程中的申请单，请勿重复提交。	请耐心等待，在流程结束后再次提交
400	INVALID_REQUEST	父子关系有误，请检查子商户是否属于该服务商。	父子商户关系不成立，请核实后重试
400	PARAM_ERROR	请上传公司注册证书、公司介绍和业务描述。	请上传公司注册证书、公司介绍和业务描述后发起重试
400	INVALID_REQUEST	经营网址未上线，仅能申请测试限额。	限额类型请选择UN_LAUNCHED_WEBSITE_LIMIT后重试
400	INVALID_REQUEST	当前子商户已享有无限额H5支付权限，请勿重复提交申请单	已获得无限额的支付权限，请勿重复提交申请
403	NO_AUTH	请登录商户平台 H5 Payment Application 页面点击 +Batch Apply按钮完成批量上传协议签署后再发起调用	请登录商户平台 H5 Payment Application 页面点击 +Batch Apply按钮完成批量上传协议签署后再发起调用