App支付產品介紹 更新時間:2018-05-08
場景介紹
適用於商家在App應用中集成支付寶支付功能。
商家APP調用支付寶提供的SDK,SDK再調用支付寶APP內的支付模塊。若是用戶已安裝支付寶APP,商家APP會跳轉到支付寶中完成支付,支付完後跳回到商家APP內,最後展現支付結果。若是用戶沒有安裝支付寶APP,商家APP內會調起支付寶網頁支付收銀臺,用戶登陸支付寶帳戶,支付完後展現支付結果。
目前支持手機系統有:iOS(蘋果)、Android(安卓)。javascript
一、支付寶的文檔比較容易看,主要是有相應的DEMO,我這裏看的DEMO是 JAVA-UTF-8版本。html
二、導入DEMO,在com.alipay.config中填入對應的partner和key(在對應的商戶後臺獲取)就能夠直接運行了解支付流程了。
java
4、實現:
一、商品發起購買請求(將DEMO中的頁面直接拿過來用了)。ajax
- <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;">
- 請掃碼關注
- </div>
- <div class="shmsg" style="margin-bottom:5px;">
- 接收重要信息
- </div>
- </div>
- </div>
- </div>
- </div>
- </div>
- <div class="container">
- <div class="nav">
- <a href="https://www.alipay.com/" class="logo"><img src="img/alipay_logo.png" height="30px"></a>
- <span class="divier"></span>
- <a href="http://open.alipay.com/platform/home.htm" class="open" target="_blank">開放平臺</a>
- <ul class="navbar">
- <li><a href="https://doc.open.alipay.com/doc2/detail?treeId=62&articleId=103566&docType=1" target="_blank">在線文檔</a></li>
- <li><a href="https://cschannel.alipay.com/portal.htm?sourceId=213" target="_blank">技術支持</a></li>
- </ul>
- </div>
- </div>
- <div class="container blue">
- <div class="title">支付寶即時到帳(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">支付寶即時到帳交易接口快速通道 </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).必填(建議是英文字母和數字,不能含有特殊字符)</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">注意:產品名稱(subject),必填(建議中文,英文,數字,不能含有特殊字符)</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="即時到帳測試"></div>
- <br>
- <div class="mark">注意:商品描述(body),選填(建議中文,英文,數字,不能含有特殊字符)</div>
- </div>
- <div class="element">
- <input type="button" class="alisubmit" id="sbumitBtn" value ="確認支付">
- </div>
- </div>
- <div id="returnAli"></div>
- <div class="footer">
- <p class="footer-sub">
- <a href="http://ab.alipay.com/i/index.htm" target="_blank">關於支付寶</a><span>|</span>
- <a href="https://e.alipay.com/index.htm" target="_blank">商家中心</a><span>|</span>
- <a href="https://job.alibaba.com/zhaopin/index.htm" target="_blank">誠徵英才</a><span>|</span>
- <a href="http://ab.alipay.com/i/lianxi.htm" target="_blank">聯繫咱們</a><span>|</span>
- <a href="#" id="international" target="_blank">International Business</a><span>|</span>
- <a href="http://ab.alipay.com/i/jieshao.htm#en" target="_blank">About Alipay</a>
- <br>
- <span>支付寶版權全部</span>
- <span class="footer-date">2004-2016</span>
- <span><a href="http://fun.alipay.com/certificate/jyxkz.htm" target="_blank">ICP證:滬B2-20150087</a></span>
- </p>
-
-
- </div>
- </body>
- 二、點擊確認支付以後,這裏經過ajax請求後臺,將返回的一段html代碼直接放到上面的<div id="returnALi"></div>中,這個表單會自動提交。
- $(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){
- }
- });
- })
-
- });
三、後臺controller中,基本是將demo中的alipayapi.jsp直接拿來用了,不一樣的是,參數的傳遞是本身定義的,返回方式符合apringmvc要求,而且根據業務需求保存了狀態爲未支付的訂單信息。
- @RequestMapping("open")
- public ResponseEntity<HttpEntity> open(Model model, String WIDout_trade_no, String WIDsubject, String WIDtotal_fee,
- String WIDbody) {
-
-
-
-
- String out_trade_no = WIDout_trade_no;
-
- String subject = WIDsubject;
-
- String total_fee = WIDtotal_fee;
-
- String body = WIDbody;
-
-
- 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);
-
-
-
-
- String sHtmlText = AlipaySubmit.buildRequest(sParaTemp, "get", "確認");
- model.addAttribute("sHtmlText", sHtmlText);
-
-
- hysWebMeetingAliService.insertSelective(sParaTemp);
- return new ResponseEntity(model, HttpStatus.OK);
- }
- 四、回調:也是直接將DEMO中的notify_url.jsp中的java代碼拿來稍微作了修改和加上業務代碼(修改狀態等);
- @RequestMapping("notify")
- @ResponseBody
- public String notify(HttpServletRequest request){
-
- 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] + ",";
- }
-
-
- params.put(name, valueStr);
- }
-
-
-
-
- String out_trade_no = request.getParameter("out_trade_no");
-
-
-
- String trade_no = request.getParameter("trade_no");
-
-
- String trade_status = request.getParameter("trade_status");
-
-
-
- if(AlipayNotify.verify(params)){
-
-
-
-
- boolean flg = false;
- if(trade_status.equals("TRADE_FINISHED")){
-
-
-
-
-
-
-
- } else if (trade_status.equals("TRADE_SUCCESS")){
-
-
-
-
-
-
-
-
-
- flg = hysWebMeetingAliService.changeOrderAndAliStatusSuccess(out_trade_no);
-
- }
-
-
-
-
- if(flg){
- return "success";
- }else{
- return "fail";
- }
-
-
- }else{
-
- return "fail";
- }
- }
五、return_url:頁面跳轉同步通知頁面路徑,就是支付成功後,支付寶回跳的一個頁面。「需http://格式的完整路徑,不能加?id=123這類自定義參數,必須外網能夠正常訪問」,支付寶明確規定了回跳的頁面後面不能自定義參數,那麼有的咱們就是根據一些類型去判斷跳轉的就有點麻煩了。我這裏作了一個取巧的作法:先把return_url.jsp中的java代碼也直接搬過來,略作修改(換成springmvc的方式),個人回跳地址就是IP/aliPay/returnUrl,而後再new ModelAndView("redirect:/meeting/info")進行重定向到咱們想到的url中,(參數問題看下文總結第4點吧)。spring
- @RequestMapping("returnUrl")
- public ModelAndView returnUrl(HttpServletRequest request){
- ModelAndView mv = new ModelAndView("redirect:/meeting/info");
-
-
- 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] + ",";
- }
-
-
- params.put(name, valueStr);
- }
-
-
-
-
- String out_trade_no = request.getParameter("out_trade_no");
-
-
-
- String trade_no = request.getParameter("trade_no");
-
-
- String trade_status = request.getParameter("trade_status");
-
- <span style="color:#ff0000;">String meetingId = request.getParameter("extra_common_param");
- mv.addObject("meetingId", meetingId);</span>
-
-
-
-
- boolean verify_result = AlipayNotify.verify(params);
-
- if(verify_result){
-
-
-
-
- if(trade_status.equals("TRADE_FINISHED") || trade_status.equals("TRADE_SUCCESS")){
-
-
-
- }
-
-
-
-
-
- }else{
-
- }
-
- return mv;
- }
-
5、總結:
一、支付寶集成比較簡答,稍微看下DEMO,跑一下了解了流程就比較容易了。api
二、調試的時候,特別是回調,要把項目部署到可以外網訪問的服務器上。數組
三、我沒有遇到上面莫名其妙的問題,若是遇到了的話,能夠聯繫我,或者看下Eclipse遠程debug這篇文章,進行問題的跟蹤。服務器
四、作頁面跳轉同步通知頁面路徑時,須要傳遞參數怎麼辦,我一開始是自定義了一個參數,但是沒有取到,而後我看到DEMO中有一句註釋是這麼寫的:mvc
因此我打開看了以後,選擇了公用回傳參數extra_common_param,我本身知道這個字段對於我來講是什麼含義。不過也要注意,人家說明了:
- 參數body(商品描述)、subject(商品名稱)、extra_common_param(公用回傳參數)不能包含特殊字符(如:#、%、&、+)、敏感詞彙,也不能使用外國文字(旺旺不支持的外文,如:韓文、泰語、藏文、蒙古文、阿拉伯語);
open方法中設值:
- sParaTemp.put("extra_common_param", meetingId);
returnUrl方法中取值,並做爲重定向參數:
- String meetingId = request.getParameter("extra_common_param");
- mv.addObject("meetingId", meetingId);