Java后端如何對接微信支付

# Java后端如何對接微信支付

## 目錄
1. [微信支付概述](#微信支付概述)
2. [開發前準備](#開發前準備)
3. [支付流程詳解](#支付流程詳解)
4. [Java SDK集成](#java-sdk集成)
5. [Native支付實現](#native支付實現)
6. [JSAPI支付實現](#jsapi支付實現)
7. [H5支付實現](#h5支付實現)
8. [小程序支付實現](#小程序支付實現)
9. [支付回調處理](#支付回調處理)
10. [訂單查詢與退款](#訂單查詢與退款)
11. [賬單下載](#賬單下載)
12. [安全與風控](#安全與風控)
13. [常見問題排查](#常見問題排查)
14. [最佳實踐](#最佳實踐)
15. [總結](#總結)

---

## 微信支付概述
（約1500字）
- 微信支付產品矩陣介紹
- 各支付場景適用性分析
- 微信支付V2/V3接口差異
- 資金結算流程說明
- 手續費與結算周期

## 開發前準備
（約1800字）
### 1. 商戶平臺配置
```java
// 示例：獲取微信支付證書的代碼片段
public class CertDownloader {
    public static void downloadCert(String mchId, String serialNo) {
        // 實現證書下載邏輯
    }
}

2. API密鑰設置

• APIv2密鑰設置規范
• APIv3密鑰與證書管理
• 敏感信息加密方案

3. 域名配置要求

• 支付域名備案要求
• 跨域問題解決方案
• 本地開發調試配置

支付流程詳解

（約2000字）

sequenceDiagram
    participant Client
    participant Server
    participant WeChatPay
    Client->>Server: 創建訂單請求
    Server->>WeChatPay: 調用統一下單API
    WeChatPay-->>Server: 返回預支付交易標識
    Server-->>Client: 返回支付參數
    Client->>WeChatPay: 發起支付請求
    WeChatPay-->>Client: 返回支付結果
    WeChatPay->>Server: 異步支付通知

Java SDK集成

（約2500字）

1. 官方SDK vs 自研實現

<!-- Maven依賴示例 -->
<dependency>
    <groupId>com.github.wechatpay-apiv3</groupId>
    <artifactId>wechatpay-apache-httpclient</artifactId>
    <version>0.4.7</version>
</dependency>

2. 核心組件封裝

public class WxPayConfig {
    private String appId;
    private String mchId;
    // 其他配置項...
    
    public CloseableHttpClient createHttpClient() throws Exception {
        // 創建帶證書的HTTP客戶端
    }
}

Native支付實現

（約2200字）

1. 下單接口實現

public class NativePaymentService {
    public String createOrder(OrderDTO order) {
        // 構造請求參數
        HttpPost httpPost = new HttpPost("https://api.mch.weixin.qq.com/v3/pay/transactions/native");
        // 執行請求并處理響應
    }
}

2. 二維碼生成方案

• 動態生成二維碼方案
• 訂單狀態輪詢機制
• 支付超時處理邏輯

JSAPI支付實現

（約2000字）

1. 前端調起支付

// 前端調起支付示例
wx.chooseWXPay({
    timestamp: '',
    nonceStr: '',
    package: '',
    signType: '',
    paySign: '',
    success: function(res){}
});

2. 后端簽名實現

public class JsApiSigner {
    public String generateSignature(Map<String, String> params) {
        // 使用HMAC-SHA256算法生成簽名
    }
}

支付回調處理

（約1800字）

1. 回調驗證

@PostMapping("/wxpay/notify")
public String handleNotify(@RequestBody String xmlData) {
    // 驗證簽名
    if (!verifySignature(xmlData)) {
        return "<xml><return_code><![CDATA[FL]]></return_code></xml>";
    }
    // 處理業務邏輯
}

2. 冪等性設計

• 使用Redis實現防重處理
• 數據庫唯一索引方案
• 分布式鎖應用

訂單查詢與退款

（約2000字）

1. 查詢接口實現

public class QueryService {
    public OrderStatus queryOrder(String outTradeNo) {
        // 構造查詢請求
        String url = String.format(
            "https://api.mch.weixin.qq.com/v3/pay/transactions/out-trade-no/%s?mchid=%s",
            outTradeNo, mchId);
        // 發送請求并解析響應
    }
}

2. 退款流程

• 全額/部分退款實現
• 退款狀態同步機制
• 資金退回原理解析

最佳實踐

（約1500字）

1. 性能優化

• HTTP連接池配置
• 異步通知處理方案
• 本地緩存應用

2. 監控方案

// 監控埋點示例
@Aspect
@Component
public class PayMonitorAspect {
    @Around("execution(* com..payment.*.*(..))")
    public Object monitor(ProceedingJoinPoint pjp) throws Throwable {
        long start = System.currentTimeMillis();
        try {
            return pjp.proceed();
        } finally {
            // 記錄指標數據
        }
    }
}

總結

（約800字） - 核心流程回顧 - 版本升級建議 - 擴展學習方向 - 官方資源推薦

注意事項： 1. 實際開發中請妥善保管商戶密鑰 2. 生產環境必須使用HTTPS 3. 定期檢查證書有效期 4. 建議實現自動化對賬機制 “`

這篇文章大綱包含了微信支付對接的核心內容，實際撰寫時可根據需要： 1. 擴展每個章節的代碼示例 2. 增加時序圖和架構圖 3. 補充異常處理場景 4. 添加性能測試數據 5. 完善安全防護方案

如需具體章節的詳細展開，可以告知需要重點講解的部分。