1. 准备与配置
1.1 获取必要的账号信息与环境准备
在开始接入前，确保你拥有微信支付商户号和AppID/商户应用标识，以及设置好的支付回调地址。这些信息是与微信支付跨系统交互的核心标识，直接决定后续接口调用的成功率。本文的核心目标是帮助你理解Java接入微信支付全流程的关键步骤，并给出可直接落地的代码示例。
同时，准备一个测试环境和一个正式环境，以便区分测试数据与实际资金交易。请在微信商户平台中开启所需的交易类型（如APP、小程序、H5等），并记录下接口地址与回调地址的配置情况，确保测试阶段的回调能正确落地。上述信息是实现从配置到支付回调的完整步骤的基础。
1.2 下载、管理和使用 API 证书
某些微信支付接口（如退款、企业付款、下载对账单等）需要使用API证书来进行双向认证。因此，务必在微信商户平台获取并妥善保存证书文件，例如apiclient_cert.pem和apiclient_key.pem，以及对应的证书密码。正确的证书管理可以提升请求的安全性与稳定性。
证书路径与加载方式直接影响后续的HTTPS请求，建议在应用启动阶段就完成证书加载与SSL上下文配置，以确保统一下单等接口在正式交易时能够顺利走证书路径。下面的示例演示了证书加载的要点，便于你在实际工程中对接证书签名与加密。
// 伪代码：加载PKCS12格式证书并创建HTTP客户端
KeyStore ks = KeyStore.getInstance("PKCS12");
try (FileInputStream fis = new FileInputStream("path/to/apiclient_cert.p12")) {ks.load(fis, "证书密码".toCharArray());
}
SSLContext sslContext = SSLContexts.custom().loadKeyMaterial(ks, "证书密码".toCharArray()).build();
// 使用该 sslContext 构造 HttpClient，后续对微信支付接口发起请求时启用双向认证
1.3 配置回调地址与域名白名单
回调地址（notify_url）是在你服务器端接收微信支付异步通知的接口地址，务必使用公网可访问的域名并在微信商户平台进行绑定。回调接口的稳定性决定了对账与订单状态更新的可靠性，因此需要确保对外网络正常、证书存在且能被微信服务器访问。
此外，建议在服务器端实现域名与IP的访问控制，以及对回调请求的基础校验（如请求来源、IP白名单、时序校验等），以提升系统的鲁棒性。以上配置是实现完整支付流程中不可或缺的一环。
2. Java 后端环境搭建与依赖
2.1 引入依赖（Maven/Gradle）
为了实现与微信支付的对接，需要引入一些通用的工具库用于HTTP请求、XML处理、以及签名计算。常用的依赖包括HttpClient、XML 处理库和签名工具库。正确的依赖版本能够提升稳定性和兼容性。
下面给出一个简化的依赖清单示例，便于你在项目中快速落地：在 Maven 中添加 httpclient、commons-codec、jackson-dataformat-xml 等依赖；在 Gradle 中对应转换为实现。确保构建工具能够正常下载并缓存依赖。
org.apache.httpcomponents httpclient 4.5.13 commons-codec commons-codec 1.15 com.fasterxml.jackson.dataformat jackson-dataformat-xml 2.12.5 2.2 签名算法与请求参数规范
微信支付的统一下单等接口需要对请求参数进行签名，常见的做法是对参数按键名排序后拼接成 query 字符串，再拼接商户密钥并经过 MD5（或 HMAC-SHA256）签名，最后将结果转换为大写。正确的签名是接口成功的关键之一。
签名的核心要点包括避免将 sign 字段参与计算、对空值进行过滤、参数排序的一致性，以及密钥使用的严格保密。实现一个稳定的签名方法，是后端对接微信支付的基础能力。
public static String createSign(Map<String, String> params, String key) {// 1) 按字典序排序 keyList<String> keys = new ArrayList<>(params.keySet());Collections.sort(keys);// 2) 拼接为 "k1=v1&k2=v2&..."StringBuilder sb = new StringBuilder();for (String k : keys) {String v = params.get(k);if (v != null && v.length() > 0 && !\"sign\".equals(k)) {if (sb.length() > 0) sb.append('&');sb.append(k).append('=').append(v);}}// 3) 拼接 keysb.append(\"&key=\").append(key);// 4) MD5 并转大写return org.apache.commons.codec.digest.DigestUtils.md5Hex(sb.toString()).toUpperCase();
}
2.3 构建请求与解析响应的基础工具
为了在Java后端中简化对微信支付接口的调用，可以封装一些基础工具，例如将 XML 请求和响应映射为对象、提供统一的错误码处理、以及异常抛出逻辑。良好的封装能降低后续维护成本，并让你更专注于业务逻辑。
在实际项目中，通常会实现一个极简的 XML 序列化/解析工具，以支持统一下单、查询、退款等操作的参数转换。下列示例展示了如何把参数集合转换成微信接口需要的 XML，并从响应中提取关键字段。
public static String mapToXml(Map<String, String> map) {StringBuilder sb = new StringBuilder();sb.append<?xml version=\"1.0\" encoding=\"UTF-8\"?>
<xml>
";for (Map.Entry<String, String> e : map.entrySet()) {sb.append('<').append(e.getKey()).append('>').append(e.getValue()).append('</').append(e.getKey()).append('>');}sb.append(\"</xml>\");return sb.toString();
}
3. 统一下单接口与前端对接
3.1 构造统一下单请求参数并生成签名
统一下单接口的核心参数包括 appid、mch_id、nonce_str、body、out_trade_no、total_fee、spbill_create_ip、notify_url、以及 trade_type 等。将这些参数组合后生成签名，作为请求的一部分发送给微信服务器。
请确保不同字段的含义与你应用的业务逻辑保持一致，特别是 out_trade_no 的幂等性，以及 trade_type（如 APP、JSAPI、NATIVE、H5 等）的正确选型。
Map<String, String> params = new HashMap<>();
params.put("appid", appId);
params.put("mch_id", mchId);
params.put("nonce_str", UUID.randomUUID().toString().replace(\"-\", \"\"));
params.put("body", \"商品描述\");
params.put(\"out_trade_no\", orderNo);
params.put(\"total_fee\", String.valueOf(totalFee)); // 单位为分
params.put(\"spbill_create_ip\", clientIp);
params.put(\"notify_url\", notifyUrl);
params.put(\"trade_type\", \"APP\");
String sign = createSign(params, apiKey);
params.put(\"sign\", sign);String xmlRequest = mapToXml(params);
3.2 发送请求、接收响应并解析
通过带证书的 HTTPS 客户端将 XML 请求发送到微信的统一下单接口地址 https://api.mch.weixin.qq.com/pay/unifiedorder，并解析返回的 XML。核心字段通常包含 prepay_id，后续前端需要基于该值生成支付参数。
对返回结果进行基本校验，确保 return_code 为 SUCCESS，且 result_code 为 SUCCESS，再提取 prepay_id，以完成后续的前端参数构建。
public Map<String, String> parseUnifiedOrderResponse(String xml) {Map<String, String> resp = new HashMap<>();// 简化示例：使用简单解析提取字段resp.put(\"return_code\", extractTag(xml, \"return_code\")); resp.put(\"result_code\", extractTag(xml, \"result_code\")); resp.put(\"prepay_id\", extractTag(xml, \"prepay_id\")); return resp;
}
3.3 前端参数拼装与前端调起支付
拿到 prepay_id 之后，需要在前端组装支付参数（具体字段视支付类型而定），常见的字段包括 timeStamp、nonceStr、package、signType、以及最终的 paySign。前端页面或应用可以据此调起微信支付界面。
在后端你需要提供一个签名良好、可供前端直接消费的参数包，确保前端在调用微信支付 SDK 时能够正确完成支付流程。
public Map<String, String> buildPayParams(String appId, String prepayId, String mchKey) {Map<String, String> payParams = new HashMap<>();payParams.put("appId", appId);long timeStamp = Instant.now().getEpochSecond();payParams.put("timeStamp", String.valueOf(timeStamp));payParams.put("nonceStr", UUID.randomUUID().toString().replace(\"-\", \"\"));payParams.put("package", \"prepay_id=\" + prepayId);payParams.put("signType", \"MD5\");payParams.put(\"paySign\", createSign(payParams, mchKey));return payParams;
}
4. 支付回调处理与验签
4.1 回调地址的路由与请求初步处理
支付回调（notify）是微信异步告知订单状态的关键入口。你需要在服务器上暴露一个公网可访问的回调路由，并在接收到通知后进行初步的分发与幂等性控制。回调信息通常以 XML 形式返回，包含如 return_code、result_code、bank_type、cash_fee 等字段。
务必在回调处理阶段保持幂等性，即同一笔订单重复通知时应仅处理一次；同时对回调中的签名进行严格校验，以防止伪造请求影响业务数据。
4.2 回调验签与业务处理
回调验签的核心是在提取微信发送的参数后，移除 sign 字段，再用相同的签名算法对剩余参数进行重新签名，比较两个签名是否一致。若验签通过，再执行你业务的后续逻辑（如更新订单状态、触发发货等）。
验签通过后，应返回微信一个固定的 XML 响应，表示服务器已正确接收并处理通知，以防止微信重传并触发重复处理。示例如下的应答格式为标准做法：return_code 与 return_msg。
public boolean verifyNotify(Map<String, String> data, String key) {String sign = data.remove(\"sign\");String calc = createSign(data, key);return sign != null && sign.equalsIgnoreCase(calc);
}
<xml><return_code><![CDATA[SUCCESS]]></return_code><return_msg><![CDATA[OK]]></return_msg>
</xml>
4.3 将回调结果落地并处理后续业务
在完成验签后，依据业务需求更新订单状态、库存、发货等流程，确保交易逻辑的一致性与可追溯性。对于资金流操作，建议写入对账系统以实现对账清晰、可审计的资金轨迹。
最后一步是向微信返回一个确认应答，确保微信端知道你的服务器已正确处理通知。该应答通常是一段固定格式的 XML，包含 SUCCESS 的返回码，以便微信继续进行下一步通知周期。
