近期在做微信小程序時，涉及到了小程序的支付和退款流程围俘，所以也大概的將這方面的東西看了一個遍砸讳，就在這篇博客里總結(jié)一下。
首先說明一下界牡，微信小程序支付的主要邏輯集中在后端簿寂，前端只需攜帶支付所需的數(shù)據(jù)請求后端接口然后根據(jù)返回結(jié)果做相應(yīng)成功失敗處理即可。我在后端使用的是php宿亡，當然在這篇博客里我不打算貼一堆代碼來說明支付的具體實現(xiàn)常遂，而主要會側(cè)重于整個支付的流程和一些細節(jié)方面的東西。所以使用其他后端語言的朋友有需要也是可以看一下的挽荠。很多時候開發(fā)的需求和相應(yīng)問題的解決真的要跳出語言語法層面克胳，去從系統(tǒng)和流程的角度考慮泊碑。好的，也不說什么廢話了毯欣。進入正題馒过。
一. 支付
支付主要分為幾個步驟：
前端攜帶支付需要的數(shù)據(jù)(商品id，購買數(shù)量等)發(fā)起支付請求
-
后端在接收到支付請求后酗钞，處理支付數(shù)據(jù)腹忽，然后攜帶處理后的數(shù)據(jù)請求
微信服務(wù)器
的
支付統(tǒng)一下單接口
后端接收到上一步請求微信服務(wù)器的返回數(shù)據(jù)，再次處理砚作，然后返回前端讓前端可以開始支付窘奏。
前端進行支付動作
前端支付完成后，微信服務(wù)器會向后端發(fā)送支付通知（也就是微信要告訴你客戶已經(jīng)付過錢了）葫录，后端根據(jù)這個通知確定支付完成着裹，然后就去做支付完成后的相應(yīng)動作，比如修改訂單狀態(tài)米同，添加交易日志啊等等骇扇。
從這幾個步驟可以看出，后端主要的作用就是將支付需要的數(shù)據(jù)傳給微信服務(wù)器面粮，再根據(jù)微信服務(wù)器的響應(yīng)確定支付是否完成少孝。
這個流程還是蠻容易理解的。形象的說熬苍，前端就是個顧客稍走，后端就是店家，微信服務(wù)器的統(tǒng)一下單接口就像收銀員柴底。顧客跟店家說婿脸，我是誰誰誰，現(xiàn)在我要付多少多少錢給你買什么什么柄驻。店家就跟收銀員說狐树，那個誰誰誰要付多少錢，你準備收錢吧凿歼。收銀員收到錢后褪迟，就去告訴店家，我已經(jīng)收到錢了答憔，你給他東西吧味赃。
下面就詳細的說明一下各個步驟的具體實現(xiàn)。
1. 前端請求支付
前端請求支付虐拓，就是簡單的攜帶支付需要的數(shù)據(jù)心俗，例如用戶標識，支付金額，支付訂單 ID 等等跟 **你的業(yè)務(wù)邏輯有關(guān)** 或者跟 **下一步請求微信服務(wù)器支付統(tǒng)一下單接口需要的數(shù)據(jù)有關(guān)** 的相關(guān)數(shù)據(jù)城榛，使用微信小程序的 wx.request( ) 去請求后端的支付接口揪利。
2. 后端請求微信服務(wù)器
后端接收到前端發(fā)送的支付請求后，可以進行一下相關(guān)驗證狠持，例如判斷一下用戶有沒有問題疟位，支付金額對不對等等。
在驗證沒什么問題喘垂，可以向微信服務(wù)器申請支付之后甜刻，后端需要使用 微信規(guī)定的數(shù)據(jù)格式 去請求微信的支付統(tǒng)一下單接口。
微信規(guī)定的請求數(shù)據(jù):
這需要較多代碼實現(xiàn)正勒。因為需要的數(shù)據(jù)個數(shù)較多得院，而且還需要加密并以 XML 格式發(fā)送。
首先章贞，有以下數(shù)據(jù)是使用小程序支付必須提供給微信服務(wù)器的參數(shù)祥绞。
- 小程序 appid。寫小程序的大概沒有不知道這個的鸭限。蜕径。。
- 用戶標識 openid里覆。也就是用戶的小程序標識丧荐，在我<u style="box-sizing: inherit; text-decoration: none; border-bottom: 1px solid rgba(64, 64, 64, 0.721569);">上篇博客</u>中說明了如何獲取阔籽。
- 商戶號 mch_id 未斑。申請開通微信支付商戶認證成功后微信發(fā)給你的郵件里有
- 商戶訂單號 out_trade_no 悠鞍。商戶為這次支付生成的訂單號
- 總金額 total_fee 。訂單總金額隧甚，很重要的一點是單位是分，要特別注意渡冻。
- 微信服務(wù)器回調(diào)通知接口地址 notify_url戚扳。微信確認錢已經(jīng)到賬后，會往這個地址多次發(fā)送消息族吻，告訴你顧客已經(jīng)付完錢了帽借，你需要返回消息給微信表示你已經(jīng)收到了通知。超歌。這個地址不能有端口號砍艾，同時要能直接接受POST方法請求。
- 交易類型 trade_type 巍举。微信小程序支付此值統(tǒng)一為 JSAPI
- 商品信息 Body脆荷。類似"騰訊-游戲"這種格式
- 終端IP地址 spbill_create_ip 。終端地址IP，也就是請求支付的 IP 地址蜓谋。
- 隨機字符串 nonce_str 梦皮。需要后端隨機生成的字符串用于保證數(shù)據(jù)安全。微信要求不長于32位桃焕。
- 簽名 sign 剑肯。使用上面的所有參數(shù)進行相應(yīng)處理加密生成簽名。（具體處理方式可見下文代碼观堂，可直接復(fù)用退子。）
在處理好以上所有數(shù)據(jù)后，將這些數(shù)據(jù)以 XML 格式整理并以 POST 方法發(fā)送到
微信支付統(tǒng)一下單接口 <u style="box-sizing: inherit; text-decoration: none; border-bottom: 1px solid rgba(64, 64, 64, 0.721569);">[https://
api.mch.weixin.qq.com/p
ay/unifiedorder](http://link.zhihu.com/?target=https%3A//api.mch.weixin.qq.com/pay/unifiedorder)</u>
型将。
3.后端接受微信服務(wù)器返回數(shù)據(jù)
微信服務(wù)器在接收到支付數(shù)據(jù)之后寂祥，如果數(shù)據(jù)沒有問題，其會返回用于支付的相應(yīng)數(shù)據(jù)七兜，其中非常重要的是 名稱為 prepay_id 的數(shù)據(jù)字段丸凭，需要將此數(shù)據(jù)返回前端，前端才能繼續(xù)支付腕铸。
因此惜犀，在后端接收到微信服務(wù)器的返回數(shù)據(jù)后，需要進行相應(yīng)的處理狠裹，最終返回到前端如下數(shù)據(jù)：
- appid 不需多說
- timeStamp 當前時間戳
- nonceStr 隨機字符串
- package 就是上面提到的 prepay_id虽界，不過切記格式如 “prepay_id= prepay_id_item“。否則會導(dǎo)致錯誤涛菠。
- signType 加密方式莉御，一般應(yīng)該是 MD5
- paySign 對以上數(shù)據(jù)進行相應(yīng)處理并加密。
到這里俗冻，后端的支付接口已經(jīng)完成了接收前端支付請求礁叔，并返回了前端支付所需數(shù)據(jù)的功能。
4. 前端發(fā)起支付
前端在接收到返回數(shù)據(jù)后迄薄，使用 wx.requestPayment() 來請求發(fā)起支付琅关。此 API 需要的對象參數(shù)各項值就是我們上一步返回的各個數(shù)據(jù)。
5.后端接受微信服務(wù)器回調(diào)
前端完成支付后讥蔽，微信服務(wù)器確認支付已經(jīng)完成涣易。就會向第一步中設(shè)置的回調(diào)地址發(fā)送通知。后端的接收回調(diào)接口在接收到通知后冶伞，就可以判斷支付是否完成新症，從而決定后續(xù)動作。
需要注意的是碰缔，在接收到微信服務(wù)器的回調(diào)通知后账劲，根據(jù)通知的result_code字段判斷支付是否成功。在接受到成功的通知后，后端需要返回success數(shù)據(jù)向微信服務(wù)器告知已得到回調(diào)通知瀑焦。否則微信服務(wù)器會不停的向后端發(fā)送消息腌且。另外微信的通知是以XML格式發(fā)送的，在接受處理時需要注意榛瓮。
微信的大概支付流程就是這樣铺董。以下是PHP語法的微信支付類，可以比照上面的步驟介紹禀晓，加深理解精续。在需要支付時，直接傳入?yún)?shù)實例化此類再調(diào)用類的 pay 方法即可粹懒。
//微信支付類 class WeiXinPay{
//=======【基本信息設(shè)置】===================================== //微信公眾號身份的唯一標識 protected $APPID = appid;//填寫您的appid重付。微信公眾平臺里的 protected $APPSECRET = secret; //受理商ID，身份標識 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; //用戶唯一標識 $this->outTradeNo = $outTradeNo; //商品編號 $this->totalFee = $totalFee; //總價
}
//微信支付類向外暴露的支付接口 public function pay(){
$result = $this->weixinapp(); return $result;
}
//對微信統(tǒng)一下單接口返回的支付相關(guān)數(shù)據(jù)進行處理 private function weixinapp(){
$unifiedorder=$this->unifiedorder(); $parameters=array( 'appId'=>$this->APPID,//小程序ID 'timeStamp'=>''.time().'',//時間戳 'nonceStr'=>$this->createNoncestr(),//隨機串 'package'=>'prepay_id='.$unifiedorder['prepay_id'],//數(shù)據(jù)包 'signType'=>'MD5'//簽名方式 ); $parameters['paySign']=$this->getSign($parameters); return $parameters;
}
/* *請求微信統(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(),//隨機字符串 'out_trade_no'=>$this->outTradeNo,//商戶訂單編號 '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 = "<xml>"; foreach ($arr as $key=>$val)
{
if (is_numeric($val)){
$xml.="<".$key.">".$val."</".$key.">";
}else{
$xml.="<".$key."><![CDATA[".$val."]]></".$key.">";
}
}
$xml.="</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請求方法 private static function postXmlCurl($xml, $url, $second = 30) {
$ch = curl_init(); //設(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); //嚴格校驗 //設(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); //運行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出錯凫乖，錯誤碼:$error");
}
}
/* * 對要發(fā)送到微信統(tǒng)一下單接口的數(shù)據(jù)進行簽名 */ 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ù)方法确垫，簽名時需要使用 */ 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;
}
/* * 生成隨機字符串方法 */ 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;
}
}
以上就是微信支付的相關(guān)流程。在理清思路后帽芽，流程還是比較清晰和簡單的删掀。重點在于需要注意一些細節(jié)問題，例如數(shù)據(jù)格式导街，加密方法等披泪。
下面說一下微信小程序退款的具體實現(xiàn)
二.退款
小程序退款的流程和付款相似，但有一些細節(jié)上的不同搬瑰。
首先退款的步驟通常如下:
- 用戶前端點擊退款按鈕后款票，后端接收到用戶的退款請求通過商城后臺呈現(xiàn)給商戶，商戶確定允許退款后跌捆，后端再發(fā)起向微信退款接口的請求來請求退款徽职。
- 后端向微信退款接口發(fā)送請求后，得到響應(yīng)信息佩厚，確定退款是否完成，根據(jù)退款是否完成再去進行改變訂單狀態(tài)等業(yè)務(wù)邏輯说订。
退款的步驟相對微信支付來說比較簡單抄瓦。
值得注意的有以下兩點：
1.向微信退款接口請求退款后，根據(jù)得到的響應(yīng)是可以直接確定退款是否完成的陶冷。不再需要設(shè)置專門的回調(diào)接口等待微信通知钙姊。當然如果需要也是可以在微信商戶平臺設(shè)置回調(diào)接口接受從而接受微信回調(diào)的，但并不是必須的埂伦。
2.退款請求需要在請求服務(wù)器安裝微信提供的安全證書煞额，也就是說,發(fā)起退款請求相比較支付請求在請求時請求方法不能復(fù)用,因為微信退款需要攜帶證書的請求,此證書可在申請微信商戶號成功后從微信商戶平臺自行下載，Linux下的PHP開發(fā)環(huán)境的證書只需要放在網(wǎng)站根目錄的cert文件夾中即可。其他開發(fā)環(huán)境可能需要導(dǎo)入操作膊毁。
下面講解一下退款的具體步驟
一. 用戶發(fā)起退款請求
用戶在前端發(fā)起退款請求,后端接收到退款請求,將相應(yīng)訂單標記為申請退款,展示在后臺.商戶查看后,如果同意退款再進行相應(yīng)操作.此后才進入真正的退款流程.
二. 商戶發(fā)起退款請求
商戶同意退款后,后端即向微信提供的退款 API 發(fā)起請求.
同請求微信支付API一樣.退款請求也需要將需要的參數(shù)進行簽名后以XML發(fā)送到微信的退款A(yù)PI [https://api.mch.weixin.qq.com/pay/refund](https://api.mch.weixin.qq.com/pay/refund)
退款請求需要的參數(shù)如下(多個參數(shù)在支付API請求時也有使用):
- 小程序 appid胀莹。
- 商戶號 mch_id 。申請開通微信支付商戶認證成功后微信發(fā)給你的郵件里有
- 商戶訂單號 out_trade_no 婚温。退款訂單在支付時生成的訂單號
- 退款訂單號 out_refund_no 描焰。由后端生成的退款單號，需要保證唯一栅螟，因為多個同樣的退款單號只會退款一次荆秦。
- 總金額 total_fee 。訂單總金額力图，單位為分步绸。
- 退款金額 refund_fee 需要退款的金額,單位同樣為分
- 操作員 op_user_id .與商戶號相同即可
- 隨機字符串 nonce_str 。同支付請求
- 簽名 sign 吃媒。使用上面的所有參數(shù)進行相應(yīng)處理加密生成簽名瓤介。（具體處理方式與支付相同，可直接復(fù)用晓折。）
三. 退款完成
在發(fā)起退款請求后惑朦，就可以直接根據(jù)請求的響應(yīng)XML中的 result_code字段來判斷退款是否成功，從而對訂單狀態(tài)進行處理和后續(xù)操作漓概。不需要像支付那樣等待另一個接口的通知來確定請求狀態(tài)漾月。當然如上文所說，如果需要微信服務(wù)器發(fā)送通知到后端的話胃珍，可以到微信商戶平臺進行設(shè)置梁肿。
退款因為流程與支付大同小異，因此退款的PHP類我選擇了直接繼承支付類觅彰，
代碼如下吩蔑，注意區(qū)分退款請求方法postXmlSSLCurl和支付請求方法postXmlCurl的區(qū)別，這也就是上文提到的退款需要的雙向證書的使用填抬。
class WinXinRefund extends WeiXinPay{
protected \$SSLCERT_PATH = 'cert/apiclient_cert.pem';//證書路徑
protected \$SSLKEY_PATH = 'cert/apiclient_key.pem';//證書路徑
protected \$opUserId = '1234567899';//商戶號
function __construct($openid,$outTradeNo,$totalFee,$outRefundNo,$refundFee){
//初始化退款類需要的變量
$this->openid = $openid;
$this->outTradeNo = $outTradeNo;
$this->totalFee = $totalFee;
$this->outRefundNo = $outRefundNo;
$this->refundFee = $refundFee;
}
public function refund(){
//對外暴露的退款接口
$result = $this->wxrefundapi();
return $result;
}
private function wxrefundapi(){
//通過微信api進行退款流程
$parma = array(
'appid'=> $this->APPID,
'mch_id'=> $this->MCHID,
'nonce_str'=> $this->createNoncestr(),
'out_refund_no'=> $this->outRefundNo,
'out_trade_no'=> $this->outTradeNo,
'total_fee'=> $this->totalFee,
'refund_fee'=> $this->refundFee,
'op_user_id' => $this->opUserId,
);
$parma['sign'] = $this->getSign($parma);
$xmldata = $this->arrayToXml($parma);
$xmlresult = $this->postXmlSSLCurl($xmldata,'https://api.mch.weixin.qq.com/secapi/pay/refund');
$result = $this->xmlToArray($xmlresult);
return $result;
}
//需要使用證書的請求
function postXmlSSLCurl($xml,$url,$second=30)
{
$ch = curl_init();
//超時時間
curl_setopt($ch,CURLOPT_TIMEOUT,$second);
//這里設(shè)置代理烛芬，如果有的話
//curl_setopt($ch,CURLOPT_PROXY, '8.8.8.8');
//curl_setopt($ch,CURLOPT_PROXYPORT, 8080);
curl_setopt($ch,CURLOPT_URL, $url);
curl_setopt($ch,CURLOPT_SSL_VERIFYPEER,FALSE);
curl_setopt($ch,CURLOPT_SSL_VERIFYHOST,FALSE);
//設(shè)置header
curl_setopt($ch,CURLOPT_HEADER,FALSE);
//要求結(jié)果為字符串且輸出到屏幕上
curl_setopt($ch,CURLOPT_RETURNTRANSFER,TRUE);
//設(shè)置證書
//使用證書：cert 與 key 分別屬于兩個.pem文件
//默認格式為PEM，可以注釋
curl_setopt($ch,CURLOPT_SSLCERTTYPE,'PEM');
curl_setopt($ch,CURLOPT_SSLCERT, $this->SSLCERT_PATH);
//默認格式為PEM飒责，可以注釋
curl_setopt($ch,CURLOPT_SSLKEYTYPE,'PEM');
curl_setopt($ch,CURLOPT_SSLKEY, $this->SSLKEY_PATH);
//post提交方式
curl_setopt($ch,CURLOPT_POST, true);
curl_setopt($ch,CURLOPT_POSTFIELDS,$xml);
$data = curl_exec($ch);
//返回結(jié)果
if($data){
curl_close($ch);
return $data;
}
else {
$error = curl_errno($ch);
echo "curl出錯赘娄，錯誤碼:$error"."<br>";
curl_close($ch);
return false;
}
}}
三. 總結(jié)
以上就是關(guān)于微信支付和退款的流程及相關(guān)知識的介紹。文中的 PHP類 均封裝直接可用宏蛉。
因為微信支付和退款涉及的東西較為繁雜遣臼，很多人直接看官方文檔可能會一頭霧水，所以看過此文了解流程和要點后拾并，再去看微信官方文檔揍堰。一方面可以更清晰的了解小程序的支付和退款流程鹏浅。另一方面，本文因為篇幅有限及作者能力有限屏歹，肯定有無暇顧及或有所紕漏之處隐砸。為求穩(wěn)妥，還是需要多看看官方開發(fā)文檔西采。畢竟事涉支付凰萨，出個BUG可不是小事。
最后扯點閑話吧械馆。這篇博客本來應(yīng)該在三個月前就發(fā)表的胖眷，也算當時我從一無所知到獨立完成微信小程序商城前后端的總結(jié)系列的第一篇。但是公司突然出現(xiàn)人員和項目的變動霹崎，導(dǎo)致管理和項目上都混亂不堪珊搀，再加上個人的惰性，導(dǎo)致此篇博客一直拖到三個月后的今天才斷斷續(xù)續(xù)寫完尾菇。這三個月我的心態(tài)因為各種事起起伏伏境析，也頗有一番風(fēng)味。
借用李志的一句歌詞結(jié)束這篇博客吧派诬。下一篇是什么時候也說不定了劳淆，我苦笑。
本文作者：未曾見海
原文地址：微信小程序支付及退款流程詳解【下】-實戰(zhàn)教程-小程序社區(qū)-微信小程序-微信小程序開發(fā)社區(qū)-小程序開發(fā)論壇-微信小程序聯(lián)盟
