二、API:使用支付寶開放平臺的支付能力-即時(shí)到賬接口。支付寶開放平臺鏈接
三、分析:
1、支付寶的文檔比較容易看,主要是有相應(yīng)的DEMO,我這里看的DEMO是 JAVA-UTF-8版本。
2、導(dǎo)入DEMO,在com.alipay.config中填入對應(yīng)的partner和key(在對應(yīng)的商戶后臺獲取)就可以直接運(yùn)行了解支付流程了。
3、改寫:我這邊使用的是springmvc+mybatis。商品發(fā)起購買(走支付寶支付)、跳轉(zhuǎn)到支付寶、支付寶回調(diào)支付狀態(tài)。
四、實(shí)現(xiàn):
1、商品發(fā)起購買請求(將DEMO中的頁面直接拿過來用了)。
[javascript] view plain copy
<body>
<div class="header">
<div class="container black">
<div class="qrcode">
<div class="littlecode">
<img width="16px" src="img/little_qrcode.jpg" id="licode">
<div class="showqrs" id="showqrs">
<div class="shtoparrow"></div>
<div class="guanzhuqr">
<img src="img/guanzhu_qrcode.png" width="80">
<div class="shmsg" style="margin-top:5px;">
請掃碼關(guān)注
</div>
<div class="shmsg" style="margin-bottom:5px;">
接收重要信息
</div>
</div>
</div>
</div>
</div>
</div>
<div class="container">
<div class="nav">
<a class="logo"><img src="img/alipay_logo.png" height="30px"></a>
<span class="divier"></span>
<a class="open" target="_blank">開放平臺</a>
<ul class="navbar">
<li><a target="_blank">在線文檔</a></li>
<li><a target="_blank">技術(shù)支持</a></li>
</ul>
</div>
</div>
<div class="container blue">
<div class="title">支付寶即時(shí)到賬(create_direct_pay_by_user)</div>
</div>
</div>
<div class="content">
<%-- <form action="${ctx}/aliPay/open" class="alipayform" method="POST" target="_blank"> --%>
<div class="element" style="margin-top:60px;">
<div class="legend">支付寶即時(shí)到賬交易接口快速通道 </div>
</div>
<div class="element">
<div class="etitle">商戶訂單號:</div>
<div class="einput"><input type="text" name="WIDout_trade_no" id="out_trade_no"></div>
<br>
<div class="mark">注意:商戶訂單號(out_trade_no).必填(建議是英文字母和數(shù)字,不能含有特殊字符)</div>
</div>
<div class="element">
<div class="etitle">商品名稱:</div>
<div class="einput"><input type="text" name="WIDsubject" id="WIDsubject" value="test商品123"></div>
<br>
<div class="mark">注意:產(chǎn)品名稱(subject),必填(建議中文,英文,數(shù)字,不能含有特殊字符)</div>
</div>
<div class="element">
<div class="etitle">付款金額:</div>
<div class="einput"><input type="text" name="WIDtotal_fee" id="WIDtotal_fee" value="0.01"></div>
<br>
<div class="mark">注意:付款金額(total_fee),必填(格式如:1.00,請精確到分)</div>
</div>
<div class="element">
<div class="etitle">商品描述:</div>
<div class="einput"><input type="text" name="WIDbody" id="WIDbody" value="即時(shí)到賬測試"></div>
<br>
<div class="mark">注意:商品描述(body),選填(建議中文,英文,數(shù)字,不能含有特殊字符)</div>
</div>
<div class="element">
<input type="button" class="alisubmit" id="sbumitBtn" value ="確認(rèn)支付">
</div>
</div>
<div id="returnAli"></div>
<div class="footer">
<p class="footer-sub">
<a target="_blank">關(guān)于支付寶</a><span>|</span>
<a target="_blank">商家中心</a><span>|</span>
<a target="_blank">誠征英才</a><span>|</span>
<a target="_blank">聯(lián)系我們</a><span>|</span>
<a href="#" id="international" target="_blank">International Business</a><span>|</span>
<a target="_blank">About Alipay</a>
<br>
<span>支付寶版權(quán)所有</span>
<span class="footer-date">2004-2016</span>
<span><a target="_blank">ICP證:滬B2-20150087</a></span>
</p>
</div>
</body>
2、點(diǎn)擊確認(rèn)支付之后,這里通過ajax請求后臺,將返回的一段html代碼直接放到上面的<div id="returnALi"></div>中,這個(gè)表單會自動提交。
[javascript] view plain copy
$(function (){
$("#sbumitBtn").on('click', function(){
$.ajax({
type : "post",
data : {
WIDout_trade_no : $('#out_trade_no').val(),
WIDsubject : $('#WIDsubject').val(),
WIDtotal_fee : $('#WIDtotal_fee').val(),
WIDbody : $('#WIDbody').val()
},
url : "${ctx}/aliPay/open",
success : function(data) {
$('#returnAli').append(data.sHtmlText);
},
error : function(da){
}
});
})
});
3、后臺controller中,基本是將demo中的alipayapi.jsp直接拿來用了,不同的是,參數(shù)的傳遞是自己定義的,返回方式符合apringmvc要求,并且根據(jù)業(yè)務(wù)需求保存了狀態(tài)為未支付的訂單信息。
[javascript] view plain copy
@RequestMapping("open")
public ResponseEntity<HttpEntity> open(Model model, String WIDout_trade_no, String WIDsubject, String WIDtotal_fee,
String WIDbody) {
//////////////////////////////////// 請求參數(shù)//////////////////////////////////////
// 商戶訂單號,商戶網(wǎng)站訂單系統(tǒng)中訂單號,必填
String out_trade_no = WIDout_trade_no;
// 訂單名稱,必填
String subject = WIDsubject;
// 付款金額,必填
String total_fee = WIDtotal_fee;
// 商品描述,可空
String body = WIDbody;
// 把請求參數(shù)打包成數(shù)組
Map<String, String> sParaTemp = new HashMap<String, String>();
sParaTemp.put("service", AlipayConfig.service);
sParaTemp.put("partner", AlipayConfig.partner);
sParaTemp.put("seller_id", AlipayConfig.seller_id);
sParaTemp.put("_input_charset", AlipayConfig.input_charset);
sParaTemp.put("payment_type", AlipayConfig.payment_type);
sParaTemp.put("notify_url", AlipayConfig.notify_url);
sParaTemp.put("return_url", AlipayConfig.return_url);
sParaTemp.put("anti_phishing_key", AlipayConfig.anti_phishing_key);
sParaTemp.put("exter_invoke_ip", AlipayConfig.exter_invoke_ip);
sParaTemp.put("out_trade_no", out_trade_no);
sParaTemp.put("subject", subject);
sParaTemp.put("total_fee", total_fee);
sParaTemp.put("body", body);
// 其他業(yè)務(wù)參數(shù)根據(jù)在線開發(fā)文檔,添加參數(shù).文檔地址:https://doc.open.alipay.com/doc2/detail.htm?spm=a219a.7629140.0.0.O9yorI&treeId=62&articleId=103740&docType=1
// 如sParaTemp.put("參數(shù)名","參數(shù)值");
// 建立請求
String sHtmlText = AlipaySubmit.buildRequest(sParaTemp, "get", "確認(rèn)");
model.addAttribute("sHtmlText", sHtmlText);
// 保存支付記錄
hysWebMeetingAliService.insertSelective(sParaTemp);
return new ResponseEntity(model, HttpStatus.OK);
}
4、回調(diào):也是直接將DEMO中的notify_url.jsp中的java代碼拿來稍微做了修改和加上業(yè)務(wù)代碼(修改狀態(tài)等);
[javascript] view plain copy
@RequestMapping("notify")
@ResponseBody
public String notify(HttpServletRequest request){
//獲取支付寶POST過來反饋信息
Map<String,String> params = new HashMap<String,String>();
Map requestParams = request.getParameterMap();
for (Iterator iter = requestParams.keySet().iterator(); iter.hasNext();) {
String name = (String) iter.next();
String[] values = (String[]) requestParams.get(name);
String valueStr = "";
for (int i = 0; i < values.length; i++) {
valueStr = (i == values.length - 1) ? valueStr + values[i]
: valueStr + values[i] + ",";
}
//亂碼解決,這段代碼在出現(xiàn)亂碼時(shí)使用。如果mysign和sign不相等也可以使用這段代碼轉(zhuǎn)化
//valueStr = new String(valueStr.getBytes("ISO-8859-1"), "gbk");
params.put(name, valueStr);
}
//獲取支付寶的通知返回參數(shù),可參考技術(shù)文檔中頁面跳轉(zhuǎn)同步通知參數(shù)列表(以下僅供參考)//
//商戶訂單號
String out_trade_no = request.getParameter("out_trade_no");
//支付寶交易號
String trade_no = request.getParameter("trade_no");
//交易狀態(tài)
String trade_status = request.getParameter("trade_status");
//獲取支付寶的通知返回參數(shù),可參考技術(shù)文檔中頁面跳轉(zhuǎn)同步通知參數(shù)列表(以上僅供參考)//
if(AlipayNotify.verify(params)){//驗(yàn)證成功
//////////////////////////////////////////////////////////////////////////////////////////
//請?jiān)谶@里加上商戶的業(yè)務(wù)邏輯程序代碼
//——請根據(jù)您的業(yè)務(wù)邏輯來編寫程序(以下代碼僅作參考)——
boolean flg = false;
if(trade_status.equals("TRADE_FINISHED")){
//判斷該筆訂單是否在商戶網(wǎng)站中已經(jīng)做過處理
//如果沒有做過處理,根據(jù)訂單號(out_trade_no)在商戶網(wǎng)站的訂單系統(tǒng)中查到該筆訂單的詳細(xì),并執(zhí)行商戶的業(yè)務(wù)程序
//請務(wù)必判斷請求時(shí)的total_fee、seller_id與通知時(shí)獲取的total_fee、seller_id為一致的
//如果有做過處理,不執(zhí)行商戶的業(yè)務(wù)程序
//注意:
//退款日期超過可退款期限后(如三個(gè)月可退款),支付寶系統(tǒng)發(fā)送該交易狀態(tài)通知
} else if (trade_status.equals("TRADE_SUCCESS")){
//判斷該筆訂單是否在商戶網(wǎng)站中已經(jīng)做過處理
//如果沒有做過處理,根據(jù)訂單號(out_trade_no)在商戶網(wǎng)站的訂單系統(tǒng)中查到該筆訂單的詳細(xì),并執(zhí)行商戶的業(yè)務(wù)程序
//請務(wù)必判斷請求時(shí)的total_fee、seller_id與通知時(shí)獲取的total_fee、seller_id為一致的
//如果有做過處理,不執(zhí)行商戶的業(yè)務(wù)程序
//注意:
//付款完成后,支付寶系統(tǒng)發(fā)送該交易狀態(tài)通知
//根據(jù)訂單號將訂單狀態(tài)和支付寶記錄表中狀態(tài)都改為已支付
flg = hysWebMeetingAliService.changeOrderAndAliStatusSuccess(out_trade_no);
}
//——請根據(jù)您的業(yè)務(wù)邏輯來編寫程序(以上代碼僅作參考)——
//out.print("success"); //請不要修改或刪除
if(flg){
return "success";
}else{
return "fail";
}
//////////////////////////////////////////////////////////////////////////////////////////
}else{//驗(yàn)證失敗
//out.print("fail");
return "fail";
}
}
5、return_url:頁面跳轉(zhuǎn)同步通知頁面路徑,就是支付成功后,支付寶回跳的一個(gè)頁面。“需http://格式的完整路徑,不能加?id=123這類自定義參數(shù),必須外網(wǎng)可以正常訪問”,支付寶明確規(guī)定了回跳的頁面后面不能自定義參數(shù),那么有的我們就是根據(jù)一些類型去判斷跳轉(zhuǎn)的就有點(diǎn)麻煩了。我這里做了一個(gè)取巧的做法:先把return_url.jsp中的java代碼也直接搬過來,略做修改(換成springmvc的方式),我的回跳地址就是IP/aliPay/returnUrl,然后再new ModelAndView("redirect:/meeting/info")進(jìn)行重定向到我們想到的url中,(參數(shù)問題看下文總結(jié)第4點(diǎn)吧)。
[javascript] view plain copy
@RequestMapping("returnUrl")
public ModelAndView returnUrl(HttpServletRequest request){
ModelAndView mv = new ModelAndView("redirect:/meeting/info");
//獲取支付寶GET過來反饋信息
Map<String,String> params = new HashMap<String,String>();
Map requestParams = request.getParameterMap();
for (Iterator iter = requestParams.keySet().iterator(); iter.hasNext();) {
String name = (String) iter.next();
String[] values = (String[]) requestParams.get(name);
String valueStr = "";
for (int i = 0; i < values.length; i++) {
valueStr = (i == values.length - 1) ? valueStr + values[i]
: valueStr + values[i] + ",";
}
//亂碼解決,這段代碼在出現(xiàn)亂碼時(shí)使用。如果mysign和sign不相等也可以使用這段代碼轉(zhuǎn)化
//valueStr = new String(valueStr.getBytes("ISO-8859-1"), "utf-8");
params.put(name, valueStr);
}
//獲取支付寶的通知返回參數(shù),可參考技術(shù)文檔中頁面跳轉(zhuǎn)同步通知參數(shù)列表(以下僅供參考)//
//商戶訂單號
String out_trade_no = request.getParameter("out_trade_no");
//支付寶交易號
String trade_no = request.getParameter("trade_no");
//交易狀態(tài)
String trade_status = request.getParameter("trade_status");
<span style="color:#ff0000;">String meetingId = request.getParameter("extra_common_param");
mv.addObject("meetingId", meetingId);</span>
//獲取支付寶的通知返回參數(shù),可參考技術(shù)文檔中頁面跳轉(zhuǎn)同步通知參數(shù)列表(以上僅供參考)//
//計(jì)算得出通知驗(yàn)證結(jié)果
boolean verify_result = AlipayNotify.verify(params);
if(verify_result){//驗(yàn)證成功
//////////////////////////////////////////////////////////////////////////////////////////
//請?jiān)谶@里加上商戶的業(yè)務(wù)邏輯程序代碼
//——請根據(jù)您的業(yè)務(wù)邏輯來編寫程序(以下代碼僅作參考)——
if(trade_status.equals("TRADE_FINISHED") || trade_status.equals("TRADE_SUCCESS")){
//判斷該筆訂單是否在商戶網(wǎng)站中已經(jīng)做過處理
//如果沒有做過處理,根據(jù)訂單號(out_trade_no)在商戶網(wǎng)站的訂單系統(tǒng)中查到該筆訂單的詳細(xì),并執(zhí)行商戶的業(yè)務(wù)程序
//如果有做過處理,不執(zhí)行商戶的業(yè)務(wù)程序
}
//該頁面可做頁面美工編輯
// out.println("驗(yàn)證成功<br />");
//——請根據(jù)您的業(yè)務(wù)邏輯來編寫程序(以上代碼僅作參考)——
//////////////////////////////////////////////////////////////////////////////////////////
}else{
//該頁面可做頁面美工編輯
// out.println("驗(yàn)證失敗");
}
return mv;
}
五、總結(jié):
1、支付寶集成比較簡答,稍微看下DEMO,跑一下了解了流程就比較容易了。
2、調(diào)試的時(shí)候,特別是回調(diào),要把項(xiàng)目部署到能夠外網(wǎng)訪問的服務(wù)器上。
3、我沒有遇到上面莫名其妙的問題,如果遇到了的話,可以聯(lián)系我,或者看下Eclipse遠(yuǎn)程debug這篇文章,進(jìn)行問題的跟蹤。
4、做頁面跳轉(zhuǎn)同步通知頁面路徑時(shí),需要傳遞參數(shù)怎么辦,我一開始是自定義了一個(gè)參數(shù),可是沒有取到,然后我看到DEMO中有一句注釋是這么寫的:
[javascript] view plain copy
// 其他業(yè)務(wù)參數(shù)根據(jù)在線開發(fā)文檔,添加參數(shù).文檔地址:https://doc.open.alipay.com/doc2/detail.htm?spm=a219a.7629140.0.0.O9yorI&treeId=62&articleId=103740&docType=1
所以我打開看了之后,選擇了公用回傳參數(shù)extra_common_param,我自己知道這個(gè)字段對于我來說是什么含義。不過也要注意,人家說明了:
[javascript] view plain copy
參數(shù)body(商品描述)、subject(商品名稱)、extra_common_param(公用回傳參數(shù))不能包含特殊字符(如:#、%、&、+)、敏感詞匯,也不能使用外國文字(旺旺不支持的外文,如:韓文、泰語、藏文、蒙古文、阿拉伯語);
open方法中設(shè)值:
[javascript] view plain copy
sParaTemp.put("extra_common_param", meetingId);
returnUrl方法中取值,并作為重定向參數(shù):
[javascript] view plain copy
String meetingId = request.getParameter("extra_common_param");
mv.addObject("meetingId", meetingId);
粵嵌科技13年專注IT人才培訓(xùn)學(xué)習(xí)的專業(yè)機(jī)構(gòu),主要培訓(xùn)課程為,嵌入式開發(fā)、Java大數(shù)據(jù)、Unity游戲開發(fā)、Python人工智能、HTML5前端開發(fā)、全棧UI設(shè)計(jì)、網(wǎng)絡(luò)營銷、CCIE網(wǎng)絡(luò)等專業(yè)課程