微信支付-java實現微信支付-後端篇

微信支付系列文章

java demo: 下載地址文章底部

技術棧

Spring boot
java
XML (微信在http協議中數據傳輸方案)
MD5 簽名

微信支付術語

openid (OpenID是公衆號一對一對應用戶身份的標識)
app_id (公衆號id，登錄微信公衆號–開發–基本配置中獲得；)
key (收款商戶後臺進行配置，登錄微信商戶平臺–賬戶中心–API安全-設置祕鑰，設置32位key值；)
mch_id (收款商家商戶號；)
certPath (API證書, 登錄微信商戶平臺–賬戶中心-API安全-下載證書)

後端流程

服務端需要的核心操作, 總共分爲以下幾步:

統一下單
前端調起微信支付必要參數 (需加密)
訂單結果主動通知 (回調接口)
查詢訂單結果
結束訂單支付接口（關閉訂單，支付訂單關閉）

代碼

微信總共支持多種語言的sdk, 在官網可以下載例子, java程序也可以引入微信支付的sdk包, 但是github上的sdk已經很久沒有更新了, 最好的選擇, 也是我的選擇, 在官網上下載sdk項目, 將其中所有java類copy到自己的項目中.

官網sdk下載目錄
鏈接: 商戶平臺首頁

####　根據微信sdk生成配置類 WXPayConfig
創建IWxPayConfig.class, 繼承sdk WXPayConfig.class, 實現sdk中部分抽象方法, 讀取本地證書, 加載到配置類中.
package core.com.chidori.wxpay;

import core.com.wxpay.IWXPayDomain;
import core.com.wxpay.WXPayConfig;
import core.com.wxpay.WXPayConstants;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Service;

import java.io.ByteArrayInputStream;
import java.io.File;
import java.io.FileInputStream;
import java.io.InputStream;

@Service
public class IWxPayConfig extends WXPayConfig { // 繼承sdk WXPayConfig 實現sdk中部分抽象方法

    private byte[] certData;

    @Value("${vendor.wx.config.app_id}")
    private String app_id;

    @Value("${vendor.wx.pay.key}")
    private String wx_pay_key;

    @Value("${vendor.wx.pay.mch_id}")
    private String wx_pay_mch_id;

    public IWxPayConfig() throws Exception { // 構造方法讀取證書, 通過getCertStream 可以使sdk獲取到證書
        String certPath = "/data/config/chidori/apiclient_cert.p12";
        File file = new File(certPath);
        InputStream certStream = new FileInputStream(file);
        this.certData = new byte[(int) file.length()];
        certStream.read(this.certData);
        certStream.close();
    }

    @Override
    public String getAppID() {
        return app_id;
    }

    @Override
    public String getMchID() {
        return wx_pay_mch_id;
    }

    @Override
    public String getKey() {
        return wx_pay_key;
    }

    @Override
    public InputStream getCertStream() {
        return new ByteArrayInputStream(this.certData);
    }

    @Override
    public IWXPayDomain getWXPayDomain() { // 這個方法需要這樣實現, 否則無法正常初始化WXPay
        IWXPayDomain iwxPayDomain = new IWXPayDomain() {
            @Override
            public void report(String domain, long elapsedTimeMillis, Exception ex) {

            }
            @Override
            public DomainInfo getDomain(WXPayConfig config) {
                return new IWXPayDomain.DomainInfo(WXPayConstants.DOMAIN_API, true);
            }
        };
        return iwxPayDomain;
    }
}

發起統一下單 AND 前端調起微信支付必要參數

// 發起微信支付
WXPay wxpay = null;
Map<String, String> result = new HashMap<>();
try {
    // ******************************************
    //
    //  統一下單
    //
    // ******************************************
    wxpay = new WXPay(iWxPayConfig); // *** 注入自己實現的微信配置類, 創建WXPay核心類, WXPay 包括統一下單接口

    Map<String, String> data = new HashMap<String, String>();
    data.put("body", "訂單詳情");
    data.put("out_trade_no", transOrder.getGlobalOrderId()); // 訂單唯一編號, 不允許重複
    data.put("total_fee", String.valueOf(transOrder.getOrderAmount().multiply(new BigDecimal(100)).intValue())); // 訂單金額, 單位分
    data.put("spbill_create_ip", "192.168.31.166"); // 下單ip
    data.put("openid", openId); // 微信公衆號統一標示openid
    data.put("notify_url", "http://wxlj.oopmind.com/payCallback"); // 訂單結果通知, 微信主動回調此接口
    data.put("trade_type", "JSAPI"); // 固定填寫

    logger.info("發起微信支付下單接口, request={}", data);
    Map<String, String> response = wxpay.unifiedOrder(data); // 微信sdk集成方法, 統一下單接口unifiedOrder, 此處請求   MD5加密   加密方式
    logger.info("微信支付下單成功, 返回值 response={}", response);
    String returnCode = response.get("return_code");
    if (!SUCCESS.equals(returnCode)) {
        return null;
    }
    String resultCode = response.get("result_code");
    if (!SUCCESS.equals(resultCode)) {
        return null;
    }
    String prepay_id = response.get("prepay_id");
    if (prepay_id == null) {
        return null;
    }

    // ******************************************
    //
    //  前端調起微信支付必要參數
    //
    // ******************************************
    String packages = "prepay_id=" + prepay_id;
    Map<String, String> wxPayMap = new HashMap<String, String>();
    wxPayMap.put("appId", iWxPayConfig.getAppID());
    wxPayMap.put("timeStamp", String.valueOf(Utility.getCurrentTimeStamp()));
    wxPayMap.put("nonceStr", Utility.generateUUID());
    wxPayMap.put("package", packages);
    wxPayMap.put("signType", "MD5");
    // 加密串中包括 appId timeStamp nonceStr package signType 5個參數, 通過sdk WXPayUtil類加密, 注意, 此處使用  MD5加密  方式
    String sign = WXPayUtil.generateSignature(wxPayMap, iWxPayConfig.getKey());

    // ******************************************
    //
    //  返回給前端調起微信支付的必要參數
    //
    // ******************************************
    result.put("prepay_id", prepay_id);
    result.put("sign", sign);
    result.putAll(wxPayMap);
    return result;
} catch (Exception e) {
}

回調結果處理

核心是支付訂單回調時, 需校驗加密簽名是否匹配, 防止出現模擬成功通知

@RequestMapping(value = "/payCallback", method = RequestMethod.POST)
public String payCallback(HttpServletRequest request, HttpServletResponse response) {
    logger.info("進入微信支付異步通知");
    String resXml="";
    try{
        //
        InputStream is = request.getInputStream();
        //將InputStream轉換成String
        BufferedReader reader = new BufferedReader(new InputStreamReader(is));
        StringBuilder sb = new StringBuilder();
        String line = null;
        try {
            while ((line = reader.readLine()) != null) {
                sb.append(line + "\n");
            }
        } catch (IOException e) {
            e.printStackTrace();
        } finally {
            try {
                is.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
        resXml=sb.toString();
        logger.info("微信支付異步通知請求包: {}", resXml);
        return wxTicketService.payBack(resXml);
    }catch (Exception e){
        logger.error("微信支付回調通知失敗",e);
        String result = "<xml>" + "<return_code><![CDATA[FAIL]]></return_code>" + "<return_msg><![CDATA[報文爲空]]></return_msg>" + "</xml> ";
        return result;
    }
}

@Override
public String payBack(String notifyData) {
    logger.info("payBack() start, notifyData={}", notifyData);
    String xmlBack="";
    Map<String, String> notifyMap = null;
    try {
        WXPay wxpay = new WXPay(iWxPayConfig);

        notifyMap = WXPayUtil.xmlToMap(notifyData);         // 轉換成map
        if (wxpay.isPayResultNotifySignatureValid(notifyMap)) {
            // 簽名正確
            // 進行處理。
            // 注意特殊情況：訂單已經退款，但收到了支付結果成功的通知，不應把商戶側訂單狀態從退款改成支付成功
            String return_code = notifyMap.get("return_code");//狀態
            String out_trade_no = notifyMap.get("out_trade_no");//訂單號

            if (out_trade_no == null) {
                logger.info("微信支付回調失敗訂單號: {}", notifyMap);
                xmlBack = "<xml>" + "<return_code><![CDATA[FAIL]]></return_code>" + "<return_msg><![CDATA[報文爲空]]></return_msg>" + "</xml> ";
                return xmlBack;
            }

            // 業務邏輯處理 ****************************
            logger.info("微信支付回調成功訂單號: {}", notifyMap);
            xmlBack = "<xml>" + "<return_code><![CDATA[SUCCESS]]></return_code>" + "<return_msg><![CDATA[SUCCESS]]></return_msg>" + "</xml> ";
            return xmlBack;
        } else {
            logger.error("微信支付回調通知簽名錯誤");
            xmlBack = "<xml>" + "<return_code><![CDATA[FAIL]]></return_code>" + "<return_msg><![CDATA[報文爲空]]></return_msg>" + "</xml> ";
            return xmlBack;
        }
    } catch (Exception e) {
        logger.error("微信支付回調通知失敗",e);
        xmlBack = "<xml>" + "<return_code><![CDATA[FAIL]]></return_code>" + "<return_msg><![CDATA[報文爲空]]></return_msg>" + "</xml> ";
    }
    return xmlBack;
}

注意點

統一下單的簽名和後續前端拉取微信支付的簽名需要統一, 也就是都採用MD5加密, 如果2者不同, 會導致前端拉取微信支付fail, 這是一個巨大的坑, 因爲這個原因調試了好久, 微信在文檔裏沒有明確標出統一下單的簽名校驗方式需要和前端拉取微信支付的簽名校驗保持一致.
微信sdk裏的源碼需要針對這個問題調整一下, 調整如下:
WXPay類需要修改下加密判斷，在WXPay構造方法中，調整如下

public WXPay(final WXPayConfig config, final String notifyUrl, final boolean autoReport, final boolean useSandbox) throws Exception {
    this.config = config;
    this.notifyUrl = notifyUrl;
    this.autoReport = autoReport;
    this.useSandbox = useSandbox;
    if (useSandbox) {
        this.signType = SignType.MD5; // 沙箱環境
    }
    else {
        this.signType = SignType.MD5;　// 將這裏的加密方式修改爲SignType.MD5, 保持跟前端吊起微信加密方式保持一致
    }
    this.wxPayRequest = new WXPayRequest(config);
}

結束語

做完以後, 微信支付的後端邏輯還是很清晰的, 但是在開發過程中很煎熬, 不清楚每個專業術語在微信哪裏配置, 加密方式亂的很

博客

請移步： https://www.oopmind.com。

Demo

git clone https://github.com/wangjianan1103/pica.git

聯繫方式

如果 Pica_pay 對你有幫助，可以關注作者支持一下，每天會不定時回覆留言(有任何問題都可以留言哦)。

微信公衆號

微信支付-java實現微信支付-後端篇

微信支付系列文章

技術棧

微信支付術語

後端流程

代碼

發起統一下單 AND 前端調起微信支付必要參數

回調結果處理

注意點

結束語

博客

Demo

聯繫方式

預覽圖

PDManer [元數建模]-v4.9.0 發佈：一款簡單好用的數據庫建模平臺

使用neovim打造go ide(支持代碼跳轉, 代碼補全, 實時語法檢查)

sql求連續值問題

cs01 CSS Syntax

挑戰程序設計競賽 2.3章習題 poj 3046 Ant Counting

[MASM拾遺]Offset僞指令

h30 HTML Layout Elements

瞭解顯卡

一款基於C#開發的通訊調試工具（支持Modbus RTU、MQTT調試）

Linux/Golang/glibC系統調用

SSH中action訪問session的方法！

微信支付-java實現微信支付-後端篇

java項目換JDK流程

微信支付-vue 實現微信支付-前端篇

JavaScript HTML 小例子

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結