創(chuàng)建H5支付域名修改申請(qǐng)單
最新更新時(shí)間:2024.01.25 版本說明
商戶可以通過該接口為自身和子商戶發(fā)起H5支付域名修改申請(qǐng)。
? 因產(chǎn)品迭代,H5支付權(quán)限可使用子商戶進(jìn)件接口申請(qǐng)。
? 詳情查看:
子商戶進(jìn)件(產(chǎn)品介紹)
子商戶進(jìn)件(接入前準(zhǔn)備)
子商戶進(jìn)件(開發(fā)指引)
子商戶進(jìn)件(API列表)
適用對(duì)象: 機(jī)構(gòu)模式
請(qǐng)求URL:https://apihk.mch.weixin.qq.com/v3/global/merchant/h5/permission/domain/applications
請(qǐng)求方式:POST
參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
子商戶號(hào) | sub_mchid | string[1, 32] | 否 | Body 當(dāng)前機(jī)構(gòu)/服務(wù)商下的子商戶號(hào)。子商戶號(hào)不存在時(shí)表示修改父商戶的H5支付域名 注意:僅適用于機(jī)構(gòu)模式 示例值:2491935631 |
H5支付域名 | domains | array | 是 | Body 拉起H5支付的域名,不超過5個(gè)。 注意:提交的修改的域名列表審核通過后將會(huì)覆蓋已有支付域名列表。 示例值:["qq.com"] |
子商戶H5經(jīng)營(yíng)網(wǎng)址 | website_url | string[1, 128] | 是 | Body 包含該子商戶的主營(yíng)業(yè)務(wù)、銷售商品/服務(wù)及價(jià)格、用戶可在線下單購(gòu)買的網(wǎng)址 示例值:https://qq.com |
經(jīng)營(yíng)網(wǎng)址商業(yè)頁面截圖 | website_business_page_pics | array | 否 | Body 若經(jīng)營(yíng)網(wǎng)址未上線,則此字段必傳。Media ID,通過上傳圖片API獲得 示例值:["6uqyGjvHzOhsLleGFQVRF"] |
經(jīng)營(yíng)網(wǎng)址首頁截圖 | website_homepage_pics | array | 否 | Body 若經(jīng)營(yíng)網(wǎng)址未上線,則此字段必傳。Media ID,通過上傳圖片API獲得 示例值:["6uqyGjvHzOhsLleGFQVRF"] |
子商戶經(jīng)營(yíng)網(wǎng)址狀態(tài) | website_state | string | 否 | Body
子商戶經(jīng)營(yíng)網(wǎng)址狀態(tài),包括已上線和未上線。不傳默認(rèn)表示已上線 HAS_LAUNCHED:經(jīng)營(yíng)網(wǎng)址已上線 UN_LAUNCHED:經(jīng)營(yíng)網(wǎng)址未上線 注意:僅適用于機(jī)構(gòu)模式 示例值:HAS_LAUNCHED |
商戶提供的審核結(jié)果回調(diào)接口 | notify_url | string[1, 128] | 否 | Body 必須為https協(xié)議。如果鏈接無法訪問,商戶將無法接收到微信通知。 通知url必須為直接可訪問的url,不能攜帶參數(shù)。 《域名修改回調(diào)文檔》 示例值:http://www.tg885.com/wxpay/pay.action |
商戶申請(qǐng)單號(hào) | out_applyment_id | string[6, 32] | 是 | Body商戶系統(tǒng)內(nèi)部申請(qǐng)單號(hào),只能是數(shù)字、大小寫字母_-*且在同一個(gè)商戶號(hào)下唯一 示例值:123456 |
{
"domains": "",
"notify_url": "http://www.tg885.com/wxpay/pay.action",
"sub_mchid": "2491935631",
"website_business_page_pics": "",
"website_homepage_pics": "",
"website_state": "HAS_LAUNCHED",
"website_url": "https://qq.com",
"out_applyment_id": "123456"
}
參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
子商戶號(hào) | sub_mchid | string[1, 32] | 是 | 當(dāng)前機(jī)構(gòu)/服務(wù)商下的子商戶號(hào) 注意:僅適用于機(jī)構(gòu)模式 示例值:2491935631 |
子商戶經(jīng)營(yíng)網(wǎng)址狀態(tài) | website_state | string | 是 | 子商戶經(jīng)營(yíng)網(wǎng)址狀態(tài),包括已上線和未上線 HAS_LAUNCHED:經(jīng)營(yíng)網(wǎng)址已上線 UN_LAUNCHED:經(jīng)營(yíng)網(wǎng)址未上線 示例值:HAS_LAUNCHED |
H5支付域名 | domains | array | 是 | Body 拉起H5支付的域名,不超過5個(gè)。 注意:提交的修改的域名列表審核通過后將會(huì)覆蓋已有支付域名列表。 示例值:["qq.com"] |
子商戶H5經(jīng)營(yíng)網(wǎng)址 | webiste_url | string[1, 128] | 是 | 包含該子商戶的主營(yíng)業(yè)務(wù)、銷售商品/服務(wù)及價(jià)格、用戶可在線下單購(gòu)買的網(wǎng)址。 注意:僅適用于機(jī)構(gòu)模式 示例值:https://qq.com |
經(jīng)營(yíng)網(wǎng)址商業(yè)頁面截圖 | website_business_page_pics | array | 否 | 若經(jīng)營(yíng)網(wǎng)址未上線,則此字段必傳。Media ID,通過上傳圖片API獲得 示例值:["6uqyGjvHzOhsLleGFQVRF"] |
經(jīng)營(yíng)網(wǎng)址首頁截圖 | website_homepage_pics | array | 否 | 若經(jīng)營(yíng)網(wǎng)址未上線,則此字段必傳。Media ID,通過上傳圖片API獲得 示例值:["6uqyGjvHzOhsLleGFQVRF"] |
申請(qǐng)單號(hào) | applyment_id | int | 是 | 申請(qǐng)單的唯一標(biāo)識(shí) 示例值:1000000 |
駁回原因 | audit_reject_detail | string[1, 500] | 否 | 申請(qǐng)單被駁回的原因,當(dāng)申請(qǐng)單被駁回時(shí)此字段會(huì)顯示具體的駁回原因 示例值:經(jīng)營(yíng)網(wǎng)址首頁截圖內(nèi)容違法 |
申請(qǐng)單狀態(tài) | applyment_state | string | 否 | H5支付域名修改申請(qǐng)單狀態(tài) PENDING:待創(chuàng)建,申請(qǐng)單暫未創(chuàng)建,可稍后查詢或檢查進(jìn)件狀態(tài)是否正常 UNDER_REVIEW:審核中,申請(qǐng)單已創(chuàng)建,并且已進(jìn)入審核階段 APPROVED:已通過,申請(qǐng)單已審核通過 REJECTED:已駁回,申請(qǐng)單已駁回,請(qǐng)留意駁回原因字段 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 |
商戶申請(qǐng)單號(hào) | out_applyment_id | string[6, 32] | 是 | 商戶系統(tǒng)內(nèi)部申請(qǐng)單號(hào),只能是數(shù)字、大小寫字母_-*且在同一個(gè)商戶號(hào)下唯一 示例值:123456 |
參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
返回狀態(tài)碼 | code | string[1, 32] | 是 | 錯(cuò)誤碼,枚舉值見錯(cuò)誤碼列表 示例值:INVALID_REQUEST |
返回信息 | message | string[1, 256] | 是 | 返回信息,如非空,為錯(cuò)誤原因 示例值:參數(shù)格式校驗(yàn)錯(cuò)誤 |
詳細(xì)的錯(cuò)誤描述 | detail | object | 否 | 當(dāng)code為PARAM_ERROR時(shí)返回,詳細(xì)說明見下 |
{
"applyment_id": 1000000,
"applyment_state": "PENDING",
"audit_reject_detail": "經(jīng)營(yí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"
}
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
500 | SYSTEM_ERROR | 系統(tǒng)錯(cuò)誤 | 系統(tǒng)異常,請(qǐng)使用相同參數(shù)稍后重新調(diào)用 |
429 | FREQUENCY_LIMIT_EXCEED | 頻率過快,請(qǐng)稍后重試 | 頻率過快,請(qǐng)稍后重試 |
400 | INVALID_REQUEST | 未獲得H5支付權(quán)限,禁止修改H5域名 | 先完成H5支付權(quán)限申請(qǐng)后重新發(fā)起調(diào)用 |
400 | PARAM_ERROR | 經(jīng)營(yíng)網(wǎng)址未上線,請(qǐng)上傳經(jīng)營(yíng)服務(wù)頁面截圖 | 上傳經(jīng)營(yíng)網(wǎng)址截圖后重新發(fā)起調(diào)用 |
400 | INVALID_REQUEST | 商戶基礎(chǔ)信息缺失,如商戶證書編號(hào)、聯(lián)系人、郵箱等,請(qǐng)登錄商戶平臺(tái)修改后再試。(機(jī)構(gòu)請(qǐng)?jiān)L問:機(jī)構(gòu)商戶平臺(tái);普通服務(wù)商請(qǐng)?jiān)L問:服務(wù)商平臺(tái)) | 商戶資料缺失,請(qǐng)?jiān)L問對(duì)應(yīng)的鏈接進(jìn)行補(bǔ)充后重新提交 |
400 | INVALID_REQUEST | 商戶證書過期,請(qǐng)登錄商戶平臺(tái)更新后再試。(機(jī)構(gòu)請(qǐng)?jiān)L問:機(jī)構(gòu)商戶平臺(tái);普通服務(wù)商請(qǐng)?jiān)L問:服務(wù)商平臺(tái)) | 商戶證書過期,請(qǐng)?jiān)L問對(duì)應(yīng)的鏈接進(jìn)行修改后重新提交 |
400 | INVALID_REQUEST | 提交的H5經(jīng)營(yíng)網(wǎng)址或支付域名存在風(fēng)險(xiǎn),請(qǐng)聯(lián)系對(duì)接BD處理。 | 經(jīng)營(yíng)網(wǎng)址或者H5支付域名命中黑名單,請(qǐng)聯(lián)系運(yùn)營(yíng)人員申請(qǐng)豁免 |
400 | INVALID_REQUEST | 父子關(guān)系有誤,請(qǐng)檢查子商戶是否屬于該服務(wù)商。 | 父子商戶關(guān)系不成立,請(qǐng)核實(shí)后重試 |
400 | PARAM_ERROR | 經(jīng)營(yíng)網(wǎng)址未上線,請(qǐng)上傳經(jīng)營(yíng)網(wǎng)址首頁截圖 | 請(qǐng)上傳首頁截圖再發(fā)起重試 |
400 | PARAM_ERROR | 請(qǐng)上傳公司注冊(cè)證書、公司介紹和業(yè)務(wù)描述 | 請(qǐng)上傳公司注冊(cè)證書、公司介紹和業(yè)務(wù)描述后發(fā)起重試 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證