商戶/服務(wù)商在接入前首先要判斷自己公司注冊區(qū)域適用的接入模式,微信支付目前提供兩種接入方式:直連模式和服務(wù)商模式。
信息、資金流:微信支付—>直連商戶
直連模式,商戶自行申請入駐微信支付,無需服務(wù)商協(xié)助。(商戶平臺申請)成為直連商戶
直連模式相關(guān)說明詳見:直連模式介紹
—— 信息流 —— 資金流
服務(wù)商模式,商戶申請成為微信支付服務(wù)商,服務(wù)商自身無法作為一個直連商戶直接發(fā)起交易,其發(fā)起交易必須傳入相關(guān)特約商戶商戶號的參數(shù)信息。(服務(wù)商平臺申請)成為服務(wù)商
請結(jié)合自身實際情況來選擇接入模式。
由于微信支付的產(chǎn)品體系全部搭載于微信的社交體系之上,所以直連商戶或服務(wù)商接入微信支付之前,都需要有一個微信社交載體,該載體對應(yīng)的ID即為APPID。
目前服務(wù)商的社交載體只能是公眾號,服務(wù)商可通過公眾平臺完成公眾號注冊申請。
公眾號申請成功后,服務(wù)商可登錄公眾號平臺即可獲取對應(yīng)的APPID,具體查閱目錄為 【開發(fā)-> 基本配置-> 公眾號開發(fā)信息】,如下圖所示。通常情況下,一個服務(wù)商只需申請一個公眾號即可。
服務(wù)商的收款賬號即是mchid,申請mchid和APPID的操作互不影響,可以并行操作,申請地址如下: 商戶號申請指引
mchid申請成功后,微信支付將下發(fā)通知郵件至機構(gòu)填寫的聯(lián)系郵箱,內(nèi)容包含申請成功的mchid及其登錄賬號密碼,請妥善保存。
注意:一個mchid只能對應(yīng)一個結(jié)算幣種,若需要使用多個幣種收款,需要申請對應(yīng)數(shù)量的mchid。
APPID和mchid全部申請完畢后,需要建立兩者之間的綁定關(guān)系。
服務(wù)商可登錄服務(wù)商平臺,【產(chǎn)品中心-> AppID管理】目錄下即可完成綁定。
服務(wù)商模式下,一個APPID下可綁定多個mchid,一個mchid可綁定3個APPID。
上述步驟操作完成后,即會向服務(wù)商開放入駐子商戶權(quán)限。
服務(wù)商可登錄服務(wù)商平臺進入【服務(wù)商功能】界面完成子商戶入駐。
API v3密鑰主要用于平臺證書解密、回調(diào)信息解密,具體使用方式可參見接口規(guī)則文檔中證書和回調(diào)報文解密章節(jié)。
請根據(jù)以下步驟配置API key:
商戶API證書具體使用說明可參見接口規(guī)則文檔中私鑰和證書章節(jié)
服務(wù)商可登錄微信服務(wù)商平臺,在【賬戶中心 -> API安全】目錄下載證書
以下為具體下載步驟:
步驟1 在【商戶平臺】-“復制證書串”環(huán)節(jié),點擊“復制證書串”按鈕后;
步驟2 在【證書工具】-“復制請求串”環(huán)節(jié),點擊“下一步”按鈕進入“粘貼證書串”環(huán)節(jié);
步驟3 在【證書工具】-“粘貼證書串”環(huán)節(jié),點擊“粘貼”按鈕后;
步驟4 點擊“下一步”按鈕,進入【證書工具】-“生成證書”環(huán)節(jié)
平臺接入流程示意圖:
平臺入駐微信支付平臺,在微信支付后臺的合作工具箱中找到平臺收付通,簽署協(xié)議后進行申請開通。開通平臺收付通后,平臺需要完成商戶號和當前電商業(yè)務(wù)主要場景(如公眾號、小程序、APP)APPID的線上綁定,方可進行下一步接口對接。入駐指引詳見:平臺收付通接入指引
開通須知:
1、 平臺開通平臺收付通前,需確保在本平臺沒有已經(jīng)入駐或處于入駐流程中的二級商戶。
2、 因平臺特殊性,平臺將默認關(guān)閉平臺商戶號非必要權(quán)限。
3、 開通時可以選擇支付手續(xù)費由平臺承擔或者二級商戶承擔,當由平臺承擔手續(xù)費時,微信支付將給平臺開具發(fā)票。
平臺承擔手續(xù)費時,將默認開通手續(xù)費賬戶,平臺需確保手續(xù)費賬戶余額充足,否則將影響正常結(jié)算。
平臺獲得二級商戶授權(quán)后,通過二級商戶進件接口提交二級商戶資料,進行二級商戶入駐申請。微信支付通過審核后,二級商戶完成簽約即完成入駐,則平臺可幫二級商戶發(fā)起交易、退款等行為。
僅支持平臺(已開通收付通工具箱)使用本接口。
支持進件的商戶類型如下所示:
類型 | 定義 | 所需資料 |
---|---|---|
小微 | 無營業(yè)執(zhí)照、免辦理工商注冊登記的商戶 | 需提供小微經(jīng)營者的個人身份證 |
個人賣家 | 無營業(yè)執(zhí)照,已持續(xù)從事電子商務(wù)經(jīng)營活動滿6個月,且期間經(jīng)營收入累計超過20萬元的個人商家(平臺需核實已滿足上述條件) | 需提供個人賣家的個人身份證 |
個體工商戶 | 營業(yè)執(zhí)照上的主體類型一般為個體戶、個體工商戶、個體經(jīng)營 | 需提供營業(yè)執(zhí)照、經(jīng)營者證件 |
企業(yè) | 營業(yè)執(zhí)照上的主體類型一般為有限公司、有限責任公司 | 需提供營業(yè)執(zhí)照、法人證件、組織機構(gòu)代碼證(未三證合一提供) |
黨政、機關(guān)及事業(yè)單位 | 包括國內(nèi)各級、各類政府機構(gòu)、事業(yè)單位等。如:公安、黨團、司法、交通、旅游、工商稅務(wù)、市政、醫(yī)療、教育、學校等機構(gòu) | 需提供登記證書、法人證件、組織機構(gòu)代碼證(未三證合一提供) |
其他組織 | 不屬于企業(yè)、政府/事業(yè)單位的組織機構(gòu),如社會團體、民辦非企業(yè)、基金會。要求機構(gòu)已辦理組織機構(gòu)代碼證。 | 需提供登記證書、法人證件、組織機構(gòu)代碼證(未三證合一提供) |
說明:
(1)小微主體
● 正常日收款額度為10萬,若交易良好則自動提升至20-30萬/日,若交易異常則自動下降至5萬以下/日。
● 信用卡單日收款不超過1千,信用卡單月收款不超過1萬。
(2)個人賣家
● 正常日收款額度為200萬,若交易良好則自動提升額度,若交易異常則下降額度;
● 無信用卡收款額度限制。
(3)其他主體類型,沒有收款額度限制;
審核、簽約、賬戶驗證,為三個并行流程。
(1)審核:指微信支付審核申請單資料,3~7個工作日完成;
(2)賬戶驗證:指判斷指定條件的商家,需通過指定方式核實開戶意愿,詳情可看下文。
(3)簽約:指商家超級管理員,使用微信打開指定頁面,核實簽約。
完成上述三個環(huán)節(jié),即完成入駐。
平臺API創(chuàng)建申請單后,可等待3秒后,通過查詢申請狀態(tài)API 獲取簽約鏈接及賬戶驗證信息(部分商戶需驗證),立即指引商家完成簽約及賬戶驗證,后續(xù)等待審核通過即完成入駐。
二級商戶進件申請單-狀態(tài)流轉(zhuǎn)
● 平臺需使用二級商戶進件API,提交二級商戶資料,創(chuàng)建入駐申請單。創(chuàng)建后,系統(tǒng)會在3s內(nèi)完成基本資料校驗。(即“資料校驗中”狀態(tài),包括:公司名稱,法人資料等校驗)
● 創(chuàng)建申請單后,可通過查詢申請狀態(tài)API,根據(jù)【applyment_state 申請單狀態(tài)】和【sign_state 簽約狀態(tài)】做對應(yīng)處理。
5.2.2.2.1. 簽約方式
方式一:根據(jù)字段【簽約狀態(tài) sign_state】判斷 (推薦,可極大提高入駐轉(zhuǎn)化率及縮短耗時)
(1) 提交申請單后(約3秒),可查詢字段【sign_state 簽約狀態(tài)】為“未簽約”時,則可查詢獲取簽約鏈接,引導商戶的超級管理員完成簽約。
說明:【applyment_state 申請單狀態(tài)】為“待賬戶驗證,審核中,待簽約”時,【簽約狀態(tài)】可能為“未簽約” or “已簽約”。
(2) 商戶完成簽約操作后,可查詢字段【簽約狀態(tài)】為“已簽約”,則商戶已完成簽約。完成賬戶驗證及審核通過后,則申請單自動扭轉(zhuǎn)為“已完成”狀態(tài),并完成入駐流程。
(3) 若已簽約,然后申請單被駁回,商戶修改以下資料,則需重新簽約,字段【簽約狀態(tài)】變?yōu)?“未簽約”
a. 商戶主體名稱、法人名稱;
b. 主體類型;
c. 超級管理員姓名、證件號碼;
(4) 若查詢字段“簽約狀態(tài)”為“不可簽約”,則不返回簽約鏈接。
說明:【申請單狀態(tài)】為“機器校驗中,已駁回,已凍結(jié)”,則【簽約狀態(tài)】為“不可簽約”;
方式二:根據(jù)字段【簽約狀態(tài) sign_state 】判斷
(1)當申請單狀態(tài)為“待簽約”時(即簽約狀態(tài)為“未簽約”),平臺需指引二級商戶,完成簽約。
5.2.2.2.2. 簽約邏輯說明
(1)需由管理員進行簽約,校驗掃碼的微信號-綁定銀行卡實名信息(姓名+身份證號),是否與申請單-管理員信息(姓名+身份證號)一致。
(2)超級管理員,在簽約頁面,可查看《微信支付服務(wù)協(xié)議(平臺二級商戶)》
(3)同一服務(wù)商下,一個微信號可進件5個小微及個人賣家
主體類型 | 超級管理員身份 | 賬戶驗證方式 |
---|---|---|
小微/個人賣家 | 法人/經(jīng)營者 | 無需驗證,直接進入“審核中”狀態(tài) |
個體工商戶 / 企業(yè) | 法人/經(jīng)營者 | 無需驗證,直接進入“審核中”狀態(tài) |
負責人 | 需賬戶驗證,進入“待賬戶驗證”狀態(tài) | |
黨政、機關(guān)及事業(yè)單位 /其他組織 | 法人/經(jīng)營者 | 需賬戶驗證,進入“待賬戶驗證”狀態(tài) |
負責人 |
當申請單狀態(tài)為“待賬戶驗證”時,平臺需指引二級商戶,完成賬戶驗證。
類型 | 定義 | 所需資料 |
---|---|---|
個體工商戶 / 企業(yè) | 法人/經(jīng)營者 | 無需賬戶驗證 |
負責人 | 支持以下方式二選一: 1、匯款驗證:商戶使用指定戶名的銀行賬戶,匯款指定金額至財付通指定銀行賬戶,完成驗證。(30天有效期) 2、法人掃碼:法人微信掃碼,完成驗證。(需系統(tǒng)校驗通過才支持該驗證方式,30天效期) |
|
黨政、機關(guān)及事業(yè)單位 /其他組織 | 法人/經(jīng)營者 | 匯款驗證:商戶使用指定戶名的銀行賬戶,匯款指定金額至財付通指定銀行賬戶,完成驗證。(30天有效期) |
負責人 |
說明:
● 賬戶驗證有效期,可通過《查詢申請狀態(tài)API》,查看“匯款截止時間”(account_validation/ deadline)。
● 30天內(nèi)未完成驗證,將自動駁回申請單。
● 若未超過30天,申請單被審核駁回,二級商戶可繼續(xù)進行驗證,完成賬戶驗證流程。再次提交申請單,則直接進入“審核中”狀態(tài)。
● 商戶匯款后,請等待1-2天,具體以銀行到賬時間為準。匯款金額,系統(tǒng)會自動退款至商戶的匯款銀行賬戶。
當申請單狀態(tài)為“審核中”時,3-7個工作日內(nèi),完成審核,請等待審核結(jié)果。
當申請單狀態(tài)為“已完成”時,則申請單完成入駐。平臺可通過查詢申請狀態(tài)API,查看獲取二級商戶號。
(1)完成入駐后,若申請單填寫了結(jié)算銀行信息,則商戶發(fā)起第一筆交易后,微信支付會匯款0.01元至該銀行卡,確認該銀行信息是否正確。
(2)平臺可通過“查詢結(jié)算賬戶API”,查詢匯款驗證結(jié)果,若匯款失敗則建議指引二級商戶修改結(jié)算銀行卡。
PS:當前僅驗證失敗時,API返回結(jié)果,可每隔1天查詢一次,查詢3天即可。
平臺收付通提供合單/普通支付能力。
合單支付適用于購物車場景的平臺,合單支付支持1-50個二級商戶的訂單一次性同時完成支付。
普通支付適用電商SAAS類服務(wù)商,每個二級商戶有單獨的小店(單獨小程序),無跨多店合并支付的場景。
當交易發(fā)生一段時間內(nèi)(一年內(nèi)),由于買家或者賣家原因需要退款時,二級商戶可以通過平臺發(fā)起訂單退款,查詢退款狀態(tài)。
基于平臺對于二級商戶實現(xiàn)賬期和平臺抽傭、分潤等訴求,平臺收付通提供分賬能力。
二級商戶發(fā)起交易時,可授權(quán)平臺傳入訂單需要分賬的標識,交易資金進入二級商戶賬戶并處于凍結(jié)狀態(tài)(默認凍結(jié)180天);平臺向微信支付發(fā)起分賬指令,微信支付根據(jù)指令對指定交易訂單進行分賬處理,并進行交易資金解凍,從而實現(xiàn)二級商戶的賬期和抽傭、分潤等場景;(默認最高分賬比例30%)支持一筆訂單多次分賬,同時支持分賬回退功能。
對于平臺營銷補貼的場景,支持平臺補貼資金轉(zhuǎn)入二級商戶賬戶后,再進行統(tǒng)一分賬。
● 需為境內(nèi)企業(yè)
● 需為企業(yè)類型商戶開放
● 法人證件需為身份證類型
● 1個二級商戶號最多可有1個流程中的入駐申請單
● 跨境權(quán)限需“超管”角色申請,跨境商戶入駐可由“超管”及“管理員”角色申請
● 需在商戶在海關(guān)總署上【經(jīng)營類別】顯示為:進出口貨物收發(fā)貨人
● 跨境商戶入駐:6-7個工作日反饋
● 收款人信息管理:3-5個工作日反饋
1) 服務(wù)商登錄微信支付服務(wù)商平臺開通跨境服務(wù)
2) 服務(wù)商戶登錄微信支付服務(wù)商平臺幫助二級商戶申請成為跨境商
類別 | 需填寫信息字段 | 描述 |
---|---|---|
跨境補充信息 | 1、 二級商戶號 2、 公司規(guī)模 3、 從業(yè)年份 4、 公司類型 |
僅需4個字段信息 |
制裁問卷 | 1、 中文名稱(自動展示商戶簡稱) 2、 英文名稱 3、 通訊地址 4、 管理機構(gòu)地址 5、 主要經(jīng)營地址 6、 主要海外經(jīng)營國家/地區(qū) 7、 主要海外客戶國家/地區(qū) 8、 是否涉及軍用/軍民兩用物品 |
8個字段+9個勾選題 備注:因跨境業(yè)務(wù)涉及海外多地區(qū)展業(yè),需了解實際情況 |
跨境協(xié)議 | / | 制式協(xié)議(不支持修改) |
a.填寫跨境補充信息(服務(wù)商代填)
b.填寫制裁問卷(服務(wù)商代填)
c.簽署跨境協(xié)議(二級商戶移動端簽署)
協(xié)議內(nèi)容:跨境支付商戶服務(wù)協(xié)議
d.審批完成,成功為二級商戶開通跨境功能
e.查看/編輯跨境商戶信息
審批完成、審批中和簽約中信息不支持編輯,僅支持查看
審批駁回、簽約失敗信息支持編輯和查看
為了便于二級商戶資金管理和對賬,二級商戶可通過平臺的對接系統(tǒng)進行微信支付賬戶余額查詢和提現(xiàn)。同時平臺收付通也提供賬單下載能力。
注意:二級商戶可通過該接口進行微信支付賬戶余額提現(xiàn),不建議平臺利用限制提現(xiàn)進行賬期控制,特殊情況下商戶可直接到微信支付進行提現(xiàn),故而造成賬期控制無效,賬期控制詳見分賬介紹。
openid是微信用戶在公眾號appid下的唯一用戶標識(appid不同,則獲取到的openid就不同),可用于永久標記一個用戶