電商平臺,可使用該接口,幫助其二級商戶進件成為微信支付商戶。
流程指引請看二級商戶進件流程
注意
# 接口說明
支持商戶:
【平臺商戶】
請求方式:
【POST】/v3/ecommerce/applyments/
請求域名:
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點 ,指引點擊查看
接口頻率: 15QPS(商戶號維度)
是否支持冪等: 是
# 請求參數(shù)
Header HTTP頭參數(shù)
- out_request_no 必填 string(124)【業(yè)務申請編號】
1、服務商自定義的商戶唯一編號。
2、每個編號對應一個申請單,每個申請單審核通過后會生成一個微信支付商戶號。
3、若申請單被駁回,可填寫相同的“業(yè)務申請編號”,即可覆蓋修改原申請單信息 。 - organization_type 必填 string(4)【主體類型】
非小微的主體類型需與營業(yè)執(zhí)照/登記證書上一致,可參考選擇主體指引,枚舉值如下。2401
:小微商戶,指無營業(yè)執(zhí)照的個人商家。2500
:個人賣家,指無營業(yè)執(zhí)照,已持續(xù)從事電子商務經(jīng)營活動滿6個月,且期間經(jīng)營收入累計超過20萬元的個人商家。(若選擇該主體,請在“補充說明”填寫相關(guān)描述)。4
:個體工商戶,營業(yè)執(zhí)照上的主體類型一般為個體戶、個體工商戶、個體經(jīng)營。2
:企業(yè),營業(yè)執(zhí)照上的主體類型一般為有限公司、有限責任公司。3
:事業(yè)單位,包括國內(nèi)各類事業(yè)單位,如:醫(yī)療、教育、學校等單位。2502
:政府機關(guān),包括各級、各類政府機關(guān),如機關(guān)黨委、稅務、民政、人社、工商、商務、市監(jiān)等。1708
:社會組織,包括社會團體、民辦非企業(yè)、基金會、基層群眾性自治組織、農(nóng)村集體經(jīng)濟組織等組織。 - finance_institution 選填 boolean【是否金融機構(gòu)】
選填,請根據(jù)申請主體的實際情況填寫,可參考選擇金融機構(gòu)指引:
1、若商戶主體是金融機構(gòu),則填寫:true。
2、若商戶主體不是金融機構(gòu),則填寫:false。
若未傳入將默認填寫:false。 - business_license_info 選填 BusinessLicense【營業(yè)執(zhí)照信息】
1、主體為“小微/個人賣家”時,不填。
2、主體為“個體工商戶/企業(yè)”時,請上傳營業(yè)執(zhí)照。
3、主體為“政府機關(guān)/事業(yè)單位/社會組織”時,請上傳登記證書。- 屬性
- finance_institution_info 選填 object【金融機構(gòu)許可證信息】
當主體是金融機構(gòu)時,必填- 屬性
- id_holder_type 選填 string【證件持有人類型】
1. 主體類型為政府機關(guān)/事業(yè)單位時選傳:
(1)若上傳的是法人證件,則不需要上傳該字段。
(2)若因政策保密等原因,無法提供法人證件時,可上傳經(jīng)辦人。 (經(jīng)辦人:經(jīng)商戶授權(quán)辦理微信支付業(yè)務的人員,授權(quán)范圍包括但不限于簽約,入駐過程需完成賬戶驗證)。
2. 主體類型為企業(yè)/個體戶/社會組織時,默認為經(jīng)營者/法人,不需要上傳該字段。LEGAL
: 法人SUPER
: 經(jīng)辦人 - id_doc_type 選填 string【經(jīng)營者/法人證件類型】
1、當證件持有人類型為經(jīng)營者/法人時,需要填寫。其他情況,無需上傳。
2、主體為“小微/個人賣家”,可選擇:身份證。
3、主體為“個體戶/企業(yè)/事業(yè)單位/社會組織”:可選擇任一證件類型,主體為“政府機關(guān)”僅支持中國大陸居民-身份證類型。
4、若沒有填寫,系統(tǒng)默認選擇:身份證。
枚舉值:IDENTIFICATION_TYPE_MAINLAND_IDCARD
: 中國大陸居民-身份證IDENTIFICATION_TYPE_OVERSEA_PASSPORT
: 其他國家或地區(qū)居民-護照IDENTIFICATION_TYPE_HONGKONG
: 中國香港居民--來往內(nèi)地通行證IDENTIFICATION_TYPE_MACAO
: 中國澳門居民--來往內(nèi)地通行證IDENTIFICATION_TYPE_TAIWAN
: 中國臺灣居民--來往大陸通行證IDENTIFICATION_TYPE_FOREIGN_RESIDENT
: 外國人居留證IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT
: 港澳居民證IDENTIFICATION_TYPE_TAIWAN_RESIDENT
: 臺灣居民證 - authorize_letter_copy 選填 string
- id_card_info 選填 object【經(jīng)營者/法人身份證信息】
當證件持有人類型為經(jīng)營者/法人且證件類型為“身份證”時填寫。- 屬性
- id_doc_info 選填 object【經(jīng)營者/法人其他類型證件信息】
當證件持有人類型為經(jīng)營者/法人且證件類型不為“身份證”時填寫。- 屬性
- owner 選填 boolean【經(jīng)營者/法人是否為受益人】
主體類型為企業(yè)時,需要填寫:
1、若經(jīng)營者/法人是最終受益人,則填寫:true。
2、若經(jīng)營者/法人不是最終受益人,則填寫:false。
注:12月 - ubo_info_list 選填 array【最終受益人信息列表】
僅企業(yè)需要填寫。
若經(jīng)營者/法人不是最終受益所有人,則需提填寫受益所有人信息,最多上傳4個。
若經(jīng)營者/法人是最終受益所有人之一,可在此填寫其他受益所有人信息,最多上傳3個。
根據(jù)國家相關(guān)法律法規(guī),需要提供公司受益所有人信息,受益所有人需符合至少以下條件之一:
1、直接或者間接擁有超過25%公司股權(quán)或者表決權(quán)的自然人。
2、通過人事、財務等其他方式對公司進行控制的自然人。
3、公司的高級管理人員,包括公司的經(jīng)理、副經(jīng)理、財務負責人、上市公司董事會秘書和公司章程規(guī)定的其他人員。- 數(shù)組
- account_info 必填 object【結(jié)算賬戶信息】
請?zhí)顚懮碳姨岈F(xiàn)收款的銀行賬戶信息。- 屬性
- contact_info 必填 object【超級管理員信息】
請?zhí)顚懙赇伒某壒芾韱T信息。
超級管理員需在開戶后進行簽約,并可接收日常重要管理信息和進行資金操作,請確定其為商戶法定代表人或負責人。- 屬性
- sales_scene_info 必填 object【店鋪信息】
請?zhí)顚懙赇佇畔?/div>- 屬性
settlement_info 選填 object【結(jié)算規(guī)則】
請?zhí)顚懮碳业慕Y(jié)算費率規(guī)則、所屬行業(yè)等信息。若電商平臺未傳入,系統(tǒng)將填寫默認值- 屬性
merchant_shortname 必填 string(64)【商戶簡稱】
UTF-8格式,中文占3個字節(jié),即最多21個漢字長度。將在支付完成頁向買家展示,需與商家的實際售賣商品相符.qualifications 選填 string(1024)【特殊資質(zhì)】
1、僅當商戶選擇了必需提交特殊資質(zhì)的行業(yè)時,需要提供該項資料;若商戶選擇了無需特殊資質(zhì)的行業(yè),或未選擇行業(yè)時,無需提交該項資料,詳情查看《行業(yè)對應特殊資質(zhì)》;
2、請?zhí)峁椤吧暾埳碳抑黧w”所屬的特殊資質(zhì),可授權(quán)使用總公司/分公司的特殊資質(zhì);
3、最多可上傳5張照片,請?zhí)顚懲ㄟ^圖片上傳API預先上傳圖片生成好的MediaID。 business_addition_pics 選填 string(1024)【補充材料】
根據(jù)實際審核情況,額外要求提供。最多可上傳15張照片,請?zhí)顚懲ㄟ^圖片上傳API預先上傳圖片生成好的MediaID 。 business_addition_desc 選填 string(512)【補充說明】
若主體為“個人賣家”,該字段必傳,則需填寫描述“ 該商戶已持續(xù)從事電子商務經(jīng)營活動滿6個月,且期間經(jīng)營收入累計超過20萬元。”
Body 包體參數(shù)
請求示例
POST
# 應答參數(shù)
- applyment_id 必填 integer【微信支付申請單號】
微信支付分配的申請單號 。 - out_request_no 必填 string【業(yè)務申請編號】
服務商自定義的商戶唯一編號。每個編號對應一個申請單,每個申請單審核通過后會生成一個微信支付商戶號。
200OK
應答示例
200 OK
# 錯誤碼
# 公共錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 參數(shù)錯誤 | 請根據(jù)錯誤提示正確傳入?yún)?shù) |
400 | INVALID_REQUEST | HTTP 請求不符合微信支付 APIv3 接口規(guī)則 | 請參閱 接口規(guī)則 |
401 | SIGN_ERROR | 驗證不通過 | 請參閱 簽名常見問題 |
500 | SYSTEM_ERROR | 系統(tǒng)異常,請稍后重試 | 請稍后重試 |
# 業(yè)務錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | RESOURCE_ALREADY_EXISTS | 存在流程進行中的申請單,請檢查是否重入 | 可通過查詢申請狀態(tài)查看此申請單的申請狀態(tài),或更換out_request_no提交新的申請單 |
403 | NO_AUTH | 商戶權(quán)限異常 | 請確認是否已經(jīng)開通相關(guān)權(quán)限 |
404 | RESOURCE_NOT_EXISTS | 申請單不存在 | 確認入?yún)ⅲ瑐魅胝_的申請單編號 |
文檔是否有幫助
商戶文檔
更多支持