「微信支付接口开发」基于H5的微信支付开发详解

微信支付接口开发

这次总结一下用户在微信内打开网页时，可以调用微信支付完成下单功能的模块开发，也就是在微信内的h5页面通过jsApi接口实现支付功能。当然了，微信官网上的微信支付开发文档也讲解的很详细，并且有实现代码可供参考，有的朋友直接看文档就可以自己实现此支付接口的开发了。

一、前言

为何我还写一篇微信支付接口的博文呢？第一，我们必须知道，所谓的工作经验很多都是靠总结出来的，你只有总结了更多知识，积累了更多经验，你才能在该行业中脱颖而出，我个人觉得如今的招聘，很多都需要工作经验（1年、3年、5年....），其实，工作时间的长久不能衡量一个人技术水平的高低，有的人一年的工作经验能拿3年工作经验的程序猿的工资，有的3 年工作经验的却有可能比别人只有一年工作经验的还低，所以说，总结才能让自己的知识体系，经验深度更牛逼更稳固（虽然写一篇博文挺花费时间的）；第二，写博文分享给大家还是挺有成就感的，首先是能让新手从我分享的博文中能学到东西，并且能快速将博文所讲解的技术运用到实际中来，所以我写的博文基本上能让新人快速读懂并且容易理解，另外，技术大神的话，看到博文有讲解的不对之处，还可以指出，并且可以交流，何乐而不为呢，我们需要的就是分享和交流。

扯远了，直接进入该主题的详解。

现在的微信支付方式有N种，看下图，有刷卡支付、公众号支付、扫码支付和APP支付，另外还有支付工具的开发，本博文选择的是公众号支付借口而开发进行讲解，其他几种支付接口开发基本上思路都是一样的，只要你能看懂我这博文所讲解的基本思路，你基本上也能独自开发其他几个支付接口。

HTML5教程 HTML5技术微信支付微信支付接口开发微信支付api

二、思路详解

我们可以拿微信支付接口文档里的业务流程时序图看看，如下图，基本思路是这样子：首先在后台生成一个链接，展示给用户让用户点击（例如页面上有微信支付的按钮），用户点击按钮后，网站后台会根据订单的相关信息生成一个支付订单，此时会调用统一下单接口，对微信支付系统发起请求，而微信支付系统受到请求后，会根据请求过来的数据，生成一个预支付交易会话标识（prepay_id，就是通过这个来识别该订单的），我们的网站收到微信支付系统的响应后，会得到prepay_id，然后通过自己构造微信支付所需要的参数，接着将支付所需参数返回给客户端，用户此时可能会有一个订单信息页，会有一个按钮，点击支付，此时会调用JSAPI接口对微信支付系统发起请求支付，微信支付系统检查了请求的相关合法性之后，就会提示输入密码，用户此时输入密码确认，微信支付系统会对其进行验证，通过的话会返回支付结果，然后微信跳转会H5页面，这其中有一步是异步通知网站支付结果，我们网站需要对此进行处理（比如说异步支付结果通过后，需要更新数据表或者订单信息，例如标志用户已支付该订单了，同时也需要更新订单日志，防止用户重复提交订单）。

HTML5教程 HTML5技术微信支付微信支付接口开发微信支付api

三、代码讲解

本次开发环境用的是php5.6 + my sql + 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的代码了,里面基本上每一个类每一个方法甚至每一行代码都会有解释的了，这里我就不对其展开一句句分析了：

<?phpdefined('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;//用户的openidpublic$parameters;//jsapi参数，格式为json
public$prepay_id;//使用统一支付接口得到的预支付idpublic$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);
//设置headercurl_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所指的地址去。

基于H5的微信支付开发详解

微信支付接口开发

相关阅读

栏目导航

推荐阅读

热门阅读