Java实现对接微信支付功能接口详解（三）

本系列文章简介：

        微信支付是一种在线支付解决方案，允许用户通过微信内的支付功能进行付款。它提供了多种支付方式，包括扫码支付、公众号支付、小程序支付等。在Java应用程序中实现微信支付功能，可以为用户提供方便快捷的支付体验。本文详细讲解了如何从0到1实现对接微信支付功能，包括注册开发者账号、导入微信支付的Java SDK、创建配置类、实现支付服务类、与微信支付服务器进行交互等详细步骤，并配有图文解析，欢迎大家订阅《支付系列开发攻略》专栏，一起学习，一起涨分！

目录

一、引言

二、申请退款接口

三、查询退款接口

四、下载对账单接口

五、结语

---

一、引言

  接上篇文章《Java实现对接微信支付功能接口详解（二）》详解的进度，我们继续来看微信支付的其他功能接口

二、申请退款接口

实现微信支付的申请退款接口需要以下步骤：

1. 引入微信支付SDK：首先需要将微信支付SDK导入到项目中。可以通过在Maven或Gradle中添加相关依赖项来实现。

2. 创建退款请求对象：根据微信支付的文档，创建一个退款请求对象，包含必要的参数信息，例如订单号、退款金额、退款原因等。

3. 生成签名：使用微信支付提供的工具类，对退款请求对象中的参数进行签名。

4. 发送退款请求：调用微信支付SDK中的接口，发送退款请求，并将签名后的退款请求对象作为参数传递。

5. 处理退款结果：获取退款结果，处理成功或失败的情况，并做相应的业务处理。

下边给大家展示一个详细的java示例：

1、要实现申请退款接口，首先需要导入微信支付SDK。可以在pom.xml文件中添加以下依赖：

    com.github.wxpay
    wxpay-sdk
    3.0.0

2、然后，创建一个退款请求类，例如RefundRequest：

import com.github.wxpay.sdk.WXPay;
import com.github.wxpay.sdk.WXPayConfig;
import com.github.wxpay.sdk.WXPayConstants;
import com.github.wxpay.sdk.WXPayUtil;

import java.util.HashMap;
import java.util.Map;

public class RefundRequest {
    private WXPay wxPay;

    public RefundRequest(WXPayConfig wxPayConfig) {
        wxPay = new WXPay(wxPayConfig);
    }

    public String refund(String orderNumber, int totalFee, int refundFee) throws Exception {
        // 构建请求参数
        Map data = new HashMap<>();
        data.put("out_trade_no", orderNumber);
        data.put("total_fee", String.valueOf(totalFee));
        data.put("refund_fee", String.valueOf(refundFee));
        data.put("refund_desc", "申请退款");

        // 发起退款请求
        Map result = wxPay.refund(data);

        // 处理返回结果
        if (WXPayUtil.isSuccess(result)) {
            // 退款成功
            return result.get("refund_id");
        } else {
            // 退款失败
            throw new Exception("退款失败：" + result.get("return_msg"));
        }
    }
}

上述代码中，RefundRequest类的构造方法接受一个WXPayConfig对象作为参数，用于初始化WXPay对象。refund()方法接受订单号、总金额和退款金额作为参数，然后构建退款请求参数，调用WXPay的refund()方法发送退款请求。最后根据返回结果判断退款是否成功。

3、接下来，创建一个实现WXPayConfig接口的配置类，例如WXPayConfigImpl：

import com.github.wxpay.sdk.WXPayConfig;

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

public class WXPayConfigImpl implements WXPayConfig {
    private byte[] certData;

    public WXPayConfigImpl() throws Exception {
        String certPath = "path_to_your_cert_file";  // 替换为实际的证书文件路径
        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 "your_app_id";  // 替换为实际的AppID
    }

    @Override
    public String getMchID() {
        return "your_mch_id";  // 替换为实际的商户号
    }

    @Override
    public String getKey() {
        return "your_key";  // 替换为实际的API密钥
    }

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

    @Override
    public int getHttpConnectTimeoutMs() {
        return 8000;  // 设置连接超时时间（单位：毫秒）
    }

    @Override
    public int getHttpReadTimeoutMs() {
        return 10000;  // 设置读取超时时间（单位：毫秒）
    }
}

上述代码中，WXPayConfigImpl类实现了WXPayConfig接口，并重写了其中的方法。其中getAppID()、getMchID()、getKey()方法需要返回实际的AppID、商户号和API密钥。getCertStream()方法需要返回实际的证书文件的输入流。

4、最后，可以在程序的入口中调用退款接口：

public class Main {
    public static void main(String[] args) {
        try {
            // 创建WXPayConfigImpl对象
            WXPayConfigImpl wxPayConfig = new WXPayConfigImpl();

            // 创建RefundRequest对象
            RefundRequest refundRequest = new RefundRequest(wxPayConfig);

            // 调用退款接口
            String orderNumber = "your_order_number";  // 替换为实际的订单号
            int totalFee = 1000;  // 替换为实际的总金额（单位：分）
            int refundFee = 500;  // 替换为实际的退款金额（单位：分）
            String refundId = refundRequest.refund(orderNumber, totalFee, refundFee);

            System.out.println("退款成功，退款ID：" + refundId);
        } catch (Exception e) {
            e.printStackTrace();
            System.out.println("退款失败：" + e.getMessage());
        }
    }
}

上述代码中，创建一个WXPayConfigImpl对象用于初始化RefundRequest对象，然后调用退款接口进行退款。最后根据退款结果打印相应的信息。

请确保替换示例代码中的占位符（如your_app_id、your_mch_id、your_key、your_cert_file_path和your_order_number）为实际的参数。另外，还需根据实际需求进行异常处理、日志记录等操作。

三、查询退款接口

要实现查询退款接口，你需要按照以下步骤进行操作：

1. 引入微信支付Java SDK： 首先，你需要在你的Java项目中引入微信支付SDK版本3，你可以从微信支付开发者平台下载jar包，然后将其添加到你的项目依赖中。

2. 初始化微信支付配置： 在你的Java代码中，你需要初始化微信支付配置。具体的配置包括APPID、商户号、API密钥等信息。你可以在微信支付开发者平台中获取这些信息。

3. 创建退款查询请求对象： 接下来，你需要创建一个退款查询请求对象。该对象用于指定查询退款的参数，比如商户订单号、微信订单号等。具体的参数可以参考微信支付文档。

4. 调用查询退款接口： 通过微信支付SDK提供的方法，你可以发送查询退款请求到微信支付服务器。具体的方法是通过RefundApi类下的refundQuery方法实现。你需要将退款查询请求对象作为参数传递给该方法。

5. 处理查询结果： 查询退款接口会返回一个退款查询结果对象，你可以通过该对象获取退款信息，比如退款状态、退款金额等。你可以根据查询结果做进一步的处理。

下面是一个简单的Java示例代码，展示了如何实现查询退款接口：

import com.github.wxpay.sdk.WXPay;
import com.github.wxpay.sdk.WXPayConfigImpl;
import com.github.wxpay.sdk.WXPayConstants;
import com.github.wxpay.sdk.WXPayUtil;
import com.github.wxpay.sdk.WXPayEntry;
import com.github.wxpay.sdk.WXPayException;

import java.util.HashMap;
import java.util.Map;

public class RefundQueryExample {

    public static void main(String[] args) throws Exception {
        // 初始化微信支付配置
        WXPayConfigImpl config = new WXPayConfigImpl();
        WXPay wxPay = new WXPay(config);

        // 创建退款查询请求对象
        Map data = new HashMap();
        data.put("out_refund_no", "your_out_refund_no");  // 商户退款单号
        data.put("refund_id", "your_refund_id");  // 微信退款单号

        try {
            // 调用查询退款接口
            Map result = wxPay.refundQuery(data);

            // 处理查询结果
            if (result.get("return_code").equals(WXPayConstants.SUCCESS) &&
                    result.get("result_code").equals(WXPayConstants.SUCCESS)) {
                // 查询成功
                // 处理退款查询结果
                // TODO
            } else {
                // 查询失败
                // 处理查询失败结果
                // TODO
            }
        } catch (WXPayException e) {
            // 查询异常
            // 处理异常
            // TODO
        }
    }
}

注意：上述示例代码仅展示了查询退款接口的基本流程，你需要根据自己的业务需求对结果进行处理。

四、下载对账单接口

要使用Java基于微信支付SDK V3实现下载对账单接口，可以按照以下流程进行操作：

1. 引入微信支付SDK V3的依赖。 首先在项目的构建文件中添加对微信支付SDK V3的依赖。具体的依赖配置可以参考微信支付官方文档。

2. 创建微信支付的配置类。 创建一个类来保存微信支付相关的配置信息，包括商户号、API密钥等。

public class WeChatPayConfig {
    public static final String MCH_ID = "YOUR_MCH_ID"; // 商户号
    public static final String API_KEY = "YOUR_API_KEY"; // API密钥
}

        3. 实现下载对账单接口。

import com.github.wxpay.sdk.WXPay;
import com.github.wxpay.sdk.WXPayConfig;
import com.github.wxpay.sdk.WXPayUtil;

import java.util.HashMap;
import java.util.Map;

public class DownloadBill {
    public static void main(String[] args) throws Exception {
        WXPayConfig config = new WeChatPayConfig();
        WXPay wxPay = new WXPay(config);

        // 构建请求参数
        Map reqData = new HashMap<>();
        reqData.put("appid", "YOUR_APPID"); // APPID
        reqData.put("mch_id", WeChatPayConfig.MCH_ID); // 商户号
        reqData.put("nonce_str", WXPayUtil.generateNonceStr()); // 随机字符串
        reqData.put("bill_date", "20221117"); // 对账单日期，格式为yyyyMMdd
        reqData.put("bill_type", "ALL"); // 对账单类型，ALL表示返回当日所有订单信息

        // 发送请求并得到响应
        Map respData = wxPay.downloadBill(reqData);

        // 解析响应
        if (respData.get("return_code").equals("SUCCESS")) {
            if (respData.get("result_code").equals("SUCCESS")) {
                // 下载对账单成功
                System.out.println(respData.get("data")); // 对账单数据
            } else {
                // 下载对账单失败
                System.out.println(respData.get("err_code")); // 错误代码
                System.out.println(respData.get("err_code_des")); // 错误描述
            }
        } else {
            // 下载对账单失败
            System.out.println(respData.get("return_msg")); // 错误信息
        }
    }
}

在上述代码中，首先创建一个WXPayConfig对象来传递微信支付的配置信息，并且使用该对象创建一个WXPay对象。然后，构建请求参数reqData，其中包括APPID、商户号、随机字符串、对账单日期和对账单类型。接下来，通过调用wxPay.downloadBill(reqData)方法发送请求，并得到响应结果respData。最后，根据响应的返回码和结果码进行相应的处理。

注意，上述代码中的YOUR_MCH_ID、YOUR_API_KEY和YOUR_APPID需要根据实际情况替换为相应的值。

五、结语

        本文至此，已接近尾声！在下篇文章中，会为大家继续讲解对接微信支付的其他功能接口，请大家订阅本专栏《支付系列开发攻略》，紧跟脚步，稳扎稳打学习。希望此文能够对大家有所启发和帮助。同时，感谢大家的耐心阅读和对本文档的信任。在未来的技术学习和工作中，期待与各位大佬共同进步，共同探索新的技术前沿。最后，再次感谢各位的支持和关注！