修改H5支付权限申请单

更新时间:2025.01.07

商户可以通过该接口修改已经被驳回H5支付申请单。

注意:

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

  • 详情查看:

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

1. 接口说明

适用对象: 机构模式

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

请求方式:Patch

 

Path 指该参数为路径参数

Query 指该参数为URL参数

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


2. 请求参数

参数名

变量

类型[长度限制]

必填

描述

申请单号

applyment_id

int

Path 申请单的唯一标识
示例值:100000

H5支付域名

domains

undefined[]

Body 拉起H5支付的域名,不超过5个。
注意:提交的修改的域名列表审核通过后将会覆盖已有支付域名列表。
示例值:["qq.com"]

公司介绍和业务描述

business_description

string[1, 500]

Body 若选择了无限额交易类型,则此字段必须上传
示例值:腾讯于1998年11月成立,是一家互联网公司,通过技术丰富互联网用户的生活,助力企业数字化升级。我们的使命是“用户为本 科技向善”

公司注册资质证书

company_register_cert

string[1, 128]

Body 若选择了无限额交易类型,则此字段必须上传。Media ID,通过上传图片API获得
示例值:6uqyGjvHzOhsLleGFQVRF

经营网址商业页面截图

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

请求示例

JSON

1{
2  "business_description": "腾讯于1998年11月成立,是一家互联网公司,通过技术丰富互联网用户的生活,助力企业数字化升级。我们的使命是“用户为本 科技向善”",
3  "company_register_cert": "6uqyGjvHzOhsLleGFQVRF",
4  "domains": "",
5  "transaction_limit_type": "UN_LAUNCHED_WEBSITE_LIMIT",
6  "website_business_page_pics": "",
7  "website_homepage_pics": "",
8  "website_state": "HAS_LAUNCHED",
9  "website_url": "https://qq.com"
10}  

3. 返回参数

正常返回

参数名

变量

类型[长度限制]

必填

描述

子商户号

sub_mchid

string[1, 32]

当前机构/服务商下的子商户号
注意:仅适用于机构模式
示例值:2491935631

H5支付域名

domains

array

Body 拉起H5支付的域名,不超过5个。
注意:提交的修改的域名列表审核通过后将会覆盖已有支付域名列表。
示例值:["qq.com"]

公司介绍和业务描述

business_description

string[1, 500]

若选择了无限额交易类型,则此字段必须上传
示例值:腾讯于1998年11月成立,是一家互联网公司,通过技术丰富互联网用户的生活,助力企业数字化升级。我们的使命是“用户为本 科技向善”

限额类型

transaction_limit_type

string

Body 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:未上线经营网址支付额度
限制额度:① 50000 CNY/day/person,如触及H5支付限额支付限额,则该客户当天无法通过H5渠道向该子商户支付(次日重新累积)
② 500000 CNY/day/sub-merchant,如触及H5支付限额额度, 该子商户当天无法通过H5渠道收款(次日重新累计)
NORMAL_LIMIT:未补充完整资料时获得普通支付额度
NO_LIMIT:无支付额度限制
示例值:UN_LAUNCHED_WEBSITE_LIMIT

公司注册资质证书

company_register_cert

string[1, 128]

当选择不限额度的支付类型,此字段必传
示例值:6uqyGjvHzOhsLleGFQVRF

限额类型

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

经营网址商业页面截图

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

PARAM_ERROR

该接口创建申请单时,限额类型需为“无限额”。

发起解除限额申请时,限额类型需要为 "No transaction limited"

400

PARAM_ERROR

经营网址未上线,请上传经营服务页面截图

上传经营网址截图后重新发起调用

400

INVALID_REQUEST

申请单状态不是“被驳回”,无法更新资料

审核中的申请单无法修改,需要等待审核驳回后再进行修改

400

INVALID_REQUEST

仅支持“正式限额”状态的子商户申请解除限额。其他状态的子商户如需调整权限状态请调用“H5支付权限申请”接口。

先申请获得限额的H5支付权限后再发起解除限额申请

400

INVALID_REQUEST

商户被处罚,不允许申请开通H5支付权限。

商户支付权限被处罚,请先联系运营人员解除

400

INVALID_REQUEST

提交的H5经营网址或支付域名存在风险,请联系对接BD处理。

经营网址或者H5支付域名命中黑名单,请联系运营人员申请豁免

400

PARAM_ERROR

申请单号不存在,请核实后重试

申请单号不存在,请核实后重试

400

PARAM_ERROR

经营网址未上线,请上传经营网址首页截图

请上传首页截图再发起重试

400

INVALID_REQUEST

经营网址未上线,仅能申请测试限额。

限额类型请选择UN_LAUNCHED_WEBSITE_LIMIT后重试

 

 

About  WeChat  Pay

Powered By Tencent & Tenpay Copyright©

2005-2025 Tenpay All Rights Reserved.

Contact Us
Wechat Pay Global

WeChat Pay Global

Contact Us

Customer Service Tel

+86 571 95017

9:00-18:00 Monday-Friday GMT+8

Business Development

wxpayglobal@tencent.com

Developer Support

wepayTS@tencent.com

Wechat Pay Global

About Tenpay
Powered By Tencent & Tenpay Copyright© 2005-2025 Tenpay All Rights Reserved.