Woo PayGate插件使用文檔

Woo PayGate插件可為WooCommerce插件提供微信、支付寶支付接口，實(shí)現(xiàn)在線付款功能。

安裝激活

插件安裝啟用后進(jìn)入后臺(tái)支付網(wǎng)關(guān)激活入口，填寫(xiě)郵箱和激活碼激活，具體激活方法參考主題的激活流程：http://www.air-home.cn/docs/themer/auth.html

微信支付

微信支付需要先申請(qǐng)開(kāi)通微信支付功能，可前往微信商戶平臺(tái)申請(qǐng)。

插件可支持Native支付、JSAPI支付、H5支付接口，使用前可在微信商戶平臺(tái)產(chǎn)品中心>我的產(chǎn)品申請(qǐng)好這幾個(gè)接口。其中不同接口的用途如下：

• Native支付用于電腦瀏覽器訪問(wèn)支付，以微信掃碼支付的形式；

• JSAPI支付接口用于微信內(nèi)置瀏覽器訪問(wèn)支付，直接喚起微信支付；

• H5支付接口用于手機(jī)瀏覽器（非微信）訪問(wèn)支付，比如手機(jī)自帶瀏覽器，會(huì)呼起微信客戶端進(jìn)行支付。

網(wǎng)站設(shè)置

Native支付接口回調(diào)通知在未設(shè)置好固定鏈接的情況下可能會(huì)出現(xiàn)異常，導(dǎo)致訂單狀態(tài)無(wú)法更新，所以需要先設(shè)置好固定鏈接：設(shè)置>固定鏈接。

另外Member Pro用戶中心插件的支付回調(diào)通知基于REST API實(shí)現(xiàn)，請(qǐng)確保網(wǎng)站沒(méi)有禁用REST API功能。

插件設(shè)置

進(jìn)入WooCommerce>設(shè)置>付款，啟用微信支付，點(diǎn)擊管理進(jìn)入接口設(shè)置頁(yè)面，按選項(xiàng)說(shuō)明設(shè)置：

APPID：開(kāi)戶郵件中可查看，如果找不到，可以進(jìn)入微信支付商戶平臺(tái)查看（產(chǎn)品中心>AppID賬號(hào)管理>我關(guān)聯(lián)的AppID賬號(hào)）;

APPSecret：（Woo PayGate Lite免費(fèi)版無(wú)此選項(xiàng)）公眾號(hào)開(kāi)發(fā)者密碼，用于公眾號(hào)支付?？稍?code>微信公眾平臺(tái)里面獲?。ㄩ_(kāi)發(fā)>基本配置）；

商戶號(hào)：MCHID 商戶號(hào)，開(kāi)戶郵件中可查看，也可以進(jìn)入微信支付商戶平臺(tái)查看（賬戶中心>商戶信息）；

支付密鑰：商戶支付密鑰，參考開(kāi)戶郵件設(shè)置，進(jìn)入微信支付商戶平臺(tái)，賬戶中心>API安全>API密鑰（APIv2密鑰）;

API證書(shū)

微信支付接口中，涉及資金回滾的接口會(huì)使用到API證書(shū)，例如退款接口。

商家在申請(qǐng)微信支付成功后，收到的相應(yīng)郵件后，可以按照指引下載API證書(shū)，也可以按照以下路徑下載：微信商戶平臺(tái)(pay.weixin.qq.com)>賬戶中心>賬戶設(shè)置>API安全。下載好證書(shū)文件以后，將apiclient_cert.pem和apiclient_key.pem兩個(gè)文件上傳到網(wǎng)站wp-content/wxpay-cert/目錄下（沒(méi)有wxpay-cert目錄的話可以自己新建），上傳后的證書(shū)存放路徑為：wp-content/wxpay-cert/apiclient_cert.pem、wp-content/wxpay-cert/apiclient_key.pem。

微信平臺(tái)設(shè)置

微信公眾號(hào)平臺(tái)設(shè)置

1、進(jìn)入設(shè)置與開(kāi)發(fā)>公眾號(hào)設(shè)置>功能設(shè)置，配置好業(yè)務(wù)域名、JS接口安全域名、網(wǎng)頁(yè)授權(quán)域名；

2、進(jìn)入設(shè)置與開(kāi)發(fā)>基本配置，設(shè)置IP白名單，添加網(wǎng)站服務(wù)器IP地址。

微信支付商戶平臺(tái)設(shè)置

進(jìn)入產(chǎn)品中心>開(kāi)發(fā)配置>支付配置：

1、JSAPI支付：添加結(jié)賬付款頁(yè)面的目錄地址。

Woo PayGate插件默認(rèn)為：https://網(wǎng)站首頁(yè)地址/checkout/order-pay/，如果網(wǎng)站有修改過(guò)結(jié)賬頁(yè)面的鏈接則以實(shí)際結(jié)賬付款鏈接地址為準(zhǔn)。

Member Pro用戶中心插件為：https://網(wǎng)站首頁(yè)地址/wp-admin/

溫馨提示：如果網(wǎng)站沒(méi)有啟用https則以上鏈接地址需要調(diào)整為http協(xié)議的地址。

2、H5支付：添加網(wǎng)站域名，區(qū)分www，需要和網(wǎng)站地址保持一致；

3、Native支付：Native支付的回調(diào)鏈接填寫(xiě)網(wǎng)站首頁(yè)地址。

支付寶支付

接口申請(qǐng)

支付寶支付需要先在支付寶商家中心申請(qǐng)好支付接口，目前支持的支付接口有：

• 電腦網(wǎng)站支付：針對(duì)PC端瀏覽器訪問(wèn)；

• 手機(jī)網(wǎng)站支付：針對(duì)手機(jī)移動(dòng)端瀏覽器訪問(wèn)；

• 當(dāng)面付：主要針對(duì)個(gè)體戶，有電腦網(wǎng)站支付和手機(jī)網(wǎng)站支付接口權(quán)限可以不用申請(qǐng)

支付寶平臺(tái)設(shè)置

接口申請(qǐng)好后可以先進(jìn)入支付寶開(kāi)放平臺(tái)>控制臺(tái)>網(wǎng)頁(yè)/移動(dòng)應(yīng)用（點(diǎn)擊進(jìn)入），在應(yīng)用列表里面找到已經(jīng)添加的應(yīng)用（如果沒(méi)有的話可以自己創(chuàng)建），點(diǎn)擊應(yīng)用查看詳情，可調(diào)用產(chǎn)品里面需要有電腦網(wǎng)站支付和手機(jī)網(wǎng)站支付（沒(méi)有的話參考上一步接口申請(qǐng)部分），如果申請(qǐng)的是當(dāng)面付接口，則需要有當(dāng)面付，并且完成簽約，如圖：

插件設(shè)置

進(jìn)入WooCommerce>設(shè)置>付款，啟用支付寶，點(diǎn)擊管理進(jìn)入接口設(shè)置頁(yè)面，按選項(xiàng)說(shuō)明設(shè)置：

APPID：應(yīng)用ID，可在支付寶開(kāi)放平臺(tái)>控制臺(tái)>網(wǎng)頁(yè)/移動(dòng)應(yīng)用查看；

應(yīng)用私鑰：應(yīng)用私鑰是需要自己生成的，如果忘記了可以重新生成，生成方法可以點(diǎn)擊這里，生成后會(huì)有一個(gè)應(yīng)用公鑰和應(yīng)用私鑰，其中應(yīng)用私鑰就是填寫(xiě)在這里，剩下一個(gè)應(yīng)用公鑰需要填寫(xiě)到支付寶開(kāi)放平臺(tái)的應(yīng)用里面：進(jìn)入應(yīng)用信息頁(yè)面，點(diǎn)開(kāi)接口加簽方式>設(shè)置/查看，如圖：

首次設(shè)置的話選擇加密模式請(qǐng)選擇公鑰（如果之前設(shè)置的是公鑰證書(shū)的話請(qǐng)加簽變更或者也可以直接新建一個(gè)應(yīng)用），將上面生成的應(yīng)用公鑰添加到填寫(xiě)公鑰字符選項(xiàng)即可，如圖：

支付寶公鑰：進(jìn)入對(duì)應(yīng)應(yīng)用的應(yīng)用信息，點(diǎn)開(kāi)接口加簽方式>設(shè)置/查看，然后可以看到支付寶公鑰，具體可以參考上面的截圖。

溫馨提示： 支付寶應(yīng)用信息里面的授權(quán)回調(diào)地址選項(xiàng)請(qǐng)留空，否則可能支付成功后回調(diào)驗(yàn)證失敗導(dǎo)致訂單還是未支付，如果已經(jīng)填寫(xiě)了，建議勾選只驗(yàn)證域名選項(xiàng)或者重新創(chuàng)建一個(gè)應(yīng)用。