微信公眾號支付全解析

Tsy遠發表於2017-09-22

簡單介紹了微信公眾號支付的申請、接入、使用、確認支付結果等相關流程

0 系列文章

系列一微信App支付全解析
系列二支付寶App支付全解析
系列三微信公眾號支付全解析
系列四微信掃碼支付全解析
系列五支付寶即時到賬支付全解析
系列六微信退款全解析
系列七支付寶退款全解析
系列八支付寶開放平臺支付更新升級全解析

1 申請

申請步驟直接參考官方文件

主要2個大塊：

申請開通公眾平臺，建立應用
申請支付開通商戶平臺

全部申請通過後，獲取支付必須的引數如下：

1.1 AppID和AppSecret

公眾平臺建立的應用唯一標識。
登入微信公眾平臺，進入應用詳情可檢視AppID和AppSecret。

1.2 mch_id

微信支付申請完成之後，微信商戶平臺會給你的郵箱發通知郵件，裡面包含開通支付的商戶資訊

1.3 API祕鑰

即商戶支付祕鑰，主要負責處理通訊相關引數加密。登陸微信商戶平臺（賬號密碼在微信商戶平臺發來的郵件裡）
點選左側的「賬戶設定 - API 安全」（第一次登陸會讓你安裝操作證照，請先安裝操作證照）。點選設定金鑰，設定自己的金鑰。

1.4 商戶證照

用於退款等一些需要證照驗證的介面使用。在微信商戶平臺點選「賬戶中心 - API 安全」，點選「下載證照」

證照下載後，開啟壓縮包會看到「apiclient_cert.pem」和「apiclient_key.pem」和rootca.pem證照。

2 接入流程

參考接入文件

主要幾個步驟：

統一下單（放在服務端，需要加密引數）
生成支付引數（放在服務端，需要生成簽名）
呼叫客戶端SDK發起支付
服務端非同步接收支付結果

2.1 統一下單

$appid = "";  //你的appid
$mch_id = "";  //商戶id
$wx_api_key = "";    //商戶api祕鑰
$out_trade_no = "";  //自己業務系統生成的交易no，可以唯一標識
$client_ip = "";  //客戶端ip
$notify_url = "";    //接收支付結果通知url
$openid = "";    //微信授權獲得的openid

$UNIFIED_ORDER_URL = "https://api.mch.weixin.qq.com/pay/unifiedorder";  //統一下單地址

$data = array();
$data['appid'] = $appid; 
$data['mch_id'] =$mch_id;
$data['nonce_str'] = randomStr(20);  //隨機20位字串
$data['body'] = "微信公眾號支付測試";
$data['detail'] = "微信公眾號支付測試detail";
$data['out_trade_no'] = $out_trade_no;    
$data['total_fee'] = 1;  //注意 單位是分
$data['spbill_create_ip'] = $client_ip;
$data['openid'] = $openid;
$data['notify_url'] = $notify_url;
$data['trade_type'] = "JSAPI";  //交易型別
$data['sign'] =sign($data, $wx_api_key);    //簽名

//轉為xml格式
$xml_str = arrayToXmlStr($data); 

//傳送請求 使用封裝好的curl_post
$result = curl_post($UNIFIED_ORDER_URL, $xml_str);

//解析得到的值
$get_data = simplexml_load_string($raw_data, 'SimpleXMLElement', LIBXML_NOCDATA);
$get_para = array();
$get_sign = "";
foreach ($get_data->children() as $child) 
{    
  if($child->getName() == 'sign') {        
    $get_sign = strval($child);    
  } else {        
    $get_para[strval($child->getName())] = strval($child);    
   }
}

if($get_para['return_code'] !== "SUCCESS") {
    //return code fail
}

//驗證簽名
if(!verifySign($get_sign, $get_para, $wx_api_key)) {
    //驗證簽名非法
}

//可以自行處理解析獲得的引數
//todo...複製程式碼

一些函式：

/**
 * array轉成xml str
 * @param $arr
 */
public static function arrayToXmlStr($arr) {    
  $xml_data = new \SimpleXMLElement("<xml></xml>");    
  Func::arrayToXml($arr, $xml_data);    
  return $xml_data->asXML();
}

/**
 * 生成指定長度的隨機字串(包含大寫英文字母, 小寫英文字母, 數字)
 * @param $length int 需要生成的字串的長度
 * @return string 包含 大小寫英文字母 和 數字 的隨機字串
 */
public static function randomStr($length){    
  //生成一個包含 大寫英文字母, 小寫英文字母, 數字 的陣列    
  $arr = array_merge(range(0, 9), range('a', 'z'), range('A', 'Z'));    
  $str = '';    
  $arr_len = count($arr);    
  for ($i = 0; $i < $length; $i++)    {        
    $rand = mt_rand(0, $arr_len-1);        
    $str.=$arr[$rand];    
  }    
  return $str;
}

/**
 * 微信簽名
 * @param $para mixed 帶簽名引數陣列
 * @param $wx_key string wxkey
 */
public static function sign($para, $wx_key) {    
  $unsign_str = Func::createLinkString(Func::argSort($para)) . "&key=" . $wx_key;    
  $sign = strtoupper(md5($unsign_str));    
  return $sign;
}

/**
 * 微信簽名驗證
 * @param $sign
 * @param $para
 * @param $wx_key
 * @return false-驗證失敗 true-驗證成功
 */
public static function verifySign($sign, $para, $wx_key) {    
  $unsign_str = Func::createLinkString(Func::argSort($para)) . "&key=" . $wx_key;    
  $sign_str = strtoupper(md5($unsign_str));    
  if($sign === $sign_str) {        
    return true;    
  }    
  return false;
}複製程式碼

2.2 生成支付引數

客戶端需要的支付引數是帶簽名的，所以最好支付引數也在服務端生成後，jsondecode後傳入客戶端即可直接呼叫

//生成支付引數
$data = array();
$data['appId'] = $appid;
$data['timeStamp'] = time();
$data['nonceStr'] = randomStr(20);
$data['package'] = "prepay_id=$prepay_id";
$data['signType'] = "MD5";
$data['timestamp'] = time();
$data['sign'] =sign($data, $wx_api_key);

$pay_param = json_encode($data);複製程式碼

3. 呼叫支付

注：微信公眾號發起支付的路徑必須是在公眾號支付-開發配置-公眾號支付-支付授權目錄中設定中填入的支付路徑，而且不能是多級目錄

客戶端js呼叫,封裝了一個簡單的js，可以直接呼叫：

//呼叫微信JS api 支付function 
jsApiCall(pay_param, callback){ 
  var pay_param_arr = eval("(" + pay_param + ")"); 
  WeixinJSBridge.invoke( 
    'getBrandWCPayRequest',{ 
      'appId':pay_param_arr.appId,   
      'timeStamp':pay_param_arr.timeStamp+"", 
      'nonceStr':pay_param_arr.nonceStr, 
      'package':pay_param_arr.package, 
      'signType':pay_param_arr.signType, 
      'paySign':pay_param_arr.paySign 
    }, 
    function(res){ 
      if(res.err_msg == "get_brand_wcpay_request:ok") { 
        //成功 
        callback("ok"); 
      } else if(res.err_msg == "get_brand_wcpay_request:cancel") {   
        //取消 
        callback("cancel"); 
      } else { 
        //失敗 
        callback("fail", res.err_desc); 
      } 
    } );
  }

/** * 微信公眾號支付
 * @param pay_param 服務端生成的pay_param
 */
function callWxJsPay(pay_param, callback){ 
  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(pay_param, callback); 
  }
}複製程式碼

呼叫示例：

<html>
<head> 
  <meta http-equiv="content-type" content="text/html;charset=utf-8"/> 
  <meta name="viewport" content="width=device-width, initial-scale=1"/> 
  <title>微信支付樣例-支付</title> 
  <script type="text/javascript" src="../pay_h5_sdk/js/wx_jspay.js"></script> 
  <script type="text/javascript"> 
    function docallpay() { 
      var pay_param = document.getElementById('pay_param').value; 
      callWxJsPay(pay_param, callback); 
    } 
    function callback(state, msg) { 
      alert(state + " " + msg); 
    } 
  </script>
</head>

<body>
<br/>
<div align="center"> 
  輸入支付引數：<br /><br /> 
  <textarea id="pay_param"></textarea> <br/><br />   
  <button style="width:210px; height:50px; border-radius: 15px;background-color:#FE6714; border:0px #FE6714 solid; cursor: pointer; color:white; font-size:16px;" type="button" onclick="docallpay()" >立即支付</button>
</div>
</body>
</html>複製程式碼

4 非同步結果通知

注：尤其要注意通知結果驗證成功後要能正確處理重複通知，放置多次發貨造成資金損失

$raw_data = $GLOBALS["HTTP_RAW_POST_DATA"];

$get_data = simplexml_load_string($raw_data, 'SimpleXMLElement', LIBXML_NOCDATA);
$get_para = array();
$get_sign = "";
foreach ($get_data->children() as $child) 
{    
  if($child->getName() == 'sign') {        
    $get_sign = strval($child);    
  } else {        
    $get_para[strval($child->getName())] = strval($child);    
   }
}

if($get_para['return_code'] !== "SUCCESS") {
    //return code fail
    die("<xml><return_code><![CDATA[FAIL]]></return_code></xml>");
}

//驗證簽名
if(!verifySign($get_sign, $get_para, $wx_api_key)) {
    //驗證簽名非法
    //todo
    die("<xml><return_code><![CDATA[FAIL]]></return_code></xml>");
}

//在這其實通知已經接受成功 可以返回成功告訴微信不用再次通知了
echo("<xml><return_code><![CDATA[SUCCESS]]></return_code></xml>");

//業務狀態碼判斷
if ($get_para['result_code'] !== 'SUCCESS') {       //狀態碼錯誤
  //支付錯誤 更改訂單狀態 記錄log等 
  //...
}

//支付成功 更改訂單狀態 記錄log等 
//todo複製程式碼

5 其他

客戶端收到同步支付結果後建議一段時間內輪詢檢查服務端，獲取服務端的結果，支付最終狀態以服務端為準

結尾

更多文章關注我的公眾號

微信公眾號支付開發全過程（Java 版）
2018-07-08
Java
微信公眾號支付踩坑記
2018-09-30
微信支付V3微信公眾號支付PHP教程(thinkPHP5公眾號支付)/JSSDK的使用
2018-02-02
PHPJS
thinkphp整合系列之微信公眾號支付
2017-09-04
PHP
微信sdk 公眾號微信支付 NFC 坑&筆記
2019-01-30
筆記
微信公眾號支付開發手記（node）
2018-11-12
微信公眾號支付實現詳解（前端）
2018-02-06
前端
Laravel+easywechat 實現公眾號微信支付
2019-12-02
Laravel
vue專案使用微信公眾號支付總結
2018-10-23
Vue
微信的三種支付方式接入：APP支付、公眾號支付、掃碼支付
2016-08-16
APP
微信App支付全解析
2017-09-22
APP
微信公眾號智慧回答
2020-05-25
微信公眾號開發
2018-05-22
微信公眾號系統
2016-12-07
微信公眾號--入門
2017-12-27
微信公眾號投票活動製作教程微信公眾號投票怎麼弄？
2018-03-10
微信掃碼支付全解析
2017-09-22
微信公眾號開發-分享
2020-09-10
微信公眾號檢視地址
2018-01-17
微信公眾號介面導讀
2018-03-30
.net開發微信公眾號
2018-04-10
【前端】微信公眾號推薦
2017-02-24
前端
微信開發之公眾號
2015-01-23
Python 抓取微信公眾號賬號資訊
2016-10-23
Python
[微信公眾號] 配置與應用
2019-08-19
【微信公眾號】配置與應用
2019-08-19
爬取微信公眾號文章工具
2021-03-31
微信公眾號-入門的坑
2018-08-21
微信公眾號下發紅包 -- PHP
2018-08-16
PHP
Nodejs微信公眾號開發
2018-11-12
NodeJS
微信公眾號自動回覆_Java
2019-01-08
Java
Sanic 微信公眾號開發 --- 初探
2018-02-06
Python微信公眾號開發
2018-01-25
Python
微信公眾號開發點滴
2017-04-02
微信公眾號選單的配置
2018-04-04
微信公眾號h5支付以及獲取code（前端部分）
2019-03-02
H5前端
公眾號支付-從服務號申請到支付呼叫爬坑
2019-02-12
國慶節微信公眾號活動分享，如何做好十一國慶節微信公眾號活動
2020-06-17