API列表 / H5支付权限申请 / 创建H5支付权限申请单

创建H5支付权限申请单

最新更新时间：2024.01.25 版本说明

商户可以通过调用此接口为子商户申请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


{
  "applyment_type": "APPLY_FOR_PAYMENT_AUTHORITY",
  "company_register_cert": "6uqyGjvHzOhsLleGFQVRF",
  "domains": "",
  "notify_url": "https://pay.weixin.qq.com/wxpay/pay.action",
  "sub_mchid": "2491935631",
  "transaction_limit_type": "UN_LAUNCHED_WEBSITE_LIMIT",
  "website_business_page_pics": "",
  "website_homepage_pics": "",
  "website_state": "HAS_LAUNCHED",
  "website_url": "https://qq.com"
}

{
    "appid": "wx2421b1c4370ec43b",
    "m",
      "device_id" : "013467007045764",
      "operator_id": "P001",
      "store_info" : {
        "id": "SZTX001"
      }
    }
}


									{
										"stock_id": ".NET",
										"limit": 10,
									}


									{
										"stock_id": "Python",
										"stock_creator_mchid": "123456",
										"limit": 10,
									}

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时返回，详细说明见下

参数名	变量	类型[长度限制]	必填	描述
指示错误参数的位置	field	string[1, 256]	是	当错误参数位于请求body的JSON时，填写指向参数的JSON Pointer 当错误参数位于请求的url或者querystring时，填写参数的变量名示例值：#/properties/payer
错误参数的值	value	string[1, 256]	是	错误参数的值示例值：1346177081915535577
具体错误原因	issue	string[1, 256]	是	具体错误原因示例值：与ALLOF schema不符
错误参数的位置	location	string[1, 256]	否	body：错误参数位于请求body的JSON中 url：错误参数位于请求url中 query：错误参数位于请求的querystring中示例值：body

收起

返回示例

正常示例异常示例

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

 
{
	"code": "INVALID_REQUEST",
	"message": "Parameter format verification error",
	"detail": {
		"field": "#/properties/payer",
		"value": "1346177081915535577",
		"issue": "与ALLOF schema不符",
		"location": "body"
	}
}

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按钮完成批量上传协议签署后再发起调用

页面导航

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

支付产品

资金类产品

其他产品

创建H5支付权限申请单

1. 接口说明

2. 请求参数

请求示例

3. 返回参数

正常返回

异常返回

返回示例

4. 错误码