1. 程式人生 > >微信支付 —— 公眾號支付程式碼詳解

微信支付 —— 公眾號支付程式碼詳解

在微信支付 開發者文件頁面 下載最新的 php SDK

http://mch.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=11_1

這裡假設你已經申請完微信支付

1. 微信後臺配置  如圖

我們先進行測試,所以先把測試授權目錄和 測試白名單新增上。測試授權目錄是你要發起微信請求的哪個檔案所在的目錄。

例如jsapi 發起請求一般是jsapi.php所在目錄 為測試目錄,測試白名單即開發人員的微訊號。

正式的支付授權目錄不能和測試的一樣否則會報錯。不填寫或者填錯授權目錄以及測試白名單都會報錯。

報錯樣例:

NaNsystem:access_denied

不在測試白名單


2. 配置 lib/WxPay.Config.php檔案

最主要配置一下四項:

const APPID = '';
const MCHID = '';
const KEY = '';
const APPSECRET = '';
APPID 和 APPSECRET都可以在微信後臺中找到。

MCHID 在申請微信支付後發來的郵件中可以找到,KEY 則根據郵件提示


去商戶平臺配置即可。

3. 訪問起始 index.php 

首先訪問 index.php 你可以看到介面


我們首先需要的是 JSAPI支付。但是看程式碼 index.php 最下面的連結。他預設是個demo的連結,改為我們自定義的即可

<ul>
    <li style="background-color:#FF7F24"><a href="<?php echo 'http://'.$_SERVER['HTTP_HOST'].$_SERVER['REQUEST_URI'].'example/jsapi.php';?>">JSAPI支付</a></li>
    <li style="background-color:#698B22"><a href="<?php echo 'http://'.$_SERVER['HTTP_HOST'].$_SERVER['REQUEST_URI'].'example/micropay.php';?>">刷卡支付</a></li>
    <li style="background-color:#8B6914"><a href="<?php echo 'http://'.$_SERVER['HTTP_HOST'].$_SERVER['REQUEST_URI'].'example/native.php';?>">掃碼支付</a></li>
    <li style="background-color:#CDCD00"><a href="<?php echo 'http://'.$_SERVER['HTTP_HOST'].$_SERVER['REQUEST_URI'].'example/orderquery.php';?>">訂單查詢</a></li>
    <li style="background-color:#CD3278"><a href="<?php echo 'http://'.$_SERVER['HTTP_HOST'].$_SERVER['REQUEST_URI'].'example/refund.php';?>">訂單退款</a></li>
    <li style="background-color:#848484"><a href="<?php echo 'http://'.$_SERVER['HTTP_HOST'].$_SERVER['REQUEST_URI'].'example/refundquery.php';?>">退款查詢</a></li>
    <li style="background-color:#8EE5EE"><a href="<?php echo 'http://'.$_SERVER['HTTP_HOST'].$_SERVER['REQUEST_URI'].'example/download.php';?>">下載訂單</a></li>
</ul>
當然你也可以直接寫死為自己的訪問連結。

4. JSAPI 支付

必要程式碼解析:

$logHandler= new CLogFileHandler("../logs/".date('Y-m-d').'.log');
$log = Log::Init($logHandler, 15);

呼叫日誌類 可以通過 $log->DEBUG('test'); 列印除錯資訊。其實也可以直接使用 $Log::DEBUG('test'); 來除錯
$tools = new JsApiPay();
$openId = $tools->GetOpenid();

主要是為了獲取 openid 其中GetOpenid() 函式定義在 檔案 WxPay.JsApiPay.php 檔案中
public function GetOpenid()
	{
		//通過code獲得openid
		if (!isset($_GET['code'])){
			//觸發微信返回code碼
			$baseUrl = urlencode('http://'.$_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF'].$_SERVER['QUERY_STRING']);
			$url = $this->__CreateOauthUrlForCode($baseUrl);
			Header("Location: $url");
			exit();
		} else {
			//獲取code碼,以獲取openid
		    $code = $_GET['code'];
			$openid = $this->getOpenidFromMp($code);
			return $openid;
		}
	}

$baseUrl 其實就是為了在跳轉回來這個頁面。  可以繼續跟蹤函式__CreateOauthUrlForCode()  其實就是通過微信的Auth2.0 來獲取Openid

參考連結:http://mp.weixin.qq.com/wiki/17/c0f37d5704f0b64713d5d2c37b468d75.html

這就需要你把微信的 網頁授權介面也設定好。

獲取到 Openid 就可以呼叫微信支付的統一下單介面了。回到 檔案 jsapi.php 如下程式碼

$input = new WxPayUnifiedOrder();
$input->SetBody("test");
$input->SetAttach("test");
$input->SetOut_trade_no(WxPayConfig::MCHID.date("YmdHis"));
$input->SetTotal_fee("1");
$input->SetTime_start(date("YmdHis"));
$input->SetTime_expire(date("YmdHis", time() + 600));
$input->SetGoods_tag("test");
$input->SetNotify_url("http://paysdk.weixin.qq.com/example/notify.php");
$input->SetTrade_type("JSAPI");
$input->SetOpenid($openId);
$order = WxPayApi::unifiedOrder($input);
echo '<font color="#f00"><b>統一下單支付單資訊</b></font><br/>';
printf_info($order);
$jsApiParameters = $tools->GetJsApiParameters($order);
這裡面的程式碼:
$input->SetAttach("test");
如果 把值改為 $input->SetAttach("test this is attach");就會存在bug 後面再說,其實這個引數不是必須的乾脆可以去掉。

程式碼:

$input->SetNotify_url("http://paysdk.weixin.qq.com/example/notify.php");
是設定接收支付結果通知的Url 這裡是預設的demo 連結我們可以設定成我們的:
$input->SetNotify_url(dirname('http://'.$_SERVER['HTTP_HOST'].$_SERVER['REQUEST_URI']).'/notify.php');

當然你也可以選擇直接寫死。

其中的函式 unifiedOrder($input) 可以到WxPay.Api.php 中檔案跟蹤,其實就是呼叫統一下單介面。

在 WxPay.Api.php 中需要更改的一處程式碼是:

//非同步通知url未設定,則使用配置檔案中的url
        if(!$inputObj->IsNotify_urlSet()){
            $inputObj->SetNotify_url(WxPayConfig::NOTIFY_URL);//非同步通知url
        }

就是當沒設定 notifyUrl 的時候回去配置檔案中找,但是配置檔案中根本沒有設定。

所以你可以選擇在 配置檔案WxPay.Config.php 中加上這個配置,也可以直接寫一個預設的notify連結。

函式 GetJsApiParameters() 是獲取jsApi支付的引數給變數 $jsApiParameters 方便在下面的Js中呼叫

jsapi.php 中js的程式碼:

function jsApiCall()
	{
		WeixinJSBridge.invoke(
			'getBrandWCPayRequest',
			<?php echo $jsApiParameters; ?>,
			function(res){
				WeixinJSBridge.log(res.err_msg);
				alert(res.err_code+res.err_desc+res.err_msg);
			}
		);
	}

	function callpay()
	{
		if (typeof WeixinJSBridge == "undefined"){
		    if( document.addEventListener ){
		        document.addEventListener('WeixinJSBridgeReady', jsApiCall, false);
		    }else if (document.attachEvent){
		        document.attachEvent('WeixinJSBridgeReady', jsApiCall); 
		        document.attachEvent('onWeixinJSBridgeReady', jsApiCall);
		    }
		}else{
		    jsApiCall();
		}
	}

其中點選立即支付按鈕呼叫的就是 callpay() 函式,他有會呼叫jsApiCall() 函式開啟支付程式。

此後輸入密碼完成支付。

在完成支付頁面點選完成會回到這個支付頁面,並彈出 支付成功的提示框

這個其實就是 js函式 jsApiCall 裡面的alter 彈出的對話方塊

其中 res.err_msg 為get_brand_wcpay_request:ok 表明前端判斷的支付成功,我們可以根據這個將支付跳轉到成功頁面。

但是這個並不可信。確認是否支付成功還是應當 通過notify.php 處理業務邏輯。

5. 支付結果通知 notify.php

其實這個頁面最主要的程式碼就兩行

$notify = new PayNotifyCallBack();
$notify->Handle(false);
其中大部分邏輯在 Handle 函式中處理 檔案 WxPay.Notify.php
final public function Handle($needSign = true)
	{
		$msg = "OK";
		//當返回false的時候,表示notify中呼叫NotifyCallBack回撥失敗獲取簽名校驗失敗,此時直接回復失敗
		$result = WxpayApi::notify(array($this, 'NotifyCallBack'), $msg);
		if($result == false){
			$this->SetReturn_code("FAIL");
			$this->SetReturn_msg($msg);
			$this->ReplyNotify(false);
			return;
		} else {
			//該分支在成功回撥到NotifyCallBack方法,處理完成之後流程
			$this->SetReturn_code("SUCCESS");
			$this->SetReturn_msg("OK");
		}
		$this->ReplyNotify($needSign);
	}
主要程式碼:
$result = WxpayApi::notify(array($this, 'NotifyCallBack'), $msg);
跟蹤函式 notify 檔案WxPay.Api.php
public static function notify($callback, &$msg)
	{
		//獲取通知的資料
		$xml = $GLOBALS['HTTP_RAW_POST_DATA'];
		//如果返回成功則驗證簽名
		try {
			$result = WxPayResults::Init($xml);
		} catch (WxPayException $e){
			$msg = $e->errorMessage();
			return false;
		}
		
		return call_user_func($callback, $result);
	}
通過 $GLOBALS['HTTP_RAW_POST_DATA']; 獲取同志資料 然後 Init 函式驗證簽名等。驗籤成功執行程式碼
return call_user_func($callback, $result);

即呼叫了一個回撥函式,NotifyCallBack() 函式並傳遞引數 $result 在NotifyCallBack函式中會呼叫我們重寫的NotifyProcess()函式(此函式在notify.php 中被重寫)

NotifyProcess() 判斷也沒有問題就會 設定返回 success的xml資訊

$this->SetReturn_code("SUCCESS");
$this->SetReturn_msg("OK");
並最終呼叫函式 $this->ReplyNotify($needSign);  echo success的結果

函式ReplyNotify 需要修改一處程式碼:

final private function ReplyNotify($needSign = true)
	{
		//如果需要簽名
		if($needSign == true && 
			$this->GetReturn_code($return_code) == "SUCCESS")
		{
			$this->SetSign();
		}
		WxpayApi::replyNotify($this->ToXml());
	}

$this->GetReturn_code($return_code) == "SUCCESS")
改為
$this->GetReturn_code() == "SUCCESS")
即可。

這樣整個流程就結束了。上面提到了 傳遞訂單引數

$input->SetAttach("test");
如果我設定 值為 test this is attach (其實只要有空格就會存在bug)

如圖 傳遞的訂單資訊


可以看到 attach 資訊正常,當然支付也是正常的沒有任何問題。

但是發現總是會收到notify 通知,即意味著沒有返回給微信伺服器正確的結果通知。

列印伺服器發來的通知資料


可以看到 attach 是 test+this+is+attach 即空格被轉化為加號

列印接收到的簽名和程式算出來的簽名發現 簽名不同,即認為接收結果異常。

所以我們要是想使用attach 這個值就不能有空格,要麼乾脆不使用這個引數

(等待微信修復這個bug, 也可能是我這邊有哪個地方不會? - -#)

這樣 微信支付的 JsApi支付就大致分析完成了。

補充:

1. 程式還有幾處拼寫錯誤,例如WxPay.JsApiPay.php的 GetOpenidFromMp 函式

其中設定超時程式碼

curl_setopt($ch, CURLOP_TIMEOUT, $this->curl_timeout);
修改為
curl_setopt($ch, CURLOPT_TIMEOUT, $this->curl_timeout);
而且 變數 $this->curl_timeout 也沒有賦值,初始化。 你可以根據實際自己在類的宣告下面初始化並賦值。

2. 不允許跨號支付 提示

是因為你在一個訂閱號中打開了這個支付連結,而在微信中訂閱號是沒有支付許可權的。但是在一個有支付許可權的服務號或者將連結直接發給朋友

或者發到朋友圈卻是可以支付的。

有的時候你先通過訂閱號訪問支付連結提示不允許跨號支付,然後再發給朋友這個時候再開啟仍有不允許跨號支付的提示出現。(目前是這樣,應該算是個bug)

如果你要避免這些問題,其實好的解決辦法應該是使用微信的掃碼支付了。(掃碼支付模式二)下一節會解釋下微信掃碼支付。

當然具體使用哪種支付方式要依據實際情況來定。