JSAPI支付接入前準(zhǔn)備
1.選擇接入模式
商戶/服務(wù)商在接入前首先要判斷自己公司注冊(cè)區(qū)域適用的接入模式，微信支付目前提供兩種接入方式：直連模式和服務(wù)商模式。
● 直連模式：
信息、資金流：微信支付—>直連商戶
直連模式，商戶自行申請(qǐng)入駐微信支付，無需服務(wù)商協(xié)助。（商戶平臺(tái)申請(qǐng)）成為直連商戶
直連模式相關(guān)說明詳見：直連模式介紹
● 服務(wù)商模式：
—— 信息流 —— 資金流
服務(wù)商模式，商戶申請(qǐng)成為微信支付服務(wù)商，服務(wù)商自身無法作為一個(gè)直連商戶直接發(fā)起交易，其發(fā)起交易必須傳入相關(guān)特約商戶商戶號(hào)的參數(shù)信息。（服務(wù)商平臺(tái)申請(qǐng)）成為服務(wù)商
請(qǐng)結(jié)合自身實(shí)際情況來選擇接入模式。
2.參數(shù)申請(qǐng)
-
1申請(qǐng)APPID
由于微信支付的產(chǎn)品體系全部搭載于微信的社交體系之上，所以直連商戶或服務(wù)商接入微信支付之前，都需要有一個(gè)微信社交載體，該載體對(duì)應(yīng)的ID即為APPID。
目前服務(wù)商的社交載體只能是公眾號(hào)，服務(wù)商可通過公眾平臺(tái)完成公眾號(hào)注冊(cè)申請(qǐng)。
公眾號(hào)申請(qǐng)成功后，服務(wù)商可登錄公眾號(hào)平臺(tái)即可獲取對(duì)應(yīng)的APPID，具體查閱目錄為 【開發(fā)-> 基本配置-> 公眾號(hào)開發(fā)信息】，如下圖所示。通常情況下，一個(gè)服務(wù)商只需申請(qǐng)一個(gè)公眾號(hào)即可。
-
2申請(qǐng)mchid
服務(wù)商的收款賬號(hào)即是mchid，申請(qǐng)mchid和APPID的操作互不影響，可以并行操作，申請(qǐng)地址如下： 商戶號(hào)申請(qǐng)指引
mchid申請(qǐng)成功后，微信支付將下發(fā)通知郵件至機(jī)構(gòu)填寫的聯(lián)系郵箱，內(nèi)容包含申請(qǐng)成功的mchid及其登錄賬號(hào)密碼，請(qǐng)妥善保存。
注意：一個(gè)mchid只能對(duì)應(yīng)一個(gè)結(jié)算幣種，若需要使用多個(gè)幣種收款，需要申請(qǐng)對(duì)應(yīng)數(shù)量的mchid。
-
3綁定APPID及mchid
APPID和mchid全部申請(qǐng)完畢后，需要建立兩者之間的綁定關(guān)系。
服務(wù)商可登錄服務(wù)商平臺(tái)，【產(chǎn)品中心-> AppID管理】目錄下即可完成綁定。
服務(wù)商模式下，一個(gè)APPID下可綁定多個(gè)mchid，一個(gè)mchid可綁定3個(gè)APPID。
-
4入駐子商戶
上述步驟操作完成后，即會(huì)向服務(wù)商開放入駐子商戶權(quán)限。
服務(wù)商可登錄服務(wù)商平臺(tái)進(jìn)入【服務(wù)商功能】界面完成子商戶入駐。
-
完成
3.配置API key
API v3密鑰主要用于平臺(tái)證書解密、回調(diào)信息解密，具體使用方式可參見接口規(guī)則文檔中證書和回調(diào)報(bào)文解密章節(jié)。
請(qǐng)根據(jù)以下步驟配置API key：
-
1登錄微信服務(wù)商平臺(tái)，進(jìn)入【賬戶中心 > API安全】目錄，設(shè)置APIV3密鑰。
-
2在彈出窗口中點(diǎn)擊【已溝通】。
-
3輸入API密鑰，內(nèi)容為32位字符，包括數(shù)字及大小寫字母。點(diǎn)擊獲取短信驗(yàn)證碼。
-
4輸入短信驗(yàn)證碼，點(diǎn)擊【確認(rèn)】即設(shè)置成功。
-
完成
4.下載并配置商戶證書
商戶API證書具體使用說明可參見接口規(guī)則文檔中私鑰和證書章節(jié)
服務(wù)商可登錄微信服務(wù)商平臺(tái)，在【賬戶中心 -> API安全】目錄下載證書
以下為具體下載步驟：
-
1從2018年底開始，微信支付新入駐機(jī)構(gòu)及商戶都將使用CA簽發(fā)證書，在證書申請(qǐng)頁面上點(diǎn)擊“申請(qǐng)證書”。
-
2在彈出窗口中點(diǎn)擊“確定”。
-
3在彈出窗口內(nèi)點(diǎn)擊“下載證書工具”按鈕下載證書工具。
-
4安裝證書工具并打開，選擇證書需要存儲(chǔ)的路徑后點(diǎn)擊“申請(qǐng)證書”。
-
5在證書工具中，將復(fù)制的商戶信息粘貼并點(diǎn)擊“下一步”。
-
6獲取請(qǐng)求串
-
7生成證書串
步驟1 在【商戶平臺(tái)】-“復(fù)制證書串”環(huán)節(jié)，點(diǎn)擊“復(fù)制證書串”按鈕后；
步驟2 在【證書工具】-“復(fù)制請(qǐng)求串”環(huán)節(jié)，點(diǎn)擊“下一步”按鈕進(jìn)入“粘貼證書串”環(huán)節(jié)；
步驟3 在【證書工具】-“粘貼證書串”環(huán)節(jié)，點(diǎn)擊“粘貼”按鈕后；
步驟4 點(diǎn)擊“下一步”按鈕，進(jìn)入【證書工具】-“生成證書”環(huán)節(jié)
-
8在【證書工具】-“生成證書”環(huán)節(jié)，已完成申請(qǐng)證書流程，點(diǎn)擊“查看證書文件夾”，查看已生成的證書文件。
-
完成
5.配置應(yīng)用
5.1. 設(shè)置支付授權(quán)目錄
5.1.1. 支付授權(quán)目錄說明
1)服務(wù)商最后請(qǐng)求拉起微信支付收銀臺(tái)的頁面地址我們稱之為“支付授權(quán)目錄”，例如：https://www.weixin.com/pay.php的支付授權(quán)目錄為：https://www.weixin.com/。
2)服務(wù)商實(shí)際的支付授權(quán)目錄必須和在微信支付服務(wù)商平臺(tái)設(shè)置的一致，否則會(huì)報(bào)錯(cuò)“當(dāng)前頁面的URL未注冊(cè)：”
3)服務(wù)商模式支付授權(quán)目錄設(shè)置可分為2種方式：
● 服務(wù)商為全體子商戶設(shè)置支付授權(quán)目錄
● 服務(wù)商為某一子商戶單獨(dú)設(shè)置支付授權(quán)目錄
5.1.2. 支付授權(quán)目錄設(shè)置說明
1). 服務(wù)商為全體子商戶設(shè)置支付授權(quán)目錄
登錄【微信服務(wù)商平臺(tái)—>產(chǎn)品中心—>開發(fā)配置】，設(shè)置后一般5分鐘內(nèi)生效。
2). 服務(wù)商為某一子商戶單獨(dú)設(shè)置支付授權(quán)目錄
登錄【微信服務(wù)商平臺(tái)—>服務(wù)商功能—>特約商戶管理】，設(shè)置后一般5分鐘內(nèi)生效。
5.1.3. 支付授權(quán)目錄校驗(yàn)規(guī)則說明
1)如果支付授權(quán)目錄設(shè)置為頂級(jí)域名（例如：https://www.weixin.com/ ），那么只校驗(yàn)頂級(jí)域名，不校驗(yàn)后綴；
2)如果支付授權(quán)目錄設(shè)置為多級(jí)目錄，就會(huì)進(jìn)行全匹配，例如設(shè)置支付授權(quán)目錄為https://www.weixin.com/abc/123/，則實(shí)際請(qǐng)求頁面目錄不能為https://www.weixin.com/abc/，也不能為https://www.weixin.com/abc/123/pay/，必須為https://www.weixin.com/abc/123/
5.2. 設(shè)置授權(quán)域名
開發(fā)JSAPI支付時(shí)，在JSAPI下單接口中要求必傳用戶openid，而獲取openid則需要您在微信公眾平臺(tái)設(shè)置獲取openid的域名，只有被設(shè)置過的域名才是一個(gè)有效的獲取openid的域名，否則將獲取失敗。具體界面如圖所示：
開通流程：服務(wù)商在 微信支付服務(wù)商平臺(tái) - 產(chǎn)品中心 - 特約商戶授權(quán)產(chǎn)品 中發(fā)起申請(qǐng)，獲得商戶授權(quán)后，可以替商家發(fā)起JSAPI支付。