查詢H5支付域名修改申請單
最新更新時間：2024.01.25 版本說明
商戶可以通過該接口查詢H5支付域名修改申請單。
注意：? 因產(chǎn)品迭代，H5支付權(quán)限可使用子商戶進(jìn)件接口申請。
? 詳情查看：
子商戶進(jìn)件（產(chǎn)品介紹）
子商戶進(jìn)件（接入前準(zhǔn)備）
子商戶進(jìn)件（開發(fā)指引）
子商戶進(jìn)件（API列表）
1. 接口說明
適用對象： 機(jī)構(gòu)模式
請求URL：https://apihk.mch.weixin.qq.com/v3/global/merchant/h5/permission/domain/applications/{applyment_id}
請求方式：GET
Path指該參數(shù)為路徑參數(shù)
Query指該參數(shù)為URL參數(shù)
Body指該參數(shù)需在請求JSON傳參
2. 請求參數(shù)
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 申請單號 | applyment_id | int | 是 | Path 申請單的唯一標(biāo)識 示例值：1000000 |
請求示例
https://api.mch.weixin.qq.com/v3/global/merchant/h5/permission/domain/applications/1000000
3. 返回參數(shù)
正常返回
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 子商戶號 | sub_mchid | string[1, 32] | 是 | 當(dāng)前機(jī)構(gòu)/服務(wù)商下的子商戶號 注意：僅適用于機(jī)構(gòu)模式 示例值：2491935631 |
| 子商戶經(jīng)營網(wǎng)址狀態(tài) | website_state | string | 是 | 子商戶經(jīng)營網(wǎng)址狀態(tài)，包括已上線和未上線 HAS_LAUNCHED：經(jīng)營網(wǎng)址已上線 UN_LAUNCHED：經(jīng)營網(wǎng)址未上線 注意：僅適用于機(jī)構(gòu)模式 示例值：HAS_LAUNCHED |
| H5支付域名 | domains | array | 是 | Body 拉起H5支付的域名，不超過5個。 注意：提交的修改的域名列表審核通過后將會覆蓋已有支付域名列表。 示例值：["qq.com"] |
| 子商戶H5經(jīng)營網(wǎng)址 | webiste_url | string[1, 128] | 是 | 包含該子商戶的主營業(yè)務(wù)、銷售商品/服務(wù)及價格、用戶可在線下單購買的網(wǎng)址。 注意：僅適用于機(jī)構(gòu)模式 示例值：https://qq.com |
| 經(jīng)營網(wǎng)址商業(yè)頁面截圖 | website_business_page_pics | array | 否 | 若經(jīng)營網(wǎng)址未上線，則此字段必傳。Media ID，通過上傳圖片API獲得 示例值：["6uqyGjvHzOhsLleGFQVRF"] |
| 經(jīng)營網(wǎng)址首頁截圖 | website_homepage_pics | array | 否 | 若經(jīng)營網(wǎng)址未上線，則此字段必傳。Media ID，通過上傳圖片API獲得 示例值：["6uqyGjvHzOhsLleGFQVRF"] |
| 申請單號 | applyment_id | int | 是 | 申請單的唯一標(biāo)識 示例值：1000000 |
| 駁回原因 | audit_reject_detail | string[1, 500] | 否 | 申請單被駁回的原因，當(dāng)申請單被駁回時此字段會顯示具體的駁回原因 示例值：經(jīng)營網(wǎng)址首頁截圖內(nèi)容違法 |
| 申請單狀態(tài) | applyment_state | string | 否 | H5支付域名修改申請單狀態(tài) PENDING：待創(chuàng)建，申請單暫未創(chuàng)建，可稍后查詢或檢查進(jìn)件狀態(tài)是否正常 UNDER_REVIEW：審核中，申請單已創(chuàng)建，并且已進(jìn)入審核階段 APPROVED：已通過，申請單已審核通過 REJECTED：已駁回，申請單已駁回，請留意駁回原因字段 audit_reject_detail 示例值：PENDING |
| 商戶提供的審核結(jié)果回調(diào)接口 | notify_url | string[1, 128] | 否 | 必須為https協(xié)議。如果鏈接無法訪問，商戶將無法接收到微信通知。 通知url必須為直接可訪問的url，不能攜帶參數(shù)。 《域名修改回調(diào)文檔》 示例值：http://www.tg885.com/wxpay/pay.action |
| 商戶申請單號 | out_applyment_id | string[6, 32] | 是 | 商戶系統(tǒng)內(nèi)部申請單號，只能是數(shù)字、大小寫字母_-*且在同一個商戶號下唯一 示例值：123456 |
異常返回
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 返回狀態(tài)碼 | code | string[1, 32] | 是 | 錯誤碼，枚舉值見錯誤碼列表 示例值：INVALID_REQUEST |
| 返回信息 | message | string[1, 256] | 是 | 返回信息，如非空，為錯誤原因 示例值：參數(shù)格式校驗(yàn)錯誤 |
| 詳細(xì)的錯誤描述 | detail | object | 否 | 當(dāng)code為PARAM_ERROR時返回，詳細(xì)說明見下 |
返回示例
{
"applyment_id": 1000000,
"applyment_state": "PENDING",
"audit_reject_detail": "經(jīng)營網(wǎng)址首頁截圖內(nèi)容違法",
"domains": "",
"notify_url": "http://www.tg885.com/wxpay/pay.action",
"sub_mchid": "2491935631",
"webiste_url": "https://qq.com",
"website_business_page_pics": "",
"website_homepage_pics": "",
"out_applyment_id": "123456",
"website_state": "HAS_LAUNCHED"
}
4. 錯誤碼
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 系統(tǒng)異常，請使用相同參數(shù)稍后重新調(diào)用 |
| 429 | FREQUENCY_LIMIT_EXCEED | 頻率過快，請稍后重試 | 頻率過快，請稍后重試 |
| 400 | PARAM_ERROR | 申請單號不存在，請核實(shí)后重試 | 申請單號不存在，請核實(shí)后重試 |
頁面導(dǎo)航
