創(chuàng)建H5支付權(quán)限申請單
商戶可以通過調(diào)用此接口為子商戶申請H5支付權(quán)限。調(diào)用之前需要先簽署批量提交協(xié)議。如果限額類型(transaction_limit_type)選擇不限額度(NO_LIMIT),則在此申請單創(chuàng)建完成后,系統(tǒng)會未子商戶自動創(chuàng)建解除限額申請單。發(fā)起解除限額申請時,需要確保商戶已經(jīng)獲得了普通限額的支付權(quán)限。
商戶可以通過調(diào)用此接口為子商戶申請H5支付權(quán)限。調(diào)用之前需要先簽署批量提交協(xié)議。如果限額類型(transaction_limit_type)選擇不限額度(NO_LIMIT),則在此申請單創(chuàng)建完成后,系統(tǒng)會未子商戶自動創(chuàng)建解除限額申請單。發(fā)起解除限額申請時,需要確保商戶已經(jīng)獲得了普通限額的支付權(quán)限。
? 因產(chǎn)品迭代,H5支付權(quán)限可使用子商戶進件接口申請。
? 詳情查看:
子商戶進件(產(chǎn)品介紹)
子商戶進件(接入前準備)
子商戶進件(開發(fā)指引)
子商戶進件(API列表)
適用對象: 從業(yè)機構(gòu)(支付機構(gòu))
請求URL:https://apihk.mch.weixin.qq.com/v3/global/merchant/h5/permission/applications
請求方式:POST
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
公司介紹和業(yè)務(wù)描述 | business_description | string[1, 500] | 否 | Body 若選擇了無限額交易類型,則此字段必須上傳 示例值:騰訊于1998年11月成立,是一家互聯(lián)網(wǎng)公司,通過技術(shù)豐富互聯(lián)網(wǎng)用戶的生活,助力企業(yè)數(shù)字化升級。我們的使命是“用戶為本 科技向善” |
子商戶號 | sub_mchid | string[1, 32] | 是 | Body 當前機構(gòu)/服務(wù)商下的子商戶號 注意:僅適用于機構(gòu)模式 示例值:2491935631 |
H5支付域名 | domains | array | 是 | Body 拉起H5支付的域名,不超過5個。 注意:提交的修改的域名列表審核通過后將會覆蓋已有支付域名列表。 示例值:["qq.com"] |
公司注冊資質(zhì)證書 | company_register_cert | string[1, 32] | 否 | Body 若選擇了無限額交易類型,則此字段必須上傳。Media ID,通過上傳圖片API獲得 示例值:6uqyGjvHzOhsLleGFQVRF |
限額類型 | transaction_limit_type | string | 否 | Body H5支付限額類型,包括測試網(wǎng)址限額、普通限額、不限額。不傳默認為普通限額 限制額度:① 1000 CNY/day/person 觸及H5支付交易額度,該客戶當天無法通過H5渠道向該子商戶支付(次日重新累計) ② 50000 CNY/day/sub-merchant 觸及H5支付交易額度,該子商戶當天無法通過H5渠道收款(次日重新累計) UN_LAUNCHED_WEBSITE_LIMIT:未上線經(jīng)營網(wǎng)址支付額度 限制額度: ① 50000 CNY/day/person,如觸及H5支付限額支付限額,則該客戶當天無法通過H5渠道向該子商戶支付(次日重新累積) ② 500000 CNY/day/sub-merchant,如觸及H5支付限額額度, 該子商戶當天無法通過H5渠道收款(次日重新累計) NORMAL_LIMIT:未補充完整資料時獲得普通支付額度 NO_LIMIT:無支付額度限制 示例值:UN_LAUNCHED_WEBSITE_LIMIT |
經(jīng)營網(wǎng)址商業(yè)頁面截圖 | website_business_page_pics | array | 否 | Body 若經(jīng)營網(wǎng)址未上線,則此字段必傳。Media ID,通過上傳圖片API獲得 示例值:["6uqyGjvHzOhsLleGFQVRF"] |
經(jīng)營網(wǎng)址首頁截圖 | website_homepage_pics | array | 否 | Body 若經(jīng)營網(wǎng)址未上線,則此字段必傳。Media ID,通過上傳圖片API獲得 示例值:["6uqyGjvHzOhsLleGFQVRF"] |
子商戶經(jīng)營網(wǎng)址狀態(tài) | website_state | string | 否 | Body 子商戶經(jīng)營網(wǎng)址狀態(tài),包括已上線和未上線,不傳默認表示已上線 HAS_LAUNCHED:經(jīng)營網(wǎng)址已上線 UN_LAUNCHED:經(jīng)營網(wǎng)址未上線 示例值:HAS_LAUNCHED |
子商戶H5經(jīng)營網(wǎng)址 | website_url | string[1, 128] | 是 | Body 包含該子商戶的主營業(yè)務(wù)、銷售商品/服務(wù)及價格、用戶可在線下單購買的網(wǎng)址。 示例值:https://qq.com |
商戶提供的審核結(jié)果回調(diào)接口 | notify_url | string[1, 128] | 否 | Body必須為https協(xié)議。如果鏈接無法訪問,商戶將無法接收到微信通知。 通知url必須為直接可訪問的url,不能攜帶參數(shù)。 《權(quán)限申請回調(diào)文檔》 示例值:http://www.tg885.com/wxpay/pay.action |
申請單類型 | applyment_type | string | 否 | Body
H5支付權(quán)限申請單類型,包括H5支付權(quán)限申請和解除H5支付限額申請。不傳默認為H5支付權(quán)限申請 APPLY_FOR_PAYMENT_AUTHORITY:申請H5支付權(quán)限 APPLY_FOR_RELIEVE_LIMITED:申請解除H5支付限額 示例值:APPLY_FOR_PAYMENT_AUTHORITY |
{
"applyment_type": "APPLY_FOR_PAYMENT_AUTHORITY",
"company_register_cert": "6uqyGjvHzOhsLleGFQVRF",
"domains": "",
"notify_url": "http://www.tg885.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"
}
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
子商戶號 | sub_mchid | string[1, 32] | 是 | 當前機構(gòu)/服務(wù)商下的子商戶號 注意:僅適用于機構(gòu)模式 示例值:2491935631 |
H5支付域名 | domains | array | 是 | 拉起H5支付的域名,不超過5個。 注意:提交的修改的域名列表審核通過后將會覆蓋已有支付域名列表。 示例值:["qq.com"] |
公司介紹和業(yè)務(wù)描述 | business_description | string[1, 500] | 否 | 若選擇了無限額交易類型,則此字段必須上傳 示例值:騰訊于1998年11月成立,是一家互聯(lián)網(wǎng)公司,通過技術(shù)豐富互聯(lián)網(wǎng)用戶的生活,助力企業(yè)數(shù)字化升級。我們的使命是“用戶為本 科技向善” |
限額類型 | 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:未上線經(jīng)營網(wǎng)址支付額度 NORMAL_LIMIT:未補充完整資料時獲得普通支付額度 限制額度:① 50000 CNY/day/person,如觸及H5支付限額支付限額,則該客戶當天無法通過H5渠道向該子商戶支付(次日重新累積) ② 500000 CNY/day/sub-merchant,如觸及H5支付限額額度, 該子商戶當天無法通過H5渠道收款(次日重新累計) NO_LIMIT:無支付額度限制 示例值:UN_LAUNCHED_WEBSITE_LIMIT |
公司注冊資質(zhì)證書 | company_register_cert | string[1, 128] | 否 | 當選擇不限額度的支付類型,此字段必傳 示例值:6uqyGjvHzOhsLleGFQVRF |
經(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"] |
子商戶經(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)址未上線 示例值:HAS_LAUNCHED |
子商戶H5經(jīng)營網(wǎng)址 | website_url | string[1, 128] | 是 | 包含該子商戶的主營業(yè)務(wù)、銷售商品/服務(wù)及價格、用戶可在線下單購買的網(wǎng)址。 示例值:https://qq.com |
申請單號 | applyment_id | int | 是 | 申請單的唯一標識 示例值:100000 |
駁回原因 | audit_reject_detail | string[1, 500] | 否 | 申請單被駁回的原因,當申請單被駁回時此字段會顯示具體的駁回原因 示例值:商戶證書不符合要求 |
申請單狀態(tài) | applyment_state | string | 是 | H5支付申請單狀態(tài) PENDING:待創(chuàng)建,申請單暫未創(chuàng)建,可稍后查詢或檢查進件狀態(tài)是否正常 UNDER_REVIEW:審核中,申請單已創(chuàng)建,并且已進入審核階段 APPROVED:已通過,申請單已審核通過 REJECTED:已駁回,申請單已駁回,請留意駁回原因字段 audit_reject_detail 示例值:PENDING |
申請單類型 | applyment_type | string | 是 | H5支付權(quán)限申請單類型,包括H5支付權(quán)限申請和解除H5支付限額申請 APPLY_FOR_PAYMENT_AUTHORITY:申請H5支付權(quán)限 APPLY_FOR_RELIEVE_LIMITED:申請解除H5支付限額 示例值:APPLY_FOR_PAYMENT_AUTHORITY |
商戶提供的審核結(jié)果回調(diào)接口 | notify_url | string[1, 128] | 否 | 必須為https協(xié)議。如果鏈接無法訪問,商戶將無法接收到微信通知。 通知url必須為直接可訪問的url,不能攜帶參數(shù)。 《權(quán)限申請回調(diào)文檔》 示例值:http://www.tg885.com/wxpay/pay.action |
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
返回狀態(tài)碼 | code | string[1, 32] | 是 | 錯誤碼,枚舉值見錯誤碼列表 示例值:INVALID_REQUEST |
返回信息 | message | string[1, 256] | 是 | 返回信息,如非空,為錯誤原因 示例值:參數(shù)格式校驗錯誤 |
詳細的錯誤描述 | detail | object | 否 | 當code為PARAM_ERROR時返回,詳細說明見下 |
{
"applyment_id": 100000,
"applyment_state": "PENDING",
"applyment_type": "APPLY_FOR_PAYMENT_AUTHORITY",
"audit_reject_detail": "商戶證書不符合要求",
"business_description": "騰訊于1998年11月成立,是一家互聯(lián)網(wǎng)公司,通過技術(shù)豐富互聯(lián)網(wǎng)用戶的生活,助力企業(yè)數(shù)字化升級。我們的使命是“用戶為本 科技向善”",
"company_register_cert": "6uqyGjvHzOhsLleGFQVRF",
"domains": "",
"notify_url": "http://www.tg885.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"
}
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 系統(tǒng)異常,請使用相同參數(shù)稍后重新調(diào)用 |
429 | FREQUENCY_LIMIT_EXCEED | 頻率過快,請稍后重試 | 頻率過快,請稍后重試 |
400 | INVALID_REQUEST | 已獲得支付權(quán)限,禁止再次發(fā)起測試網(wǎng)址權(quán)限申請 | 已獲得支付權(quán)限,禁止再次申請測試網(wǎng)址支付權(quán)限申請 |
400 | PARAM_ERROR | 該接口創(chuàng)建申請單時,限額類型需為“無限額”。 | 發(fā)起解除限額申請時,限額類型需要為 "No transaction limited" |
400 | PARAM_ERROR | 僅支持“已上線”狀態(tài)的經(jīng)營網(wǎng)址申請解除限額。其他狀態(tài)的網(wǎng)址如需調(diào)整權(quán)限狀態(tài)請調(diào)用“H5支付權(quán)限申請”接口。 | 將經(jīng)營網(wǎng)址狀態(tài)改為HAS_LAUNCHED后重新發(fā)起調(diào)用 |
400 | PARAM_ERROR | 經(jīng)營網(wǎng)址未上線,請上傳經(jīng)營服務(wù)頁面截圖 | 上傳經(jīng)營網(wǎng)址截圖后重新發(fā)起調(diào)用 |
400 | INVALID_REQUEST | 商戶基礎(chǔ)信息缺失,如商戶證書編號、聯(lián)系人、郵箱等,請登錄商戶平臺修改后再試。(機構(gòu)請訪問:機構(gòu)商戶平臺;普通服務(wù)商請訪問:服務(wù)商平臺) | 商戶資料缺失,請訪問對應(yīng)的鏈接進行補充后重新提交 |
400 | INVALID_REQUEST | 商戶證書過期,請登錄商戶平臺更新后再試。(機構(gòu)請訪問:機構(gòu)商戶平臺;普通服務(wù)商請訪問:服務(wù)商平臺) | 商戶證書過期,請訪問對應(yīng)的鏈接進行修改后重新提交 |
400 | INVALID_REQUEST | 僅支持“正式限額”狀態(tài)的子商戶申請解除限額。其他狀態(tài)的子商戶如需調(diào)整權(quán)限狀態(tài)請調(diào)用“H5支付權(quán)限申請”接口。 | 先申請獲得限額的H5支付權(quán)限后再發(fā)起解除限額申請 |
400 | INVALID_REQUEST | 商戶被處罰,不允許申請開通H5支付權(quán)限。 | 商戶支付權(quán)限被處罰,請先聯(lián)系運營人員解除 |
400 | INVALID_REQUEST | 提交的H5經(jīng)營網(wǎng)址或支付域名存在風險,請聯(lián)系對接BD處理。 | 經(jīng)營網(wǎng)址或者H5支付域名命中黑名單,請聯(lián)系運營人員申請豁免 |
400 | INVALID_REQUEST | 已有流程中的申請單,請勿重復提交。 | 請耐心等待,在流程結(jié)束后再次提交 |
400 | INVALID_REQUEST | 父子關(guān)系有誤,請檢查子商戶是否屬于該服務(wù)商。 | 父子商戶關(guān)系不成立,請核實后重試 |
400 | PARAM_ERROR | 請上傳公司注冊證書、公司介紹和業(yè)務(wù)描述。 | 請上傳公司注冊證書、公司介紹和業(yè)務(wù)描述后發(fā)起重試 |
400 | INVALID_REQUEST | 經(jīng)營網(wǎng)址未上線,僅能申請測試限額。 | 限額類型請選擇UN_LAUNCHED_WEBSITE_LIMIT后重試 |
400 | INVALID_REQUEST | 當前子商戶已享有無限額H5支付權(quán)限,請勿重復提交申請單 | 已獲得無限額的支付權(quán)限,請勿重復提交申請 |
403 | NO_AUTH | 請登錄商戶平臺 H5 Payment Application 頁面點擊 +Batch Apply按鈕完成批量上傳協(xié)議簽署后再發(fā)起調(diào)用 | 請登錄商戶平臺 H5 Payment Application 頁面點擊 +Batch Apply按鈕完成批量上傳協(xié)議簽署后再發(fā)起調(diào)用 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證