微信小程序的支付和退款流程
近期在做微信小程序時(shí)，涉及到了小程序的支付和退款流程，所以也大概的將這方面的東西看了一個(gè)遍，就在這篇博客里總結(jié)一下。
首先說明一下，微信小程序支付的主要邏輯集中在后端，前端只需攜帶支付所需的數(shù)據(jù)請(qǐng)求后端接口然后根據(jù)返回結(jié)果做相應(yīng)成功失敗處理即可。我在后端使用的是php，當(dāng)然在這篇博客里我不打算貼一堆代碼來說明支付的具體實(shí)現(xiàn)，而主要會(huì)側(cè)重于整個(gè)支付的流程和一些細(xì)節(jié)方面的東西。所以使用其他后端語言的朋友有需要也是可以看一下的。很多時(shí)候開發(fā)的需求和相應(yīng)問題的解決真的要跳出語言語法層面，去從系統(tǒng)和流程的角度考慮。好的，也不說什么廢話了。進(jìn)入正題。
一. 支付支付主要分為幾個(gè)步驟：
前端攜帶支付需要的數(shù)據(jù)(商品id，購買數(shù)量等)發(fā)起支付請(qǐng)求
后端在接收到支付請(qǐng)求后，處理支付數(shù)據(jù)，然后攜帶處理后的數(shù)據(jù)請(qǐng)求 微信服務(wù)器 的 支付統(tǒng)一下單接口
后端接收到上一步請(qǐng)求微信服務(wù)器的返回?cái)?shù)據(jù)，再次處理，然后返回前端讓前端可以開始支付。
前端進(jìn)行支付動(dòng)作
前端支付完成后，微信服務(wù)器會(huì)向后端發(fā)送支付通知（也就是微信要告訴你客戶已經(jīng)付過錢了），后端根據(jù)這個(gè)通知確定支付完成，然后就去做支付完成后的相應(yīng)動(dòng)作，比如修改訂單狀態(tài)，添加交易日志啊等等。
從這幾個(gè)步驟可以看出，后端主要的作用就是將支付需要的數(shù)據(jù)傳給微信服務(wù)器，再根據(jù)微信服務(wù)器的響應(yīng)確定支付是否完成。 這個(gè)流程還是蠻容易理解的。形象的說，前端就是個(gè)顧客，后端就是店家，微信服務(wù)器的統(tǒng)一下單接口就像收銀員。顧客跟店家說， 我是誰誰誰，現(xiàn)在我要付多少多少錢給你買什么什么。店家就跟收銀員說，那個(gè)誰誰誰要付多少錢，你準(zhǔn)備收錢吧。收銀員收到錢 后，就去告訴店家，我已經(jīng)收到錢了，你給他東西吧。
下面就詳細(xì)的說明一下各個(gè)步驟的具體實(shí)現(xiàn)。
1. 前端請(qǐng)求支付
前端請(qǐng)求支付，就是簡單的攜帶支付需要的數(shù)據(jù)，例如用戶標(biāo)識(shí)，支付金額，支付訂單 ID 等等跟 **你的業(yè)務(wù)邏輯有關(guān)** 或者跟 **下一步請(qǐng)求微信服務(wù)器支付統(tǒng)一下單接口需要的數(shù)據(jù)有關(guān)** 的相關(guān)數(shù)據(jù)，使用微信小程序的 wx.request( ) 去請(qǐng)求后端的支 付接口。
2. 前端請(qǐng)求支付
后端接收到前端發(fā)送的支付請(qǐng)求后，可以進(jìn)行一下相關(guān)驗(yàn)證，例如判斷一下用戶有沒有問題，支付金額對(duì)不對(duì)等等。 在驗(yàn)證沒什么問題，可以向微信服務(wù)器申請(qǐng)支付之后，后端需要使用 微信規(guī)定的數(shù)據(jù)格式 去請(qǐng)求微信的支付統(tǒng)一下單接口。
微信規(guī)定的請(qǐng)求數(shù)據(jù):
這需要較多代碼實(shí)現(xiàn)。因?yàn)樾枰臄?shù)據(jù)個(gè)數(shù)較多，而且還需要加密并以 XML 格式發(fā)送。
首先，有以下數(shù)據(jù)是使用小程序支付必須提供給微信服務(wù)器的參數(shù)。
小程序 appid。寫小程序的大概沒有不知道這個(gè)的。。。用戶標(biāo)識(shí) openid。也就是用戶的小程序標(biāo)識(shí)，在我上篇博客中說明了如何獲取。
商戶號(hào) mch_id 。申請(qǐng)開通微信支付商戶認(rèn)證成功后微信發(fā)給你的郵件里有
商戶訂單號(hào) out_trade_no 。商戶為這次支付生成的訂單號(hào)
總金額 total_fee 。訂單總金額，很重要的一點(diǎn)是單位是分，要特別注意。
微信服務(wù)器回調(diào)通知接口地址 notify_url。微信確認(rèn)錢已經(jīng)到賬后，會(huì)往這個(gè)地址多次發(fā)送消息，告訴你顧客已經(jīng)付完錢了，
你需要返回消息給微信表示你已經(jīng)收到了通知。。這個(gè)地址不能有端口號(hào)，同時(shí)要能直接接受POST方法請(qǐng)求。
交易類型 trade_type 。微信小程序支付此值統(tǒng)一為 JSAPI
商品信息 Body。類似"騰訊-游戲"這種格式
終端IP地址 spbill_create_ip 。終端地址IP，也就是請(qǐng)求支付的 IP 地址。
隨機(jī)字符串 nonce_str 。需要后端隨機(jī)生成的字符串用于保證數(shù)據(jù)安全。微信要求不長于32位。
簽名 sign 。使用上面的所有參數(shù)進(jìn)行相應(yīng)處理加密生成簽名。（具體處理方式可見下文代碼，可直接復(fù)用。）
在處理好以上所有數(shù)據(jù)后，將這些數(shù)據(jù)以 XML 格式整理并以 POST 方法發(fā)送到 微信支付統(tǒng)一下單接口 https://api.mch.weixin.qq.com/pay/unifiedorder 。
3.后端接受微信服務(wù)器返回?cái)?shù)據(jù)微信服務(wù)器在接收到支付數(shù)據(jù)之后，如果數(shù)據(jù)沒有問題，其會(huì)返回用于支付的相應(yīng)數(shù)據(jù)，其中非常重要的是 名稱為 prepay_id 的數(shù)據(jù)字段，需要將此數(shù)據(jù)返回前端，前端才能繼續(xù)支付。
因此，在后端接收到微信服務(wù)器的返回?cái)?shù)據(jù)后，需要進(jìn)行相應(yīng)的處理，最終返回到前端如下數(shù)據(jù)：
appid 不需多說
timeStamp 當(dāng)前時(shí)間戳
nonceStr 隨機(jī)字符串
package 就是上面提到的 prepay_id，不過切記格式如 “prepay_id= prepay_id_item“。否則會(huì)導(dǎo)致錯(cuò)誤。
signType 加密方式，一般應(yīng)該是 MD5
paySign 對(duì)以上數(shù)據(jù)進(jìn)行相應(yīng)處理并加密。
到這里，后端的支付接口已經(jīng)完成了接收前端支付請(qǐng)求，并返回了前端支付所需數(shù)據(jù)的功能。
4. 前端發(fā)起支付前端在接收到返回?cái)?shù)據(jù)后，使用 wx.requestPayment() 來請(qǐng)求發(fā)起支付。此 API 需要的對(duì)象參數(shù)各項(xiàng)值就是我們上一步返回的各個(gè)數(shù)據(jù)。
5.后端接受微信服務(wù)器回調(diào)前端完成支付后，微信服務(wù)器確認(rèn)支付已經(jīng)完成。就會(huì)向第一步中設(shè)置的回調(diào)地址發(fā)送通知。后端的接收回調(diào)接口在接收到通知后，就可以判斷支付是否完成，從而決定后續(xù)動(dòng)作。
需要注意的是，在接收到微信服務(wù)器的回調(diào)通知后，根據(jù)通知的result_code字段判斷支付是否成功。在接受到成功的通知后，后端需要返回success數(shù)據(jù)向微信服務(wù)器告知已得到回調(diào)通知。否則微信服務(wù)器會(huì)不停的向后端發(fā)送消息。另外微信的通知是以XML格式發(fā)送的，在接受處理時(shí)需要注意。
微信的大概支付流程就是這樣。以下是PHP語法的微信支付類，可以比照上面的步驟介紹，加深理解。在需要支付時(shí)，直接傳入?yún)?shù)實(shí)例化此類再調(diào)用類的 pay 方法即可。
重慶分公司
重慶分公司
//微信支付類
class WeiXinPay{
//=======【基本信息設(shè)置】=====================================
//微信公眾號(hào)身份的唯一標(biāo)識(shí)
protected $APPID = appid;//填寫您的appid。微信公眾平臺(tái)里的
protected $APPSECRET = secret;
//受理商ID，身份標(biāo)識(shí)
protected $MCHID = '11111111';//商戶id
//商戶支付密鑰Key
protected $KEY = '192006250b4c09247ec02edce69f6a2d';
//回調(diào)通知接口
protected $APPURL = 'https://smart.afei.com/receivesuc';
//交易類型
protected $TRADETYPE = 'JSAPI';
//商品類型信息
protected $BODY = 'wx/book';
//微信支付類的構(gòu)造函數(shù)
function __construct($openid,$outTradeNo,$totalFee){
$this->openid = $openid; //用戶唯一標(biāo)識(shí)
$this->outTradeNo = $outTradeNo; //商品編號(hào)
$this->totalFee = $totalFee; //總價(jià)
}
//微信支付類向外暴露的支付接口
public function pay(){
$result = $this->weixinapp();
return $result;
}
//對(duì)微信統(tǒng)一下單接口返回的支付相關(guān)數(shù)據(jù)進(jìn)行處理
private function weixinapp(){
$unifiedorder=$this->unifiedorder();
$parameters=array(
'appId'=>$this->APPID,//小程序ID
'timeStamp'=>''.time().'',//時(shí)間戳
'nonceStr'=>$this->createNoncestr(),//隨機(jī)串
'package'=>'prepay_id='.$unifiedorder['prepay_id'],//數(shù)據(jù)包
'signType'=>'MD5'//簽名方式
);
$parameters['paySign']=$this->getSign($parameters);
return $parameters;
}
/*
*請(qǐng)求微信統(tǒng)一下單接口
*/
private function unifiedorder(){
$parameters = array(
'appid' => $this->APPID,//小程序id
'mch_id'=> $this->MCHID,//商戶id
'spbill_create_ip'=>$_SERVER['REMOTE_ADDR'],//終端ip
'notify_url'=>$this->APPURL, //通知地址
'nonce_str'=> $this->createNoncestr(),//隨機(jī)字符串
'out_trade_no'=>$this->outTradeNo,//商戶訂單編號(hào)
'total_fee'=>floatval($this->totalFee), //總金額
'open_id'=>$this->openid,//用戶openid
'trade_type'=>$this->TRADETYPE,//交易類型
'body' =>$this->BODY, //商品信息
);
$parameters['sign'] = $this->getSign($parameters);
$xmlData = $this->arrayToXml($parameters);
$xml_result = $this->postXmlCurl($xmlData,'https://api.mch.weixin.qq.com/pay/unifiedorder',60);
$result = $this->xmlToArray($xml_result);
return $result;
}
//數(shù)組轉(zhuǎn)字符串方法
protected function arrayToXml($arr){
$xml = "";
foreach ($arr as $key=>$val)
{
if (is_numeric($val)){
$xml.="<".$key.">".$val."";
}else{
$xml.="<".$key.">";
}
}
$xml.=" ";
return $xml;
}
protected function xmlToArray($xml){
$array_data = json_decode(json_encode(simplexml_load_string($xml, 'SimpleXMLElement', LIBXML_NOCDATA)), true);
return $array_data;
}
//發(fā)送xml請(qǐng)求方法
private static function postXmlCurl($xml, $url, $second = 30)
{
$ch = curl_init();
//設(shè)置超時(shí)
curl_setopt($ch, CURLOPT_TIMEOUT, $second);
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE); //嚴(yán)格校驗(yàn)
//設(shè)置header
curl_setopt($ch, CURLOPT_HEADER, FALSE);
//要求結(jié)果為字符串且輸出到屏幕上
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
//post提交方式
curl_setopt($ch, CURLOPT_POST, TRUE);
curl_setopt($ch, CURLOPT_POSTFIELDS, $xml);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 20);
curl_setopt($ch, CURLOPT_TIMEOUT, 40);
set_time_limit(0);
//運(yùn)行curl
$data = curl_exec($ch);
//返回結(jié)果
if ($data) {
curl_close($ch);
return $data;
} else {
$error = curl_errno($ch);
curl_close($ch);
throw new WxPayException("curl出錯(cuò)，錯(cuò)誤碼:$error");
}
}
/*
* 對(duì)要發(fā)送到微信統(tǒng)一下單接口的數(shù)據(jù)進(jìn)行簽名
*/
protected function getSign($Obj){
foreach ($Obj as $k => $v){
$Parameters[$k] = $v;
}
//簽名步驟一：按字典序排序參數(shù)
ksort($Parameters);
$String = $this->formatBizQueryParaMap($Parameters, false);
//簽名步驟二：在string后加入KEY
$String = $String."&key=".$this->KEY;
//簽名步驟三：MD5加密
$String = md5($String);
//簽名步驟四：所有字符轉(zhuǎn)為大寫
$result_ = strtoupper($String);
return $result_;
}
/*
*排序并格式化參數(shù)方法，簽名時(shí)需要使用
*/
protected function formatBizQueryParaMap($paraMap, $urlencode)
{
$buff = "";
ksort($paraMap);
foreach ($paraMap as $k => $v)
{
if($urlencode)
{
$v = urlencode($v);
}
//$buff .= strtolower($k) . "=" . $v . "&";
$buff .= $k . "=" . $v . "&";
}
$reqPar;
if (strlen($buff) > 0)
{
$reqPar = substr($buff, 0, strlen($buff)-1);
}
return $reqPar;
}
/*
* 生成隨機(jī)字符串方法
*/
protected function createNoncestr($length = 32 ){
$chars = "abcdefghijklmnopqrstuvwxyz0123456789";
$str ="";
for ( $i = 0; $i < $length; $i++ ) {
$str.= substr($chars, mt_rand(0, strlen($chars)-1), 1);
}
return $str;
}
} 
