處處是坑的微信公衆號支付開發（java）

時間 2019-11-20

標籤處處微信公衆號支付開發 java 欄目 Java 简体版

原文原文鏈接

以前公司項目開發中支付是用阿里的支付作的，那叫一個簡單，隨意；悲催的是，如今公司開發了微信公衆號，因此我步入了全是坑的微信支付開發中。。。php

-----------------------------------------------------------------------------------------------------------java

業務流程：node

　　這個微信官網說的很詳細的（傳送門：https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_4）。算法

　　大概的流程就是：用戶點擊一個支付按鈕-->後臺處理（其實就是封裝支付必要的數據以及獲取prepay_id，而後將它和一些必須參數封裝傳給前臺）-->前臺接收數據而且調用微信的js處理數據並調用支付-->用戶看到了一個輸入密碼的界面，包含金額等一些信息-->用戶輸入密碼後出來一個支付成功的頁面，同時微信會回調咱們的接口通知咱們支付結果（這部分流程都是微信本身完成的，咱們不用管）-->返回系統本身的頁面。api

開發步驟：安全

1、設置支付目錄微信

　　這個官方文檔寫的很噁心，看的我一頭霧水，真心有點暈。雖然看不懂，可是以爲很厲害的樣子！傳送門：https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_3app

2、設置受權域名dom

這2步完成以後，你能夠休息一下了，由於巨坑要來了。。。異步

3、商戶server調用統一下單接口請求訂單

這是幹啥的？剛開始作的時候一頭霧水，可是誰叫人家微信支付團隊nb啊，不整點你不理解的東西，怎能體現出他們的高大上。。。不理解，不要緊照着文檔作唄

傳送門：,https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_1 微信官方給了個參數的詳細說明。看了半天，總結了一下，就是封裝一些必要參數而後去訪問https://api.mch.weixin.qq.com/pay/unifiedorder這個接口獲取數據。下面是幾個經常使用的參數，直接copy別人的介紹很是詳細：

appid ==應用ID==登錄微信公衆號後臺-開發-基本配置

mch_id == 微信支付商戶號==登錄微信支付後臺，便可看到

device_info==設備號==終端設備號(門店號或收銀設備ID)，注意：PC網頁或公衆號內支付請傳"WEB"

body==商品描述==商品或支付單簡要描述（建議剛開始最好傳英文，儘可能先別傳漢子，要不以後簽名出問題都無法查）

trade_type==交易類型==取值以下：JSAPI，NATIVE，APP。咱們這裏使用的JSAPI。標題已經說了，是微信公衆號支付。他們的區別，請參考https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=4_2

　　　　　　ps：JSAPI--公衆號支付、NATIVE--原生掃碼支付、APP--app支付，統一下單接口trade_type的傳參可參考這裏。MICROPAY--刷卡支付，刷卡支付有單獨的支付接口，不調用統一下單接口

nonce_str==隨機字符串==隨機字符串，不長於32位（參考算法https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=4_3）　　　

notify_url==通知地址==接收微信支付異步通知回調地址，通知url必須爲直接可訪問的url，不能攜帶參數。（這，起個什麼名字好呢。隨便起吧，反正一時半會也用不到）

out_trade_no==商戶訂單號==商戶系統內部的訂單號,32個字符內、可包含字母（參考：https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=4_2）（每次看完微信的官方解釋就更迷茫了，有木有。不要緊，我就傳個1咋了。）

total_fee==總金額==訂單總金額，單位爲分（這個注意一下，我開始沒注意，傳的是0.01，開發麼都用1分錢，而後就悲劇了，看了好多遍才發現單位是分分分）

openid==用戶標識==trade_type=JSAPI，此參數必傳，用戶在商戶appid下的惟一標識。（要是不知道這個從哪裏來的話，不要緊。微信不是給咱寫文檔了嗎https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=4_4）

還有最最重要的一個，重要的角色總要在最後登場。

attach==附加數據，在查詢API和支付通知中原樣返回，可做爲自定義參數使用。（這個我以爲挺有用的，能夠用來放業務數據，由於我是在微信回調中處理業務數據的，用這個參數安全無痛）

sign==簽名==官方給的簽名算法。https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=4_3。沒有看懂，看不太懂，你以爲你看懂了，不要緊，不遇到幾回簽名錯誤，好意思說本身作過微信支付開發嗎（我的推薦開發時候用官方sdk中的工具來作，能省不少麻煩https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=11_1在這裏下載java的API對應的SDK和調用示例，裏面工具很全）

說道這個sign還有一個更重要的參數。參與簽名的參數。反正我是找了很久才找到。（公司運營申請的微信支付，當我找她要的時候，他的表情是這樣子的。）

key==key設置路徑：微信商戶平臺(pay.weixin.qq.com)-->帳戶設置-->API安全-->密鑰設置（這個很重要，簽名都用它）

這部分總結就是，先將數據封裝成map而後經過工具轉化成xml(工具上面提到了，本身回去看)，而後經過post請求請求【微信統一下單接口】，若是sign沒有問題就會返回一個xml,裏面不少數據，其中咱們要的是prepay_id，就是這個參數，而後生成簽名返回到前臺,ok這步也完成了。

問題總結（我在這過程當中遇到的問題）：1（重要）appid與openid必須是匹配的，換句話說就是用戶的openid必須是在當前的公衆號下用戶（咱們好幾個公衆號，可能大家不會遇到這個問題，可是這很重要，說以第一個說）2

第二步，生成簽名並返回到前臺這個過程當中必定要注意參數必定要寫對了，大小寫，是否有空格，我在這上面掉了一個大坑，界面調用支付時一直閃退，注意.

4、H5調起微信支付的內置JS

後臺傳回前臺的參數中，應包含如下幾項：

appId==這個是不變的==永遠不變

timeStamp==時間戳==規則：https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=4_2。看完還是一臉迷茫的，不要緊，咱們有工具類。

nonceStr ==反正我用的跟剛纔簽名是同一個隨機字符串。理論上不用應該也沒有關係的，勤快的小夥伴能夠試試

package==訂單詳情擴展字符串==統一下單接口返回的prepay_id參數值，提交格式如：prepay_id=***（你猜對了。剛纔咱們費那麼大力氣，得到到的prepay_id就是在這裏用的）

signType==簽名方式==簽名算法，暫支持MD5

paySign==簽名==這個簽名，要從新生成，在後臺。使用如上4個參數+一個key（永遠不變）。（我生成簽名的時間戳和傳回給前臺的時間戳就是timeStamp是同一個。不同行不行，木有驗證）

生成paySign 的代碼

注意:生成prepay_id時appid是小寫的i,生成paySign時，appId是大寫的I，這倆是不一樣的

若是一切順利的話，就會出現這個頁面

這些都作完了你就能夠放鬆一下了

五，微信回調處理

該部分有如下3小步驟

　　　　1）解析傳過來的流信息，經過從新簽名的方式驗證流中包含的信息的正確性。就是判斷這個信息究竟是不是微信發的

　　　　2）return_code和result_code都是SUCCESS的話，處理商戶本身的業務邏輯。就是訂單的支付狀態啊等一些信息。

　　　　3）告訴微信，我收到你的返回值了。不用在發了。

話很少說，直接貼代碼！

public String return_data(HttpServletRequest request, HttpServletResponse response) throws Exception {
        logger.info("微信支付請求回調了");
        String resXml = "";
        Map<String, String> backxml = new HashMap<String, String>();
        InputStream inStream;
        try {
            inStream = request.getInputStream();
            ByteArrayOutputStream outSteam = new ByteArrayOutputStream();
            byte[] buffer = new byte[1024];
            int len = 0;
            while ((len = inStream.read(buffer)) != -1) {
                outSteam.write(buffer, 0, len);
            }
            outSteam.close();
            inStream.close();
            String result = new String(outSteam.toByteArray(), "utf-8");// 獲取微信調用咱們notify_url的返回信息
            Map<String, String> map = WXPayUtil.xmlToMap(result);
            if (map.get("result_code").toString().equalsIgnoreCase("SUCCESS")) {
                if (WXPayUtil.isSignatureValid(map, PayConfigUtil.API_KEY)) {
                    logger.info("微信支付-簽名驗證成功");
//                    backxml.put("return_code", "SUCCESS");
//                    backxml.put("return_msg", "OK");
//                    String toXml = WXPayUtil.mapToXml(backxml);
//                    response.getWriter().write(toXml);
                    resXml = "<xml>" + "<return_code><![CDATA[SUCCESS]]></return_code>"
                            + "<return_msg><![CDATA[OK]]></return_msg>" + "</xml> ";
                    //業務處理開始
                   
                    //業務處理結束
                }
                BufferedOutputStream out = new BufferedOutputStream(response.getOutputStream());
                out.write(resXml.getBytes());
                out.flush();
                out.close();
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
        return resXml;
    }

還記得，3、商戶server調用統一下單接口請求訂單中attach參數麼，這裏用來帶業務數據很方便

補充工具類代碼

package com.qicheshetuan.backend.util.wxPay;

import com.qicheshetuan.backend.util.wxPay.WXPayConstants.SignType;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.w3c.dom.Node;
import org.w3c.dom.NodeList;

import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.transform.OutputKeys;
import javax.xml.transform.Transformer;
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.dom.DOMSource;
import javax.xml.transform.stream.StreamResult;
import java.io.ByteArrayInputStream;
import java.io.InputStream;
import java.io.StringWriter;
import java.security.MessageDigest;
import java.util.*;


public class WXPayUtil {

    /**
     * @Author SongZS
     * @Date 2017/6/30 14:57
     *
     * XML格式字符串轉換爲Map
     *
     * @param strXML XML字符串
     * @return XML數據轉換後的Map
     * @throws Exception
     */
    public static Map<String, String> xmlToMap(String strXML) throws Exception {
        try {
            Map<String, String> data = new HashMap<String, String>();
            DocumentBuilderFactory documentBuilderFactory = DocumentBuilderFactory.newInstance();
            DocumentBuilder documentBuilder = documentBuilderFactory.newDocumentBuilder();
            InputStream stream = new ByteArrayInputStream(strXML.getBytes("UTF-8"));
            org.w3c.dom.Document doc = documentBuilder.parse(stream);
            doc.getDocumentElement().normalize();
            NodeList nodeList = doc.getDocumentElement().getChildNodes();
            for (int idx = 0; idx < nodeList.getLength(); ++idx) {
                Node node = nodeList.item(idx);
                if (node.getNodeType() == Node.ELEMENT_NODE) {
                    org.w3c.dom.Element element = (org.w3c.dom.Element) node;
                    data.put(element.getNodeName(), element.getTextContent());
                }
            }
            try {
                stream.close();
            } catch (Exception ex) {
                // do nothing
            }
            return data;
        } catch (Exception ex) {
            WXPayUtil.getLogger().warn("Invalid XML, can not convert to map. Error message: {}. XML content: {}", ex.getMessage(), strXML);
            throw ex;
        }

    }

    /**
     * @Author SongZS
     * @Date 2017/6/30 14:57
     *
     * 將Map轉換爲XML格式的字符串
     *
     * @param data Map類型數據
     * @return XML格式的字符串
     * @throws Exception
     */
    public static String mapToXml(Map<String, String> data) throws Exception {
        DocumentBuilderFactory documentBuilderFactory = DocumentBuilderFactory.newInstance();
        DocumentBuilder documentBuilder= documentBuilderFactory.newDocumentBuilder();
        org.w3c.dom.Document document = documentBuilder.newDocument();
        org.w3c.dom.Element root = document.createElement("xml");
        document.appendChild(root);
        for (String key: data.keySet()) {
            String value = data.get(key);
            if (value == null) {
                value = "";
            }
            value = value.trim();
            org.w3c.dom.Element filed = document.createElement(key);
            filed.appendChild(document.createTextNode(value));
            root.appendChild(filed);
        }
        TransformerFactory tf = TransformerFactory.newInstance();
        Transformer transformer = tf.newTransformer();
        DOMSource source = new DOMSource(document);
        transformer.setOutputProperty(OutputKeys.ENCODING, "UTF-8");
        transformer.setOutputProperty(OutputKeys.INDENT, "yes");
        StringWriter writer = new StringWriter();
        StreamResult result = new StreamResult(writer);
        transformer.transform(source, result);
        String output = writer.getBuffer().toString(); //.replaceAll("\n|\r", "");
        try {
            writer.close();
        }
        catch (Exception ex) {
        }
        return output;
    }


    /**
     * @Author SongZS
     * @Date 2017/6/30 14:57
     *
     * 生成帶有 sign 的 XML 格式字符串
     *
     * @param data Map類型數據
     * @param key API密鑰
     * @return 含有sign字段的XML
     */
    public static String generateSignedXml(final Map<String, String> data, String key) throws Exception {
        return generateSignedXml(data, key, SignType.MD5);
    }

    /**
     * @Author SongZS
     * @Date 2017/6/30 14:57
     *
     * 生成帶有 sign 的 XML 格式字符串
     *
     * @param data Map類型數據
     * @param key API密鑰
     * @param signType 簽名類型
     * @return 含有sign字段的XML
     */
    public static String generateSignedXml(final Map<String, String> data, String key, SignType signType) throws Exception {
        String sign = generateSignature(data, key, signType);
        data.put(WXPayConstants.FIELD_SIGN, sign);
        return mapToXml(data);
    }


    /**
     * @Author SongZS
     * @Date 2017/6/30 14:57
     *
     * 判斷簽名是否正確
     *
     * @param xmlStr XML格式數據
     * @param key API密鑰
     * @return 簽名是否正確
     * @throws Exception
     */
    public static boolean isSignatureValid(String xmlStr, String key) throws Exception {
        Map<String, String> data = xmlToMap(xmlStr);
        if (!data.containsKey(WXPayConstants.FIELD_SIGN) ) {
            return false;
        }
        String sign = data.get(WXPayConstants.FIELD_SIGN);
        return generateSignature(data, key).equals(sign);
    }

    /**
     * @Author SongZS
     * @Date 2017/6/30 14:57
     *
     * 判斷簽名是否正確，必須包含sign字段，不然返回false。使用MD5簽名。
     *
     * @param data Map類型數據
     * @param key API密鑰
     * @return 簽名是否正確
     * @throws Exception
     */
    public static boolean isSignatureValid(Map<String, String> data, String key) throws Exception {
        return isSignatureValid(data, key, SignType.MD5);
    }

    /**
     * @Author SongZS
     * @Date 2017/6/30 14:57
     *
     * 判斷簽名是否正確，必須包含sign字段，不然返回false。
     *
     * @param data Map類型數據
     * @param key API密鑰
     * @param signType 簽名方式
     * @return 簽名是否正確
     * @throws Exception
     */
    public static boolean isSignatureValid(Map<String, String> data, String key, SignType signType) throws Exception {
        if (!data.containsKey(WXPayConstants.FIELD_SIGN) ) {
            return false;
        }
        String sign = data.get(WXPayConstants.FIELD_SIGN);
        return generateSignature(data, key, signType).equals(sign);
    }

    /**
     * @Author SongZS
     * @Date 2017/6/30 14:57
     *
     * 生成簽名
     *
     * @param data 待簽名數據
     * @param key API密鑰
     * @return 簽名
     */
    public static String generateSignature(final Map<String, String> data, String key) throws Exception {
        return generateSignature(data, key, SignType.MD5);
    }

    /**
     * @Author SongZS
     * @Date 2017/6/30 14:57
     *
     * 生成簽名. 注意，若含有sign_type字段，必須和signType參數保持一致。
     *
     * @param data 待簽名數據
     * @param key API密鑰
     * @param signType 簽名方式
     * @return 簽名
     */
    public static String generateSignature(final Map<String, String> data, String key, SignType signType) throws Exception {
        Set<String> keySet = data.keySet();
        String[] keyArray = keySet.toArray(new String[keySet.size()]);
        Arrays.sort(keyArray);
        StringBuilder sb = new StringBuilder();
        for (String k : keyArray) {
            if (k.equals(WXPayConstants.FIELD_SIGN)) {
                continue;
            }
            if (data.get(k).trim().length() > 0) // 參數值爲空，則不參與簽名
                sb.append(k).append("=").append(data.get(k).trim()).append("&");
        }
        sb.append("key=").append(key);
        if (SignType.MD5.equals(signType)) {
            return MD5(sb.toString()).toUpperCase();
        }
        else if (SignType.HMACSHA256.equals(signType)) {
            return HMACSHA256(sb.toString(), key);
        }
        else {
            throw new Exception(String.format("Invalid sign_type: %s", signType));
        }
    }


    /**
     * @Author SongZS
     * @Date 2017/6/30 14:57
     *
     * 獲取隨機字符串 Nonce Str
     *
     * @return String 隨機字符串
     */
    public static String generateNonceStr() {
        return UUID.randomUUID().toString().replaceAll("-", "").substring(0, 32);
    }


    /**
     * @Author SongZS
     * @Date 2017/6/30 14:57
     *
     * 生成 MD5
     *
     * @param data 待處理數據
     * @return MD5結果
     */
    public static String MD5(String data) throws Exception {
        MessageDigest md = MessageDigest.getInstance("MD5");
        byte[] array = md.digest(data.getBytes("UTF-8"));
        StringBuilder sb = new StringBuilder();
        for (byte item : array) {
            sb.append(Integer.toHexString((item & 0xFF) | 0x100).substring(1, 3));
        }
        return sb.toString().toUpperCase();
    }

    /**
     * @Author SongZS
     * @Date 2017/6/30 14:57
     *
     * 生成 HMACSHA256
     * @param data 待處理數據
     * @param key 密鑰
     * @return 加密結果
     * @throws Exception
     */
    public static String HMACSHA256(String data, String key) throws Exception {
        Mac sha256_HMAC = Mac.getInstance("HmacSHA256");
        SecretKeySpec secret_key = new SecretKeySpec(key.getBytes("UTF-8"), "HmacSHA256");
        sha256_HMAC.init(secret_key);
        byte[] array = sha256_HMAC.doFinal(data.getBytes("UTF-8"));
        StringBuilder sb = new StringBuilder();
        for (byte item : array) {
            sb.append(Integer.toHexString((item & 0xFF) | 0x100).substring(1, 3));
        }
        return sb.toString().toUpperCase();
    }

    /**
     * @Author SongZS
     * @Date 2017/6/30 14:57
     *
     * 日誌
     * @return
     */
    public static Logger getLogger() {
        Logger logger = LoggerFactory.getLogger("wxpay java sdk");
        return logger;
    }

    /**
     * @Author SongZS
     * @Date 2017/6/30 14:57
     *
     * 獲取當前時間戳，單位秒
     * @return
     */
    public static long getCurrentTimestamp() {
        return System.currentTimeMillis()/1000;
    }

    /**
     * @Author SongZS
     * @Date 2017/6/30 14:57
     *
     * 獲取當前時間戳，單位毫秒
     * @return
     */
    public static long getCurrentTimestampMs() {
        return System.currentTimeMillis();
    }

    /**
     * @Author SongZS
     * @Date 2017/6/30 14:57
     *
     * 生成 uuid， 即用來標識一筆單，也用作 nonce_str
     * @return
     */
    public static String generateUUID() {
        return UUID.randomUUID().toString().replaceAll("-", "").substring(0, 32);
    }

}
------------------------------------------------------------------------------

package com.qicheshetuan.backend.util.wxPay;

/**
 * 常量
 */
public class WXPayConstants {

    public enum SignType {
        MD5, HMACSHA256
    }

    public static final String DOMAIN_API = "api.mch.weixin.qq.com";
    public static final String DOMAIN_API2 = "api2.mch.weixin.qq.com";
    public static final String DOMAIN_APIHK = "apihk.mch.weixin.qq.com";
    public static final String DOMAIN_APIUS = "apius.mch.weixin.qq.com";


    public static final String FAIL     = "FAIL";
    public static final String SUCCESS  = "SUCCESS";
    public static final String HMACSHA256 = "HMAC-SHA256";
    public static final String MD5 = "MD5";

    public static final String FIELD_SIGN = "sign";
    public static final String FIELD_SIGN_TYPE = "sign_type";

    public static final String MICROPAY_URL_SUFFIX     = "/pay/micropay";
    public static final String UNIFIEDORDER_URL_SUFFIX = "/pay/unifiedorder";
    public static final String ORDERQUERY_URL_SUFFIX   = "/pay/orderquery";
    public static final String REVERSE_URL_SUFFIX      = "/secapi/pay/reverse";
    public static final String CLOSEORDER_URL_SUFFIX   = "/pay/closeorder";
    public static final String REFUND_URL_SUFFIX       = "/secapi/pay/refund";
    public static final String REFUNDQUERY_URL_SUFFIX  = "/pay/refundquery";
    public static final String DOWNLOADBILL_URL_SUFFIX = "/pay/downloadbill";
    public static final String REPORT_URL_SUFFIX       = "/payitil/report";
    public static final String SHORTURL_URL_SUFFIX     = "/tools/shorturl";
    public static final String AUTHCODETOOPENID_URL_SUFFIX = "/tools/authcodetoopenid";

    // sandbox
    public static final String SANDBOX_MICROPAY_URL_SUFFIX     = "/sandboxnew/pay/micropay";
    public static final String SANDBOX_UNIFIEDORDER_URL_SUFFIX = "/sandboxnew/pay/unifiedorder";
    public static final String SANDBOX_ORDERQUERY_URL_SUFFIX   = "/sandboxnew/pay/orderquery";
    public static final String SANDBOX_REVERSE_URL_SUFFIX      = "/sandboxnew/secapi/pay/reverse";
    public static final String SANDBOX_CLOSEORDER_URL_SUFFIX   = "/sandboxnew/pay/closeorder";
    public static final String SANDBOX_REFUND_URL_SUFFIX       = "/sandboxnew/secapi/pay/refund";
    public static final String SANDBOX_REFUNDQUERY_URL_SUFFIX  = "/sandboxnew/pay/refundquery";
    public static final String SANDBOX_DOWNLOADBILL_URL_SUFFIX = "/sandboxnew/pay/downloadbill";
    public static final String SANDBOX_REPORT_URL_SUFFIX       = "/sandboxnew/payitil/report";
    public static final String SANDBOX_SHORTURL_URL_SUFFIX     = "/sandboxnew/tools/shorturl";
    public static final String SANDBOX_AUTHCODETOOPENID_URL_SUFFIX = "/sandboxnew/tools/authcodetoopenid";

}