springboot對接支付寶支付介面(詳細開發步驟總結)
最近需要對接支付寶的支付介面,官方文件寫得內容有點分散,整理了一下發布出來,用作記錄,同時也希望對不瞭解情況的人有所幫助,這裡以電腦端的網頁支付為例。
開發主要分為三個步驟:一、生成私鑰公鑰。二、建立應用。三、沙箱環境。四、介面開發
一、生成私鑰公鑰
生成金鑰的官網文件:官網文件
官方文件講得已經很詳細,按照步驟來即可,記得儲存好公鑰與私鑰,下面需要用到
二、建立應用
1.首先進入螞蟻金服開放平臺的首頁,通過支付寶賬戶登入,登入的時候要選擇一個身份,這個選自研開發者吧,反正後面可以拓展
2.在螞蟻金服的首頁的頭像旁邊進入管理中心,然後點選“開發中心”:
然後選擇網頁和移動應用快速接入支付/行業,注意旁邊的“研發服務”,接下來我們會用到:
進入之後選擇“支付接入”建立一個用於接入支付的應用:
然後輸入相關的資訊後點擊確認建立:
建立成功之後可以看到如下頁面:
可以在功能列表選擇自己需要的功能。
開發設定中可以填入自己需要的資訊,其中加密方式建議選擇RSA(SHA256)金鑰,公鑰填寫之前生成的公鑰。
注:輸入公鑰時驗證會失敗,但是對我們的開發沒有影響,暫時可以不管
填寫完之後,提交稽核,稽核按鈕在頁面上方= =,稽核過程大概一個小時左右吧。實際生產環境的應用需要等待這個稽核,但是我們開發可以運用沙箱環境來進行。
三、沙箱環境
什麼是沙箱環境?
沙箱環境實際上跟真實的生產環境差不多,開發的時候我們用沙箱進行,測試bug,到了生產環境中,我們只要替換APPID和支付寶閘道器就可以了,非常方便。
在網頁上端,點選開發平臺,進入沙箱:
在這裡需要注意兩個地方:
- 沙箱環境下的支付寶閘道器
- 配置好自己的公鑰
沙箱賬號
這個賬號用來模擬真實的支付寶賬戶,畢竟我們開發進行支付時不會使用自己的真實支付寶進行支付。
後面還有什麼沙箱賬號以及沙箱工具什麼的,就自己看了。
準備得差不多了,接下來說說怎麼開發介面
四、介面開發
我用的開發語言是JAVA,工具為IDEA,一個簡單的springboot工程
1.構建一個普通的springboot工程,引入支付寶SDK的maven依賴:
<dependency> <groupId>com.alipay.sdk</groupId> <artifactId>alipay-sdk-java</artifactId> <version>3.0.0</version> </dependency>
新建一個AlipayConfig類,用於配置支付的相關配置:
public class AlipayConfig { // 應用ID,您的APPID,收款賬號既是您的APPID對應支付寶賬號,開發時使用沙箱提供的APPID,生產環境改成自己的APPID public static String APP_ID = "你的沙箱APPID"; // 商戶私鑰,您的PKCS8格式RSA2私鑰 public static String APP_PRIVATE_KEY = "你自己的私鑰"; // 支付寶公鑰,檢視地址:https://openhome.alipay.com/platform/keyManage.htm 對應APPID下的支付寶公鑰。 public static String ALIPAY_PUBLIC_KEY = "你自己的支付寶公鑰,注意是支付寶公鑰,不是應用公鑰"; // 伺服器非同步通知頁面路徑 需http://格式的完整路徑,不能加?id=123這類自定義引數,必須外網可以正常訪問 public static String notify_url = "http://localhost:8080/alipay.trade.page.pay-JAVA-UTF-8/notify_url.jsp"; // 頁面跳轉同步通知頁面路徑 需http://格式的完整路徑,不能加?id=123這類自定義引數,必須外網可以正常訪問(其實就是支付成功後返回的頁面) public static String return_url = "http://localhost:8080/alipay.trade.page.pay-JAVA-UTF-8/return_url.jsp"; // 簽名方式 public static String sign_type = "RSA2"; // 字元編碼格式 public static String CHARSET = "utf-8"; // 支付寶閘道器,這是沙箱的閘道器 public static String gatewayUrl = "https://openapi.alipaydev.com/gateway.do"; // 支付寶閘道器 public static String log_path = "C:\\"; //↑↑↑↑↑↑↑↑↑↑請在這裡配置您的基本資訊↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑ /** * 寫日誌,方便測試(看網站需求,也可以改成把記錄存入資料庫) * @param sWord 要寫入日誌裡的文字內容 */ public static void logResult(String sWord) { FileWriter writer = null; try { writer = new FileWriter(log_path + "alipay_log_" + System.currentTimeMillis()+".txt"); writer.write(sWord); } catch (Exception e) { e.printStackTrace(); } finally { if (writer != null) { try { writer.close(); } catch (IOException e) { e.printStackTrace(); } } } }
3.新建一個controller包,用於存放Action,新建一個PayController類,編寫一個用於支付的介面/pay
@RestController public class PayController { @RequestMapping("/pay") public void payController(HttpServletRequest request,HttpServletResponse response) throws IOException { //獲得初始化的AlipayClient AlipayClient alipayClient = new DefaultAlipayClient(AlipayConfig.gatewayUrl,AlipayConfig.APP_ID,AlipayConfig.APP_PRIVATE_KEY,"json",AlipayConfig.CHARSET,AlipayConfig.ALIPAY_PUBLIC_KEY,AlipayConfig.sign_type); //設定請求引數 AlipayTradePagePayRequest alipayRequest = new AlipayTradePagePayRequest(); alipayRequest.setReturnUrl(AlipayConfig.return_url); alipayRequest.setNotifyUrl(AlipayConfig.notify_url); //商戶訂單號,商戶網站訂單系統中唯一訂單號,必填 String out_trade_no = new String(request.getParameter("WIDout_trade_no").getBytes("ISO-8859-1"),"UTF-8"); //付款金額,必填 String total_amount = new String(request.getParameter("WIDtotal_amount").getBytes("ISO-8859-1"),"UTF-8"); //訂單名稱,必填 String subject = new String(request.getParameter("WIDsubject").getBytes("ISO-8859-1"),"UTF-8"); //商品描述,可空 String body = new String(request.getParameter("WIDbody").getBytes("ISO-8859-1"),"UTF-8"); alipayRequest.setBizContent("{\"out_trade_no\":\""+ out_trade_no +"\"," + "\"total_amount\":\""+ total_amount +"\"," + "\"subject\":\""+ subject +"\"," + "\"body\":\""+ body +"\"," + "\"product_code\":\"FAST_INSTANT_TRADE_PAY\"}"); //若想給BizContent增加其他可選請求引數,以增加自定義超時時間引數timeout_express來舉例說明 //alipayRequest.setBizContent("{\"out_trade_no\":\""+ out_trade_no +"\"," // + "\"total_amount\":\""+ total_amount +"\"," // + "\"subject\":\""+ subject +"\"," // + "\"body\":\""+ body +"\"," // + "\"timeout_express\":\"10m\"," // + "\"product_code\":\"FAST_INSTANT_TRADE_PAY\"}"); //請求引數可查閱【電腦網站支付的API文件-alipay.trade.page.pay-請求引數】章節 //請求 String form=""; try { form = alipayClient.pageExecute(alipayRequest).getBody(); //呼叫SDK生成表單 } catch (AlipayApiException e) { e.printStackTrace(); } response.setContentType("text/html;charset=" + AlipayConfig.CHARSET); response.getWriter().write(form);//直接將完整的表單html輸出到頁面 response.getWriter().flush(); response.getWriter().close(); }
新建一個JSP頁面,用於模擬提交訂單
首先要新增JSP的相關依賴:
<!-- tomcat 依賴包 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-tomcat</artifactId> </dependency> <dependency> <groupId>org.apache.tomcat.embed</groupId> <artifactId>tomcat-embed-jasper</artifactId> </dependency> <!-- servlet 依賴包 --> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> </dependency>
配置檔案新增springMvc的對映路徑
spring.mvc.view.prefix=/WEB-INF/jsp/ spring.mvc.view.suffix=.jsp
新建一個頁面:
頁面所在的目錄
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <form action="/pay" method="post"> 訂單號:<input type="text" name="WIDout_trade_no" required><br/> 訂單名稱:<input type="text" name="WIDsubject" required><br/> 付款金額:<input type="text" name="WIDtotal_amount" required><br/> WIDbody:<input type="text" name="WIDbody"><br/> <input type="submit" value="下單"> <input type="reset" value="重置"> </form>
required保證提交的時候這兩項內容非空
5. controller類新增跳轉到jsp頁面的對映:
@RequestMapping("/") public String toTest(){ return "index"; }
6.測試執行,啟動專案,在瀏覽器輸入:http://localhost:8080/
輸入訂單號,訂單名稱,金額,就可以跳轉到支付寶的支付頁面了:
由於這個是沙箱環境,所以這個二維碼無法識別,我們選擇右邊的登入支付寶賬戶付款
在這裡我們輸入的是之前沙箱賬號和支付密碼,輸入之後就可以進入到支付頁面,與實際中的操作是一樣的:
這裡跳轉回去的頁面就是之前AlipayConfig類中的return_url 在這之前需要進入notify_url 介面進行驗籤,這兩個介面就不演示了,先知道這回事,實際開發的時候再進行開發。
到此這篇關於springboot對接支付寶支付介面(詳細開發步驟總結)的文章就介紹到這了,更多相關springboot 支付寶支付介面內容請搜尋我們以前的文章或繼續瀏覽下面的相關文章希望大家以後多多支援我們!