支付寶支付-經常使用支付API詳解(查詢、退款、提現等)

時間  2019-11-24
標籤 支付寶 支付 經常 使用 api 詳解 查詢 退款 提現 简体版
原文   原文鏈接

全部的接口支持沙盒環境的測試git

一、前言

此項目已開源歡迎Start、PR、發起Issues一塊兒討論交流共同進步github

https://github.com/Javen205/IJPay
http://git.oschina.net/javen205/IJPay算法

前面幾篇文件詳細介紹了 支付寶提現、掃碼支付、條碼支付、Wap支付、App支付json

其中也斷斷續續的提到了一些接口。本片文章主要是總結支付寶支付中經常使用的一些接口

二、經常使用的接口總結

這裏使用表格的方式列出 官方接口列表以及詳細的參數說明

API列表 類型 描述 使用場景
alipay.trade.query 免費 統一收單線下交易查詢 提供全部支付寶支付訂單的查詢
alipay.trade.refund 免費 統一收單交易退款接口 買家或者賣家的緣由須要退款時
alipay.trade.fastpay.refund.query 免費 統一收單交易退款查詢 查看退款請求是否執行成功
alipay.trade.pay 免費 統一收單交易支付接口 將二維碼或條碼信息/聲波信息經過本接口上送至支付寶發起支付。
alipay.trade.precreate 免費 統一收單線下交易預建立 二維碼支付
alipay.trade.cancel 免費 統一收單交易撤銷接口 撤銷交易
alipay.trade.create 免費 統一收單交易建立接口 建立下單
alipay.trade.close 免費 統一收單交易關閉接口 用於交易建立後，用戶在必定時間內未進行支付時能夠經過此接口關閉訂單
alipay.trade.order.settle 免費 統一收單交易結算接口 用於在線下場景交易支付後，進行結算
alipay.fund.trans.toaccount.transfer 免費 單筆轉帳到支付寶帳戶接口 支付寶提現
alipay.fund.trans.order.query 免費 查詢轉帳訂單接口 提現結果查詢
alipay.data.dataservice.bill.downloadurl.query 免費 查詢對帳單下載地址 爲方便商戶快速查帳

三、使用服務端SDK封裝接口

3.1 服務端SDK下載及其使用方法

參考 開放平臺服務端SDK

Maven項目引用JAR包能夠參考 支付寶Wap支付你瞭解多少？ 裏面有詳細的介紹

重要說明
一、接口使用的編碼格式爲 UTF-8
二、接口數據交互使用的是 json
三、接口加密的模式使用官方推薦的 RSA2
四、本片文章主要是介紹Java的使用方法與封裝

3.2 初始化SDK

在SDK調用前須要進行初始化

AlipayClient alipayClient = new DefaultAlipayClient(URL, APP_ID, APP_PRIVATE_KEY, FORMAT, CHARSET, ALIPAY_PUBLIC_KEY, SIGN_TYPE);

關鍵參數說明：

配置參數 示例值解釋 獲取方式/示例值
URL 支付網關（固定） 正式環境：https://openapi.alipay.com/gateway.do 沙箱環境：https://openapi.alipaydev.com/gateway.do
APP_ID APPID即建立應用後生成 獲取見上面建立應用並獲取APPID
APP_PRIVATE_KEY 開發者應用私鑰，由開發者本身生成 獲取詳見上面配置密鑰
FORMAT 參數返回格式，只支持json json（固定）
CHARSET 請求和簽名使用的字符編碼格式，支持GBK和UTF-8 開發者根據實際工程編碼配置
ALIPAY_PUBLIC_KEY 支付寶公鑰，由支付寶生成 獲取詳見上面配置密鑰
SIGN_TYPE 商戶生成簽名字符串所使用的簽名算法類型，目前支持RSA2和RSA，推薦使用RSA2 RSA2
3.3 API接口封裝
3.3.1 alipay.trade.query接口封裝

該接口提供全部支付寶支付訂單的查詢，商戶能夠經過該接口主動查詢訂單狀態，完成下一步的業務邏輯。 須要調用查詢接口的狀況： 當商戶後臺、網絡、服務器等出現異常，商戶系統最終未接收到支付通知； 調用支付接口後，返回系統錯誤或未知交易狀態狀況； 調用alipay.trade.pay，返回INPROCESS的狀態； 調用alipay.trade.cancel以前，需確認支付狀態；

/**
     * 交易查詢接口
     * https://doc.open.alipay.com/docs/api.htm?spm=a219a.7395905.0.0.8H2JzG&docType=4&apiId=757
     * @param bizContent
     * @return
     * @throws AlipayApiException
     */
    public static boolean isTradeQuery(AlipayTradeQueryModel model) throws AlipayApiException{
        AlipayTradeQueryResponse response = tradeQuery(model);
        if(response.isSuccess()){
            return true;
        }
        return false;
    }
    
    public static AlipayTradeQueryResponse  tradeQuery(AlipayTradeQueryModel model) throws AlipayApiException{
        AlipayTradeQueryRequest request = new AlipayTradeQueryRequest();
        request.setBizModel(model);
        return alipayClient.execute(request);
    }
3.3.2 alipay.trade.refund 接口封裝

當交易發生以後一段時間內，因爲買家或者賣家的緣由須要退款時，賣家能夠經過退款接口將支付款退還給買家，支付寶將在收到退款請求而且驗證成功以後，按照退款規則將支付款按原路退到買家賬號上。 交易超過約定時間（簽約時設置的可退款時間）的訂單沒法進行退款 支付寶退款支持單筆交易分屢次退款，屢次退款須要提交原支付訂單的商戶訂單號和設置不一樣的退款單號。一筆退款失敗後從新提交，要採用原來的退款單號。總退款金額不能超過用戶實際支付金額

/**
     * 退款
     * https://doc.open.alipay.com/docs/api.htm?spm=a219a.7395905.0.0.SAyEeI&docType=4&apiId=759
     * @param content
     * @return
     * @throws AlipayApiException
     */
    public static String tradeRefund(AlipayTradeRefundModel model) throws AlipayApiException{
        AlipayTradeRefundResponse response = tradeRefundToResponse(model);
        return response.getBody();
    }
    public static AlipayTradeRefundResponse tradeRefundToResponse(AlipayTradeRefundModel model) throws AlipayApiException{
        AlipayTradeRefundRequest request = new AlipayTradeRefundRequest();
        request.setBizModel(model);
        return alipayClient.execute(request);
    }
3.3.3 alipay.trade.fastpay.refund.query接口封裝

商戶可以使用該接口查詢自已經過alipay.trade.refund提交的退款請求是否執行成功。 該接口的返回碼10000，僅表明本次查詢操做成功，不表明退款成功。若是該接口返回了查詢數據，則表明退款成功，若是沒有查詢到則表明未退款成功，能夠調用退款接口進行重試。重試時請務必保證退款請求號一致。

/**
     * 退款查詢
     * https://doc.open.alipay.com/docs/api.htm?spm=a219a.7629065.0.0.KQeTSa&apiId=1049&docType=4
     * @param model
     * @return
     * @throws AlipayApiException
     */
    public static String tradeRefundQuery(AlipayTradeFastpayRefundQueryModel model) throws AlipayApiException{
        AlipayTradeFastpayRefundQueryResponse response = tradeRefundQueryToResponse(model);
        return response.getBody();
    }
    
    public static AlipayTradeFastpayRefundQueryResponse tradeRefundQueryToResponse(AlipayTradeFastpayRefundQueryModel model) throws AlipayApiException{
        AlipayTradeFastpayRefundQueryRequest request = new AlipayTradeFastpayRefundQueryRequest();
        request.setBizModel(model);
        return alipayClient.execute(request);
    }
3.3.4 alipay.trade.pay接口封裝

收銀員使用掃碼設備讀取用戶手機支付寶「付款碼」/聲波獲取設備（如麥克風）讀取用戶手機支付寶的聲波信息後，將二維碼或條碼信息/聲波信息經過本接口上送至支付寶發起支付。

/**
     * 條形碼支付、聲波支付
     * https://doc.open.alipay.com/docs/api.htm?spm=a219a.7629065.0.0.XVqALk&apiId=850&docType=4
     * @param notifyUrl 
     * @throws AlipayApiException
     */
    public static String tradePay(AlipayTradePayModel model, String notifyUrl) throws AlipayApiException {
        AlipayTradePayResponse response = tradePayToResponse(model,notifyUrl);
        return response.getBody();
    }
    
    public static AlipayTradePayResponse tradePayToResponse(AlipayTradePayModel model, String notifyUrl) throws AlipayApiException{
        AlipayTradePayRequest request = new AlipayTradePayRequest();
        request.setBizModel(model);// 填充業務參數
        request.setNotifyUrl(notifyUrl);
        return alipayClient.execute(request); // 經過alipayClient調用API，得到對應的response類
    }
3.3.5 alipay.trade.precreate 接口封裝

收銀員經過收銀臺或商戶後臺調用支付寶接口，生成二維碼後，展現給用戶，由用戶掃描二維碼完成訂單支付。

/**
     * 掃碼支付
     * https://doc.open.alipay.com/docs/doc.htm?spm=a219a.7629140.0.0.i0UVZn&treeId=193&articleId=105170&docType=1#s4
     * @param notifyUrl 
     * @return
     * @throws AlipayApiException 
     */
    public static String tradePrecreatePay(AlipayTradePrecreateModel model, String notifyUrl) throws AlipayApiException{
        AlipayTradePrecreateResponse response = tradePrecreatePayToResponse(model,notifyUrl);
        return response.getBody();
    }
    public static AlipayTradePrecreateResponse tradePrecreatePayToResponse(AlipayTradePrecreateModel model, String notifyUrl) throws AlipayApiException{
        AlipayTradePrecreateRequest request = new AlipayTradePrecreateRequest();
        request.setBizModel(model);
        request.setNotifyUrl(notifyUrl);
        return alipayClient.execute(request);
    }
3.3.6 alipay.trade.cancel 接口封裝

支付交易返回失敗或支付系統超時，調用該接口撤銷交易。若是此訂單用戶支付失敗，支付寶系統會將此訂單關閉；若是用戶支付成功，支付寶系統會將此訂單資金退還給用戶。 注意：只有發生支付系統超時或者支付結果未知時可調用撤銷，其餘正常支付的單如需實現相同功能請調用申請退款API。提交支付交易後調用【查詢訂單API】，沒有明確的支付結果再調用【撤銷訂單API】。

/**
     * 交易撤銷接口
     * https://doc.open.alipay.com/docs/api.htm?spm=a219a.7395905.0.0.XInh6e&docType=4&apiId=866
     * @param bizContent
     * @return
     * @throws AlipayApiException
     */
    public static boolean isTradeCancel(AlipayTradeCancelModel model) throws AlipayApiException{
        AlipayTradeCancelResponse response = tradeCancel(model);
        if(response.isSuccess()){
            return true;
        }
        return false;
    }
    
    public static AlipayTradeCancelResponse tradeCancel(AlipayTradeCancelModel model) throws AlipayApiException{
        AlipayTradeCancelRequest request = new AlipayTradeCancelRequest();
        request.setBizModel(model);
        AlipayTradeCancelResponse response = alipayClient.execute(request);
        return response;
    }
3.3.7 alipay.trade.create 接口封裝

商戶經過該接口進行交易的建立下單

/**
     * 統一收單交易建立接口
     * https://doc.open.alipay.com/docs/api.htm?spm=a219a.7629065.0.0.21yRUe&apiId=1046&docType=4
     * @param model
     * @param notifyUrl 
     * @return
     * @throws AlipayApiException
     */
    public static AlipayTradeCreateResponse tradeCreate(AlipayTradeCreateModel model, String notifyUrl) throws AlipayApiException{
        AlipayTradeCreateRequest request = new AlipayTradeCreateRequest();
        request.setBizModel(model);
        request.setNotifyUrl(notifyUrl);
        return alipayClient.execute(request);
    }
3.3.8 alipay.trade.close 接口封裝

用於交易建立後，用戶在必定時間內未進行支付，可調用該接口直接將未付款的交易進行關閉。

/**
     * 關閉訂單
     * https://doc.open.alipay.com/docs/api.htm?spm=a219a.7629065.0.0.21yRUe&apiId=1058&docType=4
     * @param model
     * @return
     * @throws AlipayApiException
     */
    public static boolean isTradeClose(AlipayTradeCloseModel model) throws AlipayApiException{
        AlipayTradeCloseResponse response = tradeClose(model);
        if(response.isSuccess()){
            return true;
        }
        return false;
    }
    
    public static AlipayTradeCloseResponse tradeClose(AlipayTradeCloseModel model) throws AlipayApiException{
        AlipayTradeCloseRequest request = new AlipayTradeCloseRequest();
        request.setBizModel(model);
        return alipayClient.execute(request);
        
    }
3.3.9 alipay.trade.order.settle接口封裝

用於在線下場景交易支付後，進行結算

/**
     * 交易結算接口
     * https://doc.open.alipay.com/docs/api.htm?spm=a219a.7395905.0.0.nl0RS3&docType=4&apiId=1147
     * @param bizContent
     * @return
     * @throws AlipayApiException
     */
    public static boolean isTradeOrderSettle(AlipayTradeOrderSettleModel model) throws AlipayApiException{
        AlipayTradeOrderSettleResponse  response  = tradeOrderSettle(model);
        if(response.isSuccess()){
            return true;
        }
        return false;
    }
    
    public static AlipayTradeOrderSettleResponse tradeOrderSettle(AlipayTradeOrderSettleModel model) throws AlipayApiException{
        AlipayTradeOrderSettleRequest request = new AlipayTradeOrderSettleRequest();
        request.setBizModel(model);
        return alipayClient.execute(request);
    }
3.3.10 alipay.fund.trans.toaccount.transfer接口封裝

能夠參考 支付寶支付-提現到我的支付寶

3.3.11 alipay.fund.trans.order.query接口封裝

能夠參考 支付寶支付-提現到我的支付寶

3.3.12 alipay.data.dataservice.bill.downloadurl.query 接口封裝

爲方便商戶快速查帳，支持商戶經過本接口獲取商戶離線帳單下載地址

/**
     * 查詢對帳單下載地址
     * @param bizContent
     * @return
     * @throws AlipayApiException
     */
    public static String billDownloadurlQuery(AlipayDataDataserviceBillDownloadurlQueryModel model) throws AlipayApiException{
        AlipayDataDataserviceBillDownloadurlQueryResponse response =  billDownloadurlQueryToResponse(model);
        return response.getBillDownloadUrl();
    }
    
    public static AlipayDataDataserviceBillDownloadurlQueryResponse  billDownloadurlQueryToResponse (AlipayDataDataserviceBillDownloadurlQueryModel model) throws AlipayApiException{
        AlipayDataDataserviceBillDownloadurlQueryRequest request = new AlipayDataDataserviceBillDownloadurlQueryRequest();
        request.setBizModel(model);
        return alipayClient.execute(request);
    }

四、異步通知封裝

將異步通知的參數轉化爲Map爲驗籤作準備

/**
     * 將異步通知的參數轉化爲Map
     * @param request
     * @return
     */
    public static Map<String, String> toMap(HttpServletRequest request) {
        System.out.println(">>>>" + request.getQueryString());
        Map<String, String> params = new HashMap<String, String>();
        Map<String, String[]> requestParams = request.getParameterMap();
        for (Iterator<String> 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] + ",";
            }
            // 亂碼解決，這段代碼在出現亂碼時使用。
            // valueStr = new String(valueStr.getBytes("ISO-8859-1"), "utf-8");
            params.put(name, valueStr);
        }
        return params;
    }

使用AlipaySignature.rsaCheckV1(....)接口進行驗證簽名

public void notify_url() {
        try {
            // 獲取支付寶POST過來反饋信息
            Map<String, String> params = AliPayApi.toMap(getRequest());

            for (Map.Entry<String, String> entry : params.entrySet()) {
                System.out.println(entry.getKey() + " = " + entry.getValue());
            }

            boolean verify_result = AlipaySignature.rsaCheckV1(params, AliPayApi.ALIPAY_PUBLIC_KEY, AliPayApi.CHARSET,
                    AliPayApi.SIGN_TYPE);

            if (verify_result) {// 驗證成功
                // TODO 請在這裏加上商戶的業務邏輯程序代碼 異步通知可能出現訂單重複通知 須要作去重處理
                System.out.println("notify_url 驗證成功succcess");
                renderText("success");
                return;
            } else {
                System.out.println("notify_url 驗證失敗");
                // TODO
                renderText("failure");
                return;
            }
        } catch (AlipayApiException e) {
            e.printStackTrace();
            renderText("failure");
        }
    }

此項目已開源歡迎Start、PR、發起Issues一塊兒討論交流共同進步

https://github.com/Javen205/IJPay http://git.oschina.net/javen205/IJPay

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程