基於H5的微信支付開發詳解

佚名發表於2015-11-10

這次總結一下使用者在微信內開啟網頁時，可以呼叫微信支付完成下單功能的模組開發，也就是在微信內的H5頁面透過jsApi介面實現支付功能。當然了，微信官網上的微信支付開發文件也講解的很詳細，並且有實現程式碼可供參考，有的朋友直接看文件就可以自己實現此支付介面的開發了。

一、前言

為何我還寫一篇微信支付介面的博文呢？第一，我們必須知道，所謂的工作經驗很多都是靠總結出來的，你只有總結了更多知識，積累了更多經驗，你才能在該行業中脫穎而出，我個人覺得如今的招聘，很多都需要工作經驗（1年、3年、5年....），其實，工作時間的長久不能衡量一個人技術水平的高低，有的人一年的工作經驗能拿3年工作經驗的程式猿的工資，有的3 年工作經驗的卻有可能比別人只有一年工作經驗的還低，所以說，總結才能讓自己的知識體系，經驗深度更牛逼更穩固（雖然寫一篇博文挺花費時間的）；第二，寫博文分享給大家還是挺有成就感的，首先是能讓新手從我分享的博文中能學到東西，並且能快速將博文所講解的技術運用到實際中來，所以我寫的博文基本上能讓新人快速讀懂並且容易理解，另外，技術大神的話，看到博文有講解的不對之處，還可以指出，並且可以交流，何樂而不為呢，我們需要的就是分享和交流。

扯遠了，直接進入該主題的詳解。

現在的微信支付方式有N種，看下圖，有刷卡支付、公眾號支付、掃碼支付和APP支付，另外還有支付工具的開發，本博文選擇的是公眾號支付藉口而開發進行講解，其他幾種支付介面開發基本上思路都是一樣的，只要你能看懂我這博文所講解的基本思路，你基本上也能獨自開發其他幾個支付介面。

HTML5教程 HTML5技術微信支付微信支付介面開發微信支付api

二、思路詳解

我們可以拿微信支付介面文件裡的業務流程時序圖看看，如下圖，基本思路是這樣子：首先在後臺生成一個連結，展示給使用者讓使用者點選（例如頁面上有微信支付的按鈕），使用者點選按鈕後，網站後臺會根據訂單的相關資訊生成一個支付訂單，此時會呼叫統一下單介面，對微信支付系統發起請求，而微信支付系統受到請求後，會根據請求過來的資料，生成一個預支付交易會話標識（prepay_id，就是透過這個來識別該訂單的），我們的網站收到微信支付系統的響應後，會得到prepay_id，然後透過自己構造微信支付所需要的引數，接著將支付所需引數返回給客戶端，使用者此時可能會有一個訂單資訊頁，會有一個按鈕，點選支付，此時會呼叫JSAPI介面對微信支付系統發起請求支付，微信支付系統檢查了請求的相關合法性之後，就會提示輸入密碼，使用者此時輸入密碼確認，微信支付系統會對其進行驗證，透過的話會返回支付結果，然後微信跳轉會H5頁面，這其中有一步是非同步通知網站支付結果，我們網站需要對此進行處理（比如說非同步支付結果透過後，需要更新資料表或者訂單資訊，例如標志使用者已支付該訂單了，同時也需要更新訂單日誌，防止使用者重複提交訂單）。

HTML5教程 HTML5技術微信支付微信支付介面開發微信支付api

三、程式碼講解

本次開發環境用的是php5.6 + MySQL + Redis + Linux + Apache，所選用的框架的CI框架（這些環境不一定需要和我的一致，框架也可以自己選擇，反正自己稍微修改下程式碼就能移植過去了）。

微信支付介面的開發程式碼我已經提前寫好了，在這裡我對其進行分析講解，方便大家能輕鬆理解，當然，假如你有一定的基礎，直接看程式碼就能理清所有流程了，並且我的程式碼基本上都寫上了註釋（對於新手來說，這一點比微信文件所提供的程式碼好一點）。

1、構造一個連結展示給使用者

這裡我們提前需要知道一個點，那就是請求統一下單介面需要微信使用者的openid（詳情可看這https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_1），而獲取openid需要先獲取code（詳情可看這微信登入介面），所以我們需要構造一個獲取code的URL：

Wxpay.php檔案：
<?php
defined('BASEPATH')ORexit('NodirectscriptAccessallowed');
classWxpayextendsMY_Controller{
publicfunction__construct(){
parent::__construct();
$this->load->model('wxpay_model');
//$this->load->model('wxpay
}
publicfunctionindex(){
//微信支付
$this->smarty['wxPayUrl']=$this->wxpay_model->retWxPayUrl();
$this->displayView('wxpay/index.tpl');
}
}

在這先看看model裡所寫的幾個類：model裡有幾個類：微信支付類、統一下單介面類、響應型介面基類、請求型介面基類、所有介面基類、配置類。為何要分那麼多類而不在一個類裡實現所有的方法的，因為，這樣看起來程式碼邏輯清晰，哪個類該幹嘛就幹嘛。

這裡我直接附上model的程式碼了,裡面基本上每一個類每一個方法甚至每一行程式碼都會有解釋的了，這裡我就不對其展開一句句分析了：

<?php
defined('BASEPATH')ORexit('Nodirectscriptaccessallowed');
classWxpay_modelextendsCI_Model{
publicfunction__construct(){
parent::__construct();
}
/**
*返回可以獲得微信code的URL（用以獲取openid）
*@return[type][description]
*/
publicfunctionretWxPayUrl(){
$jsApi=newJsApi_handle();
return$jsApi->createOauthUrlForCode();
}
/**
*微信jsapi點選支付
*@param[type]$data[description]
*@return[type][description]
*/
publicfunctionwxPayJsApi($data){
$jsApi=newJsApi_handle();
//統一下單介面所需資料
$payData=$this->returnData($data);
//獲取code碼，用以獲取openid
$code=$_GET['code'];
$jsApi->setCode($code);
//透過code獲取openid
$openid=$jsApi->getOpenId();
$unifiedOrderResult=null;
if($openid!=null){
//取得統一下單介面返回的資料
$unifiedOrderResult=$this->getResult($payData,'JSAPI',$openid);
//獲取訂單介面狀態
$returnMessage=$this->returnMessage($unifiedOrder,'prepay_id');
if($returnMessage['resultCode']){
$jsApi->setPrepayId($retuenMessage['resultField']);
//取得wxjsapi介面所需要的資料
$returnMessage['resultData']=$jsApi->getParams();
}
return$returnMessage;
}
}
/**
*統一下單介面所需要的資料
*@param[type]$data[description]
*@return[type][description]
*/
publicfunctionreturnData($data){
$payData['sn']=$data['sn'];
$payData['body']=$data['goods_name'];
$payData['out_trade_no']=$data['order_no'];
$payData['total_fee']=$data['fee'];
$payData['attach']=$data['attach'];
return$payData;
}
/**
*返回統一下單介面結果（參考https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_1）
*@param[type]$payData[description]
*@param[type]$trade_type[description]
*@param[type]$openid[description]
*@return[type][description]
*/
publicfunctiongetResult($payData,$trade_type,$openid=null){
$unifiedOrder=newUnifiedOrder_handle();
if($opneid!=null){
$unifiedOrder->setParam('openid',$openid);
}
$unifiedOrder->setParam('body',$payData['body']);//商品描述
$unifiedOrder->setParam('out_trade_no',$payData['out_trade_no']);//商戶訂單號
$unifiedOrder->setParam('total_fee',$payData['total_fee']);//總金額
$unifiedOrder->setParam('attach',$payData['attach']);//附加資料
$unifiedOrder->setParam('notify_url',base_url('/Wxpay/pay_callback'));//通知地址
$unifiedOrder->setParam('trade_type',$trade_type);//交易型別
//非必填引數，商戶可根據實際情況選填
//$unifiedOrder->setParam("sub_mch_id","XXXX");//子商戶號
//$unifiedOrder->setParam("device_info","XXXX");//裝置號
//$unifiedOrder->setParam("time_start","XXXX");//交易起始時間
//$unifiedOrder->setParam("time_expire","XXXX");//交易結束時間
//$unifiedOrder->setParam("goods_tag","XXXX");//商品標記
//$unifiedOrder->setParam("product_id","XXXX");//商品ID
return$unifiedOrder->getResult();
}
/**
*返回微信訂單狀態
*/
publicfunctionreturnMessage($unifiedOrderResult,$field){
$arrMessage=array("resultCode"=>0,"resultType"=>"獲取錯誤","resultMsg"=>"該欄位為空");
if($unifiedOrderResult==null){
$arrMessage["resultType"]="未獲取許可權";
$arrMessage["resultMsg"]="請重新開啟頁面";
}elseif($unifiedOrderResult["return_code"]=="FAIL")
{
$arrMessage["resultType"]="網路錯誤";
$arrMessage["resultMsg"]=$unifiedOrderResult['return_msg'];
}
elseif($unifiedOrderResult["result_code"]=="FAIL")
{
$arrMessage["resultType"]="訂單錯誤";
$arrMessage["resultMsg"]=$unifiedOrderResult['err_code_des'];
}
elseif($unifiedOrderResult[$field]!=NULL)
{
$arrMessage["resultCode"]=1;
$arrMessage["resultType"]="生成訂單";
$arrMessage["resultMsg"]="OK";
$arrMessage["resultField"]=$unifiedOrderResult[$field];
}
return$arrMessage;
}
/**
*微信回撥介面返回驗證簽名並回應微信
*@param[type]$xml[description]
*@return[type][description]
*/
publicfunctionwxPayNotify($xml){
$notify=newWxpay_server();
$notify->saveData($xml);
//驗證簽名，並回復微信
//對後臺通知互動時，如果微信收到商戶的應答不是成功或者超時，微信認為通知失敗
//微信會透過一定的策略（如30分鐘共8次），定期重新發起通知
if($notify->checkSign()==false){
$notify->setReturnParameter("return_code","FAIL");//返回狀態碼
$notify->setReturnParameter("return_msg","簽名失敗");//返回資訊
}else{
$notify->checkSign=TRUE;
$notify->setReturnParameter("return_code","SUCCESS");//設定返回碼
}
return$notify;
}
}
/**
*JSAPI支付——H5網頁端調起支付介面
*/
classJsApi_handleextendsJsApi_common{
public$code;//code碼，用以獲取openid
public$openid;//使用者的openid
public$parameters;//jsapi引數，格式為json
public$prepay_id;//使用統一支付介面得到的預支付id
public$curl_timeout;//curl超時時間
function__construct()
{
//設定curl超時時間
$this->curl_timeout=WxPayConf::CURL_TIMEOUT;
}
/**
*生成獲取code的URL
*@return[type][description]
*/
publicfunctioncreateOauthUrlForCode(){
//重定向URL
$redirectUrl="http://www.itcen.cn/wxpay/confirm/".$orderId."?showwxpaytitle=1";
$urlParams['appid']=WxPayConf::APPID;
$urlParams['redirect_uri']=$redirectUrl;
$urlParams['response_type']='code';
$urlParams['scope']='snsapi_base';
$urlParams['state']="STATE"."#wechat_redirect";
//拼接字串
$queryString=$this->ToUrlParams($urlParams,false);
return"https://open.weixin.qq.com/connect/oauth2/authorize?".$queryString;
}
/**
*設定code
*@param[type]$code[description]
*/
publicfunctionsetCode($code){
$this->code=$code;
}
/**
*作用：設定prepay_id
*/
publicfunctionsetPrepayId($prepayId)
{
$this->prepay_id=$prepayId;
}
/**
*作用：獲取jsapi的引數
*/
publicfunctiongetParams()
{
$jsApiObj["appId"]=WxPayConf::APPID;
$timeStamp=time();
$jsApiObj["timeStamp"]="$timeStamp";
$jsApiObj["nonceStr"]=$this->createNoncestr();
$jsApiObj["package"]="prepay_id=$this->prepay_id";
$jsApiObj["signType"]="MD5";
$jsApiObj["paySign"]=$this->getSign($jsApiObj);
$this->parameters=json_encode($jsApiObj);
return$this->parameters;
}
/**
*透過curl向微信提交code用以獲取openid
*@return[type][description]
*/
publicfunctiongetOpenId(){
//建立openid的連結
$url=$this->createOauthUrlForOpenid();
//初始化
$ch=curl_init();
curl_setopt($ch,CURL_TIMEOUT,$this->curl_timeout);
curl_setopt($ch,CURL_URL,$url);
curl_setopt($ch,CURL_SSL_VERIFYPEER,FALSE);
curl_setopt($ch,CURL_SSL_VERIFYHOST,FALSE);
curl_setopt($ch,CURL_HEADER,FALSE);
curl_setopt($ch,CURL_RETURNTRANSFER,TRUE);
//執行curl
$res=curl_exec($ch);
curl_close($ch);
//取出openid
$data=json_decode($res);
if(isset($data['openid'])){
$this->openid=$data['openid'];
}else{
returnnull;
}
return$this->openid;
}
/**
*生成可以獲取openid的URL
*@return[type][description]
*/
publicfunctioncreateOauthUrlForOpenid(){
$urlParams['appid']=WxPayConf::APPID;
$urlParams['secret']=WxPayConf::APPSECRET;
$urlParams['code']=$this->code;
$urlParams['grant_type']="authorization_code";
$queryString=$this->ToUrlParams($urlParams,false);
return"https://api.weixin.qq.com/sns/oauth2/access_token?".$queryString;
}
}
/**
*統一下單介面類
*/
classUnifiedOrder_handleextendsWxpay_client_handle{
publicfunction__construct(){
//設定介面連結
$this->url="https://api.mch.weixin.qq.com/pay/unifiedorder";
//設定curl超時時間
$this->curl_timeout=WxPayConf::CURL_TIMEOUT;
}
}
/**
*響應型介面基類
*/
classWxpay_server_handleextendsJsApi_common{
public$data;//接收到的資料，型別為關聯陣列
public$returnParams;//返回引數，型別為關聯陣列
/**
*將微信請求的xml轉換成關聯陣列
*@param[type]$xml[description]
*@return[type][description]
*/
publicfunctionsaveData($xml){
$this->data=$this->xmlToArray($xml);
}
/**
*驗證簽名
*@return[type][description]
*/
publicfunctioncheckSign(){
$tmpData=$this->data;
unset($temData['sign']);
$sign=$this->getSign($tmpData);
if($this->data['sign']==$sign){
returntrue;
}
returnfalse;
}
/**
*設定返回微信的xml資料
*/
functionsetReturnParameter($parameter,$parameterValue)
{
$this->returnParameters[$this->trimString($parameter)]=$this->trimString($parameterValue);
}
/**
*將xml資料返回微信
*/
functionreturnXml()
{
$returnXml=$this->createXml();
return$returnXml;
}
}
/**
*請求型介面的基類
*/
classWxpay_client_handleextendsJsApi_common{
public$params;//請求引數，型別為關聯陣列
public$response;//微信返回的響應
public$result;//返回引數，型別類關聯陣列
public$url;//介面連結
public$curl_timeout;//curl超時時間
/**
*設定請求引數
*@param[type]$param[description]
*@param[type]$paramValue[description]
*/
publicfunctionsetParam($param,$paramValue){
$this->params[$this->tirmString($param)]=$this->trimString($paramValue);
}
/**
*獲取結果，預設不使用證照
*@return[type][description]
*/
publicfunctiongetResult(){
$this->postxml();
$this->result=$this->xmlToArray($this->response);
return$this->result;
}
/**
*post請求xml
*@return[type][description]
*/
publicfunctionpostxml(){
$xml=$this->createXml();
$this->response=$this->postXmlCurl($xml,$this->curl,$this->curl_timeout);
return$this->response;
}
publicfunctioncreateXml(){
$this->params['appid']=WxPayConf::APPID;//公眾號ID
$this->params['mch_id']=WxPayConf::MCHID;//商戶號
$this->params['nonce_str']=$this->createNoncestr();//隨機字串
$this->params['sign']=$this->getSign($this->params);//簽名
return$this->arrayToXml($this->params);
}
}
/**
*所有介面的基類
*/
classJsApi_common{
function__construct(){
}
publicfunctiontrimString($value){
$ret=null;
if(null!=$value){
$ret=trim($value);
if(strlen($ret)==0){
$ret=null;
}
}
return$ret;
}
/**
*產生隨機字串，不長於32位
*@paraminteger$length[description]
*@return[type][description]
*/
publicfunctioncreateNoncestr($length=32){
$chars="abcdefghijklmnopqrstuvwxyz0123456789";
$str='';
for($i=0;$i<$length;$i++){
$str.=substr($chars,mt_rand(0,strlen($chars)-1),1);
}
return$str;
}
/**
*格式化引數拼接字串，簽名過程需要使用
*@param[type]$urlParams[description]
*@param[type]$needUrlencode[description]
*/
publicfunctionToUrlParams($urlParams,$needUrlencode){
$buff="";
ksort($urlParams);
foreach($urlParamsas$k=>$v){
if($needUrlencode)$v=urlencode($v);
$buff.=$k.'='.$v.'&';
}
$reqString='';
if(strlen($buff)>0){
$reqString=substr($buff,0,strlen($buff)-1);
}
return$reqString;
}
/**
*生成簽名
*@param[type]$params[description]
*@return[type][description]
*/
publicfunctiongetSign($obj){
foreach($objas$k=>$v){
$params[$k]=$v;
}
//簽名步驟一：按字典序排序引數
ksort($params);
$str=$this->ToUrlParams($params,false);
//簽名步驟二：在$str後加入key
$str=$str."$key=".WxPayConf::KEY;
//簽名步驟三：md5加密
$str=md5($str);
//簽名步驟四：所有字元轉為大寫
$result=strtoupper($str);
return$result;
}
/**
*array轉xml
*@param[type]$arr[description]
*@return[type][description]
*/
publicfunctionarrayToXml($arr){
$xml="<xml>";
foreach($arras$k=>$v){
if(is_numeric($val)){
$xml.="<".$key.">".$key."</".$key.">";
}else{
$xml.="<".$key."><![CDATA[".$val."]]></".$key.">";
}
}
$xml.="</xml>";
return$xml;
}
/**
*將xml轉為array
*@param[type]$xml[description]
*@return[type][description]
*/
publicfunctionxmlToArray($xml){
$arr=json_decode(json_encode(simplexml_load_string($xml,'SinpleXMLElement',LIBXML_NOCDATA)),true);
return$arr;
}
/**
*以post方式提交xml到對應的介面
*@param[type]$xml[description]
*@param[type]$url[description]
*@paraminteger$second[description]
*@return[type][description]
*/
publicfunctionpostXmlCurl($xml,$url,$second=30){
//初始化curl
$ch=curl_init();
//設定超時
curl_setopt($ch,CURL_TIMEOUT,$second);
curl_setopt($ch,CURL_URL,$url);
//這裡設定代理，如果有的話
//curl_setopt($ch,CURLOPT_PROXY,'8.8.8.8
//curl_setopt($ch,CURLOPT_PROXYPORT,8080);
curl_setopt($ch,CURL_SSL_VERIFYHOST,FALSE);
curl_setopt($ch,CURL_SSL_VERIFYPEER,FALSE);
//設定header
curl_setopt($ch,CURL_HEADER,FALSE);
//要求結果為字串且輸出到螢幕上
curl_setopt($ch,CURL_RETURNTRANSFER,TRUE);
//以post方式提交
curl_setopt($ch,CURL_POST,TRUE);
curl_setopt($ch,CURL_POSTFIELDS,$xml);
//執行curl
$res=curl_exec($ch);
if($res){
curl_close($ch);
return$res;
}else{
$error=curl_errno($ch);
echo"curl出錯，錯誤碼:$error"."<br>";
echo"<ahref='http://curl.haxx.se/libcurl/c/libcurl-errors.html'>錯誤原因查詢</a></br>";
curl_close($ch);
returnfalse;
}
}
}
/**
*配置類
*/
classWxPayConf{
//微信公眾號身份的唯一標識。
constAPPID='wx654a22c6423213b7';
//受理商ID，身份標識
constMCHID='10043241';
constMCHNAME='KellyCen的部落格';
//商戶支付金鑰Key。
constKEY='0000000000000000000000000000000';
//JSAPI介面中獲取openid
constAPPSECRET='000000000000000000000000000';
//證照路徑,注意應該填寫絕對路徑
constSSLCERT_PATH='/home/WxPayCacert/apiclient_cert.pem';
constSSLKEY_PATH='/home/WxPayCacert/apiclient_key.pem';
constSSLCA_PATH='/home/WxPayCacert/rootca.pem';
//本例程透過curl使用HTTPPOST方法，此處可修改其超時時間，預設為30秒
constCURL_TIMEOUT=30;
}
Wxpay_model.php

獲取到code的URL後，將其分配到頁面去，讓使用者去點選，使用者進行點選後，就會從微信伺服器獲取到code，然後回撥到redirect_uri所指的地址去。

微信開發微信支付
2014-10-16
微信支付開發
2016-06-22
微信 H5 支付 sdk
2018-01-02
H5
關於建行龍支付的聚合支付微信，支付寶對接PC和H5
2021-06-15
H5
PHP支付介面教程，詳解微信支付（一）
2017-06-28
PHP
PHP微信支付開發
2018-09-20
PHP
微信呼叫H5支付
2020-10-12
H5
基於 PAYJS 微信支付個人介面開發的 Laravel Package，可直接用於生產環境
2018-09-18
JSLaravelPackage
開發微信支付的一點心得
2014-05-23
基於Koa2開發微信二維碼掃碼支付相關流程
2018-05-16
微信支付之手機H5支付實踐
2018-08-29
H5
基於 ChatGpt Api 開發的微信小程式
2023-03-11
ChatGPTAPI微信小程式
iOS WKWebView H5微信支付跳轉
2018-11-06
iOSWebViewH5
微信內建H5支付
2024-06-29
H5
微信支付開發(2) 掃碼支付模式一
2014-12-29
模式
微信支付開發(4)掃碼支付模式二
2015-05-31
模式
基於tp開發的一個h5站點
2019-05-11
H5
微信支付開發文件連結
2019-03-26
微信支付介面開發過程
2017-11-15
Android 微信支付開發流程
2017-12-19
Android
微信支付開發避坑指南
2024-09-09
Vue H5微信瀏覽器外進行支付 H5支付
2020-11-13
VueH5瀏覽器
微信開發超市全反系統，微信支付刷卡支付，微信介面簡單配置！
2019-05-11
基於ThinkPHP的微信開發專案-微商城
2019-05-11
PHP
基於 PHP 的微信公眾平臺開發
2017-05-18
PHP
快應用微信H5支付
2019-02-16
H5
微信公眾號支付實現詳解（前端）
2018-02-06
前端
微信開發之微信支付（商戶平臺提供的方式）
2016-09-11
php微信支付介面開發的實現程式
2018-08-20
PHP
基於React的大檔案上傳元件的開發詳解
2019-03-04
React元件
php 微信開發之微信支付 v3 配置
2015-09-30
PHP
微信和支付寶的支付流程，以及開發中遇到的坑？
2018-07-31
基於THINKPHP5 多微信開發框架，讓微信開發飛起來
2019-05-11
PHP框架
微信支付開發(12)認清微信支付v2和v3
2014-09-30
基於後端雲微信小程式開發
2018-07-23
後端微信小程式
基於mui的H5套殼APP開發web框架分享
2020-04-18
UIH5APPWeb框架
微信H5支付如何呼叫外部瀏覽器完成支付
2019-05-10
H5瀏覽器
h5與微信小程式直播開發
2019-02-16
H5微信小程式

基於H5的微信支付開發詳解

相關文章