2. 程式人生 > >微信支付服務端開發總結

微信支付服務端開發總結

阿新 • • 發佈：2018-10-31


前言

最近應公司業務需求，把微信支付完成了，當然已經順利上線。但是開發的過程是也是踩了很多坑，下面我就先說說開發流程，以及在開發中遇到的大大小小的坑。

開發流程

首先，看一下微信開方平臺關於支付的一個時序圖，如下：

微信支付時序圖
https://pay.weixin.qq.com/wiki/doc/api/app/app.php

商戶系統和微信支付系統主要互動說明：
步驟1：使用者在商戶APP中選擇商品，提交訂單，選擇微信支付。
步驟2：商戶後臺收到使用者支付單，呼叫微信支付統一下單介面。參見【統一下單API】。
步驟3：統一下單介面返回正常的prepay_id，再按簽名規範重新生成簽名後，將資料傳輸給APP。參與簽名的欄位名為appId，partnerId，prepayId，nonceStr，timeStamp，package
 
。注意：package的值格式為Sign=WXPay
步驟4：商戶APP調起微信支付。api參見本章節【app端開發步驟說明】
步驟5：商戶後臺接收支付通知。api參見【支付結果通知API】
步驟6：商戶後臺查詢支付結果。，api參見【查詢訂單API】

這裡我講解的服務端的開發，那我們就看服務端需要做什麼工作。

第一步 統一下單

商戶系統先呼叫該介面在微信支付服務後臺生成預支付交易單，返回正確的預支付交易回話標識後再在APP裡面調起支付。
首先，準備請求的引數
程式碼如下:

private SortedMap<String, Object> prepareOrder(String
 
 ip, String orderId,
            int price) {
        Map<String, Object> oparams = ImmutableMap.<String, Object> builder()
                .put("appid", ConfigUtil.APPID)//應用號
                .put("body", WeixinConstant.PRODUCT_BODY)// 商品描述
                .put("mch_id", ConfigUtil.MCH_ID)// 商戶號
 

                .put("nonce_str", PayCommonUtil.CreateNoncestr())// 16隨機字串(大小寫字母加數字)
                .put("out_trade_no", orderId)// 商戶訂單號
                .put("total_fee", "1")// 銀行幣種支付的錢錢啦
                .put("spbill_create_ip", ip)// IP地址
                .put("notify_url", ConfigUtil.NOTIFY_URL) // 微信回撥地址
                .put("trade_type", ConfigUtil.TRADE_TYPE)// 支付型別 APP
                .build();
        return MapUtils.sortMap(oparams);
    }

接下來將這些請求引數格式化成XML格式的資料 like this

<xml>
   <appid>wx2421b1c4370ec43b</appid>
   <attach>支付測試</attach>
   <body>APP支付測試</body>
   <mch_id>10000100</mch_id>
   <nonce_str>1add1a30ac87aa2db72f57a2375d8fec</nonce_str>
   <notify_url>http://wxpay.weixin.qq.com/pub_v2/pay/notify.v2.php</notify_url>
   <out_trade_no>1415659990</out_trade_no>
   <spbill_create_ip>14.23.150.211</spbill_create_ip>
   <total_fee>1</total_fee>
   <trade_type>APP</trade_type>
   <sign>0CB01533B8C1EF103065174F50BCA001</sign>
</xml>

請求統一下單地址 https://api.mch.weixin.qq.com/pay/unifiedorder
程式碼（部分程式碼,完整的程式碼請見我的)github

String requestXML = PayCommonUtil.getRequestXml(parameters);// 生成xml格式字串
String responseStr = HttpUtil.httpsRequest(
ConfigUtil.UNIFIED_ORDER_URL, "POST", requestXML);// 帶上post

完成之後將微信返回的資料進行解析，取出APP客戶端需要的資料，用於喚起微信支付。程式碼

    /**
     * 生成訂單完成，返回給android,ios喚起微信所需要的引數。
     * 
     * @param resutlMap
     * @return
     * @throws UnsupportedEncodingException
     */
    private SortedMap<String, Object> buildClientJson(
            Map<String, Object> resutlMap) throws UnsupportedEncodingException {
        // 獲取微信返回的簽名

        /**
         * backObject.put("appid", appid);
         * 
         * backObject.put("noncestr", payParams.get("noncestr"));
         * 
         * backObject.put("package", "Sign=WXPay");
         * 
         * backObject.put("partnerid", payParams.get("partnerid"));
         * 
         * backObject.put("prepayid", payParams.get("prepayid"));
         * 
         * backObject.put("appkey", this.appkey);
         * 
         * backObject.put("timestamp",payParams.get("timestamp"));
         * 
         * backObject.put("sign",payParams.get("sign"));
         */
        Map<String, Object> params = ImmutableMap.<String, Object> builder()
                .put("appid", ConfigUtil.APPID)
                .put("noncestr", PayCommonUtil.CreateNoncestr())
                .put("package", "Sign=WXPay")
                .put("partnerid", ConfigUtil.MCH_ID)
                .put("prepayid", resutlMap.get("prepay_id"))
                .put("timestamp", DateUtils.getTimeStamp()).build();//取10位時間戳
        // key ASCII排序
        SortedMap<String, Object> sortMap = MapUtils.sortMap(params);
        sortMap.put("package", "Sign=WXPay");
        // paySign的生成規則和Sign的生成規則同理
        String paySign = PayCommonUtil.createSign("UTF-8", sortMap);
        sortMap.put("sign", paySign);
        return sortMap;
    }

整個統一下訂單的邏輯就完成了。這裡小結一下：

  1. 請求引數需要按照引數的key進行字母的ASCII碼進行排序，由於我使用的是map資料結構，這裡提供一個對map集合中的key元素進行排序的工具類

/**
     * 對map根據key進行排序 ASCII 順序
     * 
     * @param 無序的map
     * @return
     */
    public static SortedMap<String, Object> sortMap(Map<String, Object> map) {
        List<Map.Entry<String, Object>> infoIds = new ArrayList<Map.Entry<String, Object>>(
                map.entrySet());
        // 排序
        Collections.sort(infoIds, new Comparator<Map.Entry<String, Object>>() {
            public int compare(Map.Entry<String, Object> o1,
                    Map.Entry<String, Object> o2) {
                return (o1.getKey()).toString().compareTo(o2.getKey());
            }
        });
        SortedMap<String, Object> sortmap = new TreeMap<String, Object>();
        for (int i = 0; i < infoIds.size(); i++) {
            String[] split = infoIds.get(i).toString().split("=");
            sortmap.put(split[0], split[1]);
        }
        return sortmap;
    }

  1. 對排序後的資料進行MD5簽名，微信服務端會進行校驗，防止資料在網路傳輸過程中被篡改。

  2. 拿到微信響應的資料，首先要做的事，也是對獲取的資料進行簽名校驗，理由同上。

  3. 需要注意的一點，返回給app客戶端的資料的key一定是小寫，這點微信的api是沒有說明白的，之前和客戶端聯調時耽誤了很多時間，這也是微信支付被很多開發者吐槽的地方api比較難用^-^

  4. 注意小細節：返回給客戶端時時間戳要是10位的，太長ios那邊會越界，支付不成功。

第二步 調起支付

支付成功後，微信就會呼叫你填寫的notify_url的方法，本人微信支付的開發配置中說明了我的notify_url為http://ip:port/weixin
/pay/callback/pay.action
對後臺通知互動時，如果微信收到商戶的應答不是成功或超時，微信認為通知失敗，微信會通過一定的策略（如 30 分鐘共 8 次）定期重新發起通知，儘可能提高通知的成功率，但微信不保證通知最終能成功。由於存在重新収送後臺通知的情況，因此同樣的通知可能會多次収送給商戶系統。 商戶系統必須能夠正確處理重複的通知。推薦的做法是，當收到通知進行處理時，首先檢查對應業務資料的狀態，判斷該通知是否已經處理過，如果沒有處理過再進行處理，如果處理過直接返回結果成功。在對業務資料進行狀態檢查和處理之前，要採用資料鎖進行幵収控制，以避免凼數重入造成的資料混亂。判斷完成後，我們需要通知微信，我們收到資訊了，不然微信就會通過一定的策略定期重新發起通知。

/**
     * 微信回撥告訴微信支付結果 注意：同樣的通知可能會多次傳送給此介面，注意處理重複的通知。
     * 對於支付結果通知的內容做簽名驗證，防止資料洩漏導致出現“假通知”，造成資金損失。
     * 
     * @param params
     * @return
     */
    public String callback(HttpRequest request) {
        try {
            String responseStr = parseWeixinCallback(request);
            Map<String, Object> map = XMLUtil.doXMLParse(responseStr);
            // 校驗簽名 防止資料洩漏導致出現“假通知”，造成資金損失
            if (!PayCommonUtil.checkIsSignValidFromResponseString(responseStr)) {
                logger.error("微信回撥失敗,簽名可能被篡改");
                return PayCommonUtil.setXML("FAIL", "invalid sign");
            }
            if (WeixinConstant.FAIL.equalsIgnoreCase(map.get("result_code")
                    .toString())) {
                logger.error("微信回撥失敗");
                return PayCommonUtil.setXML("FAIL", "weixin pay fail");
            }
            if (WeixinConstant.SUCCESS.equalsIgnoreCase(map.get("result_code")
                    .toString())) {
                //獲取應用伺服器需要的資料進行持久化操作
                String outTradeNo = (String) map.get("out_trade_no");
                String transactionId = (String) map.get("transaction_id");
                String totlaFee = (String) map.get("total_fee");
                Integer totalPrice = Integer.valueOf(totlaFee);
                if (PayApp.theApp.isDebug()) {// 測試時候支付一分錢，買入價值6塊的20分鐘語音
                    totalPrice = 6;
                }
                boolean isOk = updateDB(outTradeNo, transactionId, totalPrice,
                        2);
                // 告訴微信伺服器，我收到資訊了，不要在呼叫回撥action了
                if (isOk) {
                    return PayCommonUtil.setXML(WeixinConstant.SUCCESS, "OK");
                } else {
                    return PayCommonUtil
                            .setXML(WeixinConstant.FAIL, "pay fail");
                }
            }
        } catch (Exception e) {
            logger.debug("支付失敗" + e.getMessage());
            return PayCommonUtil.setXML(WeixinConstant.FAIL,
                    "weixin pay server exception");
        }
        return PayCommonUtil.setXML(WeixinConstant.FAIL, "weixin pay fail");
    }

小結：

  1. 當在本地做開發時，微信回撥是不方便的，這裡提供一種比較快速的方法，不過前提是有云伺服器。用ssh建立反向通道。

步驟如下：
(1) ssh -R 9999:localhost:9000 ubuntu@myserver_ip_address，輸入密碼；

(2) server上檢視一下是否監聽了9999埠，netstat -anltp | grep 9999；

ubuntu@VM-39-45-ubuntu:~$ netstat -anltp | grep 9999
(Not all processes could be identified, non-owned process info
will not be shown, you would have to be root to see it all.)
tcp        0      0 127.0.0.1:9999          0.0.0.0:*               LISTEN      -
tcp6       0      0 ::1:9999                :::*                    LISTEN      -
(3) 在本地9000上開啟web服務；
(4) 當微信回撥公網伺服器時就會被代理到本地9000埠對應的web服務；

這樣就可以在本地除錯了，是不是很方便呢。

2.回撥邏輯中記得，將重要資料在應用伺服器進行持久化哦。

第三步 查詢訂單

該介面提供所有微信支付訂單的查詢，商戶可以通過該介面主動查詢訂單狀態，完成下一步的業務邏輯。

需要呼叫查詢介面的情況：
◆ 當商戶後臺、網路、伺服器等出現異常，商戶系統最終未接收到支付通知；
◆ 呼叫支付介面後，返回系統錯誤或未知交易狀態情況；
◆ 呼叫被掃支付API，返回USERPAYING的狀態；
◆ 呼叫關單或撤銷介面API之前，需確認支付狀態；

需要提供兩個引數
outTradeNo 商戶訂單號
transactionId 微信訂單號 
二選一
請求介面 https://api.mch.weixin.qq.com/pay/orderquery
程式碼:

/**
     * 封裝查詢請求資料
     * @param outTradeNo 
     * @param transactionId
     * @return
     */
    private SortedMap<String, Object> prepareQueryData(String outTradeNo,
            String transactionId) {
        Map<String, Object> queryParams = null;
        // 微信的訂單號，優先使用
        if (null == outTradeNo || outTradeNo.length() == 0) {
            queryParams = ImmutableMap.<String, Object> builder()
                    .put("appid", ConfigUtil.APPID)
                    .put("mch_id", ConfigUtil.MCH_ID)
                    .put("transaction_id", transactionId)
                    .put("nonce_str", PayCommonUtil.CreateNoncestr()).build();
        } else {
            queryParams = ImmutableMap.<String, Object> builder()
                    .put("appid", ConfigUtil.APPID)
                    .put("mch_id", ConfigUtil.MCH_ID)
                    .put("out_trade_no", outTradeNo)
                    .put("nonce_str", PayCommonUtil.CreateNoncestr()).build();
        }
        // key ASCII 排序
        SortedMap<String, Object> sortMap = MapUtils.sortMap(queryParams);
        // 簽名
        String createSign = PayCommonUtil.createSign("UTF-8", sortMap);
        sortMap.put("sign", createSign);
        return sortMap;
    }

下一步對微信響應的資料進行解析，檢查支付的狀態程式碼如下

/**
     * 查詢訂單狀態
     * 
     * @param params
     *            訂單查詢引數
     * @return
     */
    public HttpResult<String> checkOrderStatus(SortedMap<String, Object> params) {
        if (params == null) {
            return HttpResult.error(1, "查詢訂單引數不能為空");
        }
        try {
            String requestXML = PayCommonUtil.getRequestXml(params);// 生成xml格式字串
            String responseStr = HttpUtil.httpsRequest(
                    ConfigUtil.CHECK_ORDER_URL, "POST", requestXML);// 帶上post
            SortedMap<String, Object> responseMap = XMLUtil
                    .doXMLParse(responseStr);// 解析響應xml格式字串

            // 校驗響應結果return_code
            if (WeixinConstant.FAIL.equalsIgnoreCase(responseMap.get(
                    "return_code").toString())) {
                return HttpResult.error(1, responseMap.get("return_msg")
                        .toString());
            }
            // 校驗業務結果result_code
            if (WeixinConstant.FAIL.equalsIgnoreCase(responseMap.get(
                    "result_code").toString())) {
                return HttpResult.error(2, responseMap.get("err_code")
                        .toString() + "=" + responseMap.get("err_code_des"));
            }
            // 校驗簽名
            if (!PayCommonUtil.checkIsSignValidFromResponseString(responseStr)) {
                logger.error("訂單查詢失敗,簽名可能被篡改");
                return HttpResult.error(3, "簽名錯誤");
            }
            // 判斷支付狀態
            String tradeState = responseMap.get("trade_state").toString();
            if (tradeState != null && tradeState.equals("SUCCESS")) {
                return HttpResult.success(0, "訂單支付成功");
            } else if (tradeState == null) {
                return HttpResult.error(4, "獲取訂單狀態失敗");
            } else if (tradeState.equals("REFUND")) {
                return HttpResult.error(5, "轉入退款");
            } else if (tradeState.equals("NOTPAY")) {
                return HttpResult.error(6, "未支付");
            } else if (tradeState.equals("CLOSED")) {
                return HttpResult.error(7, "已關閉");
            } else if (tradeState.equals("REVOKED")) {
                return HttpResult.error(8, "已撤銷（刷卡支付");
            } else if (tradeState.equals("USERPAYING")) {
                return HttpResult.error(9, "使用者支付中");
            } else if (tradeState.equals("PAYERROR")) {
                return HttpResult.error(10, "支付失敗");
            } else {
                return HttpResult.error(11, "未知的失敗狀態");
            }
        } catch (Exception e) {
            logger.error("訂單查詢失敗,查詢引數 = {}", JSONObject.toJSONString(params));
            return HttpResult.success(1, "訂單查詢失敗");
        }
    }

整個流程就是這樣的，呵呵呵...好久沒寫部落格有點手生了。對於程式碼中很多工具類，這裡就不一一貼出來了. Fork me on Github thanks !


from:  https://segmentfault.com/a/1190000005795580

相關推薦

微信支付服務端開發總結

前言 最近應公司業務需求，把微信支付完成了，當然已經順利上線。但是開發的過程是也是踩了很多坑，下面我就先說說開發流程，以及在開發中遇到的大大小小的坑。 開發流程 首先，看一下微信開方平臺關於支付的一個時序圖，如下： 微信支付時序圖https://p

java版app微信支付服務端程式碼【手機app微信支付】

老早就像做支付模組的東西，因為覺得很高大上，很早就開始把微信支付模組的重心簽名給做好了，一直就缺個商家的key，現在有幸來電商公司，哈哈，果然一切很順利，能夠很給力地App端提供支援； 個人覺得核心部分的程式碼： 簽名： //引數：開始生成簽名 SortedMap&

微信支付服務端的一些坑及最終解決

有1年多沒搞微信支付了，最近跳槽，要重做APP，又來接觸微信這個坑比。OK，不多說，上程式碼。以下是我的一個controller類，重點在下面  // 微信交易型別       private static final String TRADETYPE = "APP"; 

java--spring boot微信支付服務端實現含程式碼（app支付、掃碼支付等）

最近在弄支付寶、微信支付等的事，發現這兩家的文件都寫得很差，demo也讓人看的雲裡霧裡。所以寫篇部落格，來儘量減少後來的同學走的彎路。 首先，若是要做app支付的話，在微信第三方平臺申請APP，若是安卓的話上傳你的keystore和包名，ios上傳bundle id，微信會

React Native (IOS和Android) 支付寶和微信支付整合實戰（微信支付服務端篇）

序言：React Native無論是在社群和應用程度上，在國內外是十分廣泛和普及的。而支付寶和微信在支付模組上都有或多或少的支援，雖然沒有完整的Demo，不過在我做過一個相關整合的專案後，在此我把相關的步驟和方法總結出來和大家分享，希望能夠幫助大家少走彎路，快速整合。 微信

微信支付APP端以及服務端（JavaEE）可以直接使用

最近在整合微信支付，不得不說微信文件就是坑，說的不明不白，還是支付寶簡單，流程：1、客戶端提交訂單——》到（自己平臺的）伺服器，引數與服務端協商2、服務端拿到請求訂單資訊——》參考微信統一下單介面——》把必須傳的引數進行加密轉XML傳到微信伺服器3、如果簽名正確，微信服務端會

php微信支付接口開發的實現程序

etc 內容 網站 ati eat xxx 通過 發微信 ood 微信支付接口現在也慢慢的像支付寶一個可以利用api接口來實現第三方網站或應用進行支付了，下文是我公司的技術人員整理了一個php微信支付接口開發程序並且己測試，有興趣的朋友可進入參考。 　　必要條件： 　　ap

微信充值頁面開發總結

code 技術分享 app 成功 input put 按鈕 lose 微信 上周開發了公司項目的微信充值頁面，下面對項目遇到的問題做一個總結。 1、下單流程 前端獲取code---把code給後端去獲取openID---將openID和訂單信息發給後端獲取微信支付所需參數（

微信支付後臺介面開發(掃碼版)

一：需求 滿足公司在網頁上達到直接微信掃碼支付的需求 二：API官方文件 參考連結:https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=9_1 三：微信支付的過程（使用者-商家-微信伺服器） 四:程式碼實現

微信支付客戶端實現流程

前期準備：                 1）註冊微信開放平臺賬號                 2）認證開發者資質                 3）建立APP並提交稽核 1）2）3）三個流程約7個工作日；         4）提交資料申請微信支付 5）啟動設計和開

微信小程式地圖開發總結

　　最近在做一個微信小程式地圖外掛，通過傳入起始位置名稱和經緯度資訊，就可以跳轉到路線規劃外掛頁面中，在該頁面中，可以根據起始位置查詢自駕，公共交通，步行等方式的路線資訊，並且在地圖上顯示路線資訊，在這個過程中，用到了微信小程式的元件map和騰訊地圖sdk，接下來主要對微信小程式的地圖開發進行總結 &nbs

微信支付（APP支付）-服務端開發（一）

微信支付，首先需要註冊一個商戶平臺公眾賬號，（網址：https://pay.weixin.qq.com/index.php/home/d_login） 目前微信支付的接入方式有四種方式：公眾號支付，APP支付，掃描支付，刷卡支付。本文中我將詳細講解一下APP支付。 微信支付→APP支付官方文件：https

php 版本 微信支付 APP 服務端開發

我們通過 微信支付的文件知道 第一步 服務端需要呼叫統一下單介面生成預付單，其中主要的引數就是 prepay_id 這樣 app 通過 prepay_id 就可以發起支付請求了。 我們可以參考 微信支付的 官方SDK(就是個坑) 統一下單介面就是 呼叫函式

微信支付Java開發服務端

想要呼叫微信支付第一就是獲取openid： 獲取openid的方法： 首先你需要在前臺獲取到code， scope兩種引數的說明： 1、以snsapi_base為scope發起的網頁授權，是用來獲取進入頁面的使用者的openid的，並且是靜默授權並自

微信支付——呼叫微信客戶端支付之【服務端】開發詳解

最近準備上網頁的微信支付,大家可以參考後續教程: 2015-09-12 更新： 因微信支付已經升級到V3版本，請大家參考官網的幫助文件。 之前一篇提到微信支付的開發過程，寫得有點亂，現在重新整理一下。 好了，說說到底該怎樣一步一步分享處理。 先把服務端d

微信服務號開發-商城微信支付

ios eve style 簽名 生成 cli poi size func 　　　　　　　　　　　　　　　　　function onBridgeReady() { WeixinJSBridge.invok

微信小程序後端開發總結~1（C#）

ali 存在 漢字轉換 返回 font con utf8 OS big 1.小程序端對於18位long類型的接收轉換會出錯，比如171106161246602821—> 171106161246602820。 例如：用戶表的主鍵id存的是18位的biglong類型的，

微信公眾平臺開發教程-微信公眾服務號申請、認證（開通支付）-微信開發教程

微信公眾號服務號與訂閱號的區別 訂閱號： 1、每天可以發1次資訊，每次可以傳送8篇文章（資訊展示在微信公眾號摺疊檔案中） 2、不能申請微信支付功能 3、認證後才可以使用自定義選單功能 4、訂閱號適合：不需要支付功能，以為使用者提供諮詢資訊的企業。 服務號： 1、每月可以發4次資訊，每次可以傳送8

java服務端，微信支付功能的實現

     接入微信的支付功能在java服務端，現在記錄下來這個過程，方便以後用到。程式碼都是參考網路，功能可以實現      實際參考https://github.com/wxpay/WXPay-SDK-Java     ①，寫一個介面，作為引數配置的介面，當然也可以不用介

關於移動端頁面開發（微信內建瀏覽器）總結

上個禮拜，剛入職就接到一個移動端的活動頁面專案，重點還是要相容微信瀏覽器，相容主流機型。在這之前，我所做的都是PC端的，想來兩者差別不大，實際動手時遇到的坑還是蠻多的。時間過去的有點久，我也不能把每個坑都列出來，只能寫些印象深刻的。   1、關於頁面背景