Woo PayGate插件使用文檔

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

安裝激活

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

微信支付

微信支付需要先申請開通微信支付功能，可前往微信商戶平臺申請。

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

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

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

• H5支付接口用于手機瀏覽器（非微信）訪問支付，比如手機自帶瀏覽器，會呼起微信客戶端進行支付。

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

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

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

插件設(shè)置

進入WooCommerce>設(shè)置>付款，啟用微信支付，點擊管理進入接口設(shè)置頁面，按選項說明設(shè)置：

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

APPSecret：（Woo PayGate Lite免費版無此選項）公眾號開發(fā)者密碼，用于公眾號支付?？稍?code>微信公眾平臺里面獲取（開發(fā)>基本配置）；

商戶號：MCHID 商戶號，開戶郵件中可查看，也可以進入微信支付商戶平臺查看（賬戶中心>商戶信息）；

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

API證書

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

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

微信平臺設(shè)置

微信公眾號平臺設(shè)置

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

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

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

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

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

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

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

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

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

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

支付寶支付

接口申請

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

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

• 手機網(wǎng)站支付：針對手機移動端瀏覽器訪問；

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

支付寶平臺設(shè)置

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

插件設(shè)置

進入WooCommerce>設(shè)置>付款，啟用支付寶，點擊管理進入接口設(shè)置頁面，按選項說明設(shè)置：

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

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

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

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

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