查询H5支付域名修改申请单

更新时间:2025.01.07

商户可以通过该接口查询H5支付域名修改申请单。

注意:

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

  • 详情查看:

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

1. 接口说明

适用对象: 机构模式

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

请求方式:GET

 

Path 指该参数为路径参数

Query 指该参数为URL参数

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


2. 请求参数

参数名

变量

类型[长度限制]

必填

描述

申请单号

applyment_id

int

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

请求示例

URL

1https://api.mch.weixin.qq.com/v3/global/merchant/h5/permission/domain/applications/1000000  

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}

 

4. 错误码

状态码

错误码

描述

解决方案

500

SYSTEM_ERROR

系统错误

系统异常,请使用相同参数稍后重新调用

429

FREQUENCY_LIMIT_EXCEED

频率过快,请稍后重试

频率过快,请稍后重试

400

PARAM_ERROR

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

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

 

 

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.