快捷導(dǎo)航

java對(duì)接微信支付SDK接口簡(jiǎn)單圖文教程

更新時(shí)間：2024年11月01日 10:28:03 作者：子木凝煙

在微信支付接口對(duì)接過(guò)程中,開(kāi)發(fā)者需準(zhǔn)備多項(xiàng)關(guān)鍵參數(shù),如開(kāi)發(fā)者ID（appid）、商戶號(hào)等,并完成相關(guān)注冊(cè)與認(rèn)證流程,文中通過(guò)圖文介紹的非常詳細(xì),需要的朋友可以參考下

1.對(duì)接準(zhǔn)備

需要的參數(shù)包括開(kāi)發(fā)者ID(appid)、商戶號(hào)、商戶api私鑰、商戶證書(shū)序列號(hào)、商戶APIV3密鑰、回調(diào)地址。

在微信公眾平臺(tái)https://mp.weixin.qq.com/ 注冊(cè)應(yīng)用，類型只選擇“公眾號(hào)/小程序/企業(yè)微信”，注冊(cè)完成后需完成”微信認(rèn)證“（微信收取300元），在基礎(chǔ)配置中拿到開(kāi)發(fā)者ID（APPID)。

在微信支付商戶平臺(tái)https://pay.weixin.qq.com注冊(cè)商戶，在賬戶中心-api安全中設(shè)置APIv3密鑰，微信支付 APIv3 使用由證書(shū)授權(quán)機(jī)構(gòu)（Certificate Authority，簡(jiǎn)稱CA）簽發(fā)的證書(shū)，商戶申請(qǐng)證書(shū)時(shí)，證書(shū)工具會(huì)生成商戶私鑰，并保存在本地證書(shū)文件夾的件 apiclient_key.pem 中。開(kāi)發(fā)和部署，需要區(qū)分環(huán)境，加載 apiclient_key.pem 文件。

在賬戶中心-商戶信息中拿到微信支付商戶號(hào)，即商戶ID （收錢的商家ID）；

在產(chǎn)品中心-appid賬號(hào)管理中，將申請(qǐng)的下來(lái)的APPID綁定到商戶號(hào)下。

Certificate Downloader 是 Java 微信支付 APIv3 平臺(tái)證書(shū)的命令行下載工具。該工具可從https://api.mch.weixin.qq.com/v3/certificates 接口獲取商戶可用證書(shū)。

2.maven引入jar包

<!-- 微信支付SDK -->
<dependency>
    <groupId>com.github.wechatpay-apiv3</groupId>
    <artifactId>wechatpay-java</artifactId>
    <version>0.2.9</version>
</dependency>

3.yml文件配置微信參數(shù)，工具類讀取

@Component
public class WechatPayConfig {

    /**
     * 應(yīng)用ID
     */
    public static String appid;

    /**
     * 商戶號(hào)
     */
    public static String merchantId;

    /**
     * 商戶API私鑰路徑
     */
    public static String privateKeyPath;

    /**
     * 商戶證書(shū)序列號(hào)
     */
    public static String merchantSerialNumber;

    /**
     * 商戶APIV3密鑰
     */
    public static String apiV3Key;

    /**
     * 通知地址（有效性：1. HTTPS；2. 不允許攜帶查詢串。）
     */
    public static String notifyUrl;

    /**
     * 微信支付配置
     */
    public static Config config;

    /**
     * 訂單支付超時(shí)時(shí)間/分鐘
     */
    public static final Integer ORDER_PAY_TIME_OUT = 1440;


    private WechatPayConfig() {}

    @Value("${wechat.pay.appid}")
    public void setAppid(String appid) {
        WechatPayConfig.appid = appid;
    }

    @Value("${wechat.pay.merchantId}")
    public void setMerchantId(String merchantId) {
        WechatPayConfig.merchantId = merchantId;
    }

    @Value("${wechat.pay.privateKeyPath}")
    public void setPrivateKeyPath(String privateKeyPath) {
        String classPath = System.getProperty("java.class.path");
        // 是否運(yùn)行在開(kāi)發(fā)環(huán)境
        boolean isRunningFromIde = classPath.toLowerCase().contains("eclipse") || classPath.toLowerCase().contains("idea");
        // 開(kāi)發(fā)環(huán)境與部署jar包環(huán)境 不同獲取私鑰路徑
        if (isRunningFromIde){
            WechatPayConfig.privateKeyPath = getClass().getClassLoader().getResource("apiclient_key.pem").getPath();
        }else {
            WechatPayConfig.privateKeyPath = privateKeyPath;
        }
    }

    @Value("${wechat.pay.merchantSerialNumber}")
    public void setMerchantSerialNumber(String merchantSerialNumber) {
        WechatPayConfig.merchantSerialNumber = merchantSerialNumber;
    }

    @Value("${wechat.pay.apiV3Key}")
    public void setApiV3Key(String apiV3Key) {
        WechatPayConfig.apiV3Key = apiV3Key;
    }

    @Value("${wechat.pay.notifyUrl}")
    public void setNotifyUrl(String notifyUrl) {
        WechatPayConfig.notifyUrl = notifyUrl;
    }

    @PostConstruct
    public void initializeConfig() {
        // 初始化微信配置
        config = new RSAAutoCertificateConfig.Builder()
                .merchantId(merchantId)
                .privateKeyFromPath(privateKeyPath)
                .merchantSerialNumber(merchantSerialNumber)
                .apiV3Key(apiV3Key)
                .build();
    }
}

4.對(duì)接支付接口

    /**
     * 微信 Native 支付下單
     *
     * @param amt         金額
     * @param orderNumber 訂單號(hào)
     * @param description 描述
     * @return 二維碼鏈接
     */
    public static AjaxResult nativePay(BigDecimal amt, String orderNumber, String description) {
        // 當(dāng)前時(shí)間
        Date currentDate = new Date();
        // 將金額轉(zhuǎn)換為分
        int total = amt.multiply(new BigDecimal("100")).intValue();
        try {
            // 構(gòu)建service
            NativePayService service = new NativePayService.Builder().config(WechatPayConfig.config).build();
            // 構(gòu)建請(qǐng)求對(duì)象
            PrepayRequest request = new PrepayRequest();
            request.setAppid(WechatPayConfig.appid);
            request.setMchid(WechatPayConfig.merchantId);
            request.setNotifyUrl(WechatPayConfig.notifyUrl);
            // 設(shè)置金額
            Amount amount = new Amount();
            amount.setTotal(total);
            request.setAmount(amount);
            request.setDescription(description);
            request.setOutTradeNo(orderNumber);
            // 計(jì)算訂單失效時(shí)間
            Calendar calendar = DateUtils.toCalendar(currentDate);
            calendar.add(Calendar.MINUTE, WechatPayConfig.ORDER_PAY_TIME_OUT);
            request.setTimeExpire(DateUtils.parseDateToStr("yyyy-MM-dd'T'HH:mm:ss+08:00", calendar.getTime()));
            return AjaxResult.success(service.prepay(request).getCodeUrl());
        } catch (Exception e){
            log.error(e.getMessage(),e);
            return AjaxResult.error("支付訂單創(chuàng)建失敗");
        }
    }

5.回調(diào)地址

    /**
     * 微信支付回調(diào)
     *
     * @return 回調(diào)結(jié)果
     */
    @PostMapping("/wechat")
    public ResponseEntity.BodyBuilder wechat(@RequestBody String body, HttpServletRequest request) {
        try {
            // 構(gòu)造 RequestParam
            RequestParam requestParam = new RequestParam.Builder()
                    // 序列號(hào)
                    .serialNumber(request.getHeader("Wechatpay-Serial"))
                    // 隨機(jī)數(shù)
                    .nonce(request.getHeader("Wechatpay-Nonce"))
                    // 簽名
                    .signature(request.getHeader("Wechatpay-Signature"))
                    // 時(shí)間戳
                    .timestamp(request.getHeader("Wechatpay-Timestamp"))
                    .body(body)
                    .build();
            // 初始化解析器
            NotificationParser parser = new NotificationParser((NotificationConfig) WechatPayConfig.config);
            // 驗(yàn)簽、解密并轉(zhuǎn)換成 Transaction
            Transaction transaction = parser.parse(requestParam, Transaction.class);
            // 校驗(yàn)交易狀態(tài)
            if (Transaction.TradeStateEnum.SUCCESS.equals(transaction.getTradeState())) {
                // 支付成功，根據(jù)訂單編號(hào)查詢訂單信息
                // 1.查詢訂單信息
                Order orderOld = orderService.selectForUpdateByOrderNumber(transaction.getOutTradeNo());
                // 校驗(yàn)金額
                if (orderOld != null && orderOld.getPayAmount().equals(transaction.getAmount().getTotal())) {
                    // 金額相等 完成支付 更新訂單狀態(tài)
                    WechatPayUtil.success(orderOld,transaction);
                } else {
                    // 金額異常 執(zhí)行退款
                    WechatPayUtil.refunded(new WechatPayRedis(transaction.getOutTradeNo(), transaction.getAmount().getTotal(), null));
                }
            }
        } catch (ValidationException e) {
            // 簽名驗(yàn)證失敗，返回 401 UNAUTHORIZED 狀態(tài)碼
            return ResponseEntity.status(HttpStatus.UNAUTHORIZED);
        }

        // 處理成功，返回 200 OK 狀態(tài)碼
        return ResponseEntity.status(HttpStatus.OK);
    }

    /**
     * 支付成功
     */
    public static void success( Order orderOld,Transaction transaction) {
        try {
            // 支付完成時(shí)間
            Date payTime = DateUtils.parseDate(transaction.getSuccessTime(), "yyyy-MM-dd'T'HH:mm:ss+08:00");
            // 校驗(yàn)訂單信息 & 支付結(jié)果 & 訂單有效期止日期
            if (orderOld != null && orderOld.getPayResult() == 0 && payTime.compareTo(orderOld.getExpirationDate()) < 1) {
                // 構(gòu)建修改對(duì)象
                Order updateOrder = new Order();
                updateOrder.setId(orderOld.getId());
                updateOrder.setPayMethod(PayMethodEnum.W.name());
                updateOrder.setPayChannel(PayChannelEnum.P.name());
                updateOrder.setPayDate(payTime);
                updateOrder.setPayResult(PayResultEnum.PAID.getCode());
                updateOrder.setPayType(PayTypeEnum.U.name());
                updateOrder.setSerialNumber(transaction.getTransactionId());
                if (orderService.editPayResult(updateOrder,orderOld) == 1) {
                    // 刪除Redis訂單支付信息
                    SpringUtils.getBean(RedisCache.class).deleteObject(WechatPayConfig.ORDER_PAY_REDIS_PREFIX + transaction.getOutTradeNo());
                }
            } else {
                // 訂單信息不存在 執(zhí)行退款
                WechatPayUtil.refunded(new WechatPayRedis(transaction.getOutTradeNo(), transaction.getAmount().getTotal(), null));
            }
        } catch (Exception e) {
            log.error(e.getMessage(), e);
        }
    }

    /**
     * 執(zhí)行退款
     */
    public static void refunded(WechatPayRedis wechatPay) {
        try {
            // 構(gòu)建退款Service
            RefundService service = new RefundService.Builder().config(WechatPayConfig.config).build();
            // 構(gòu)建請(qǐng)求對(duì)象
            CreateRequest request = new CreateRequest();
            request.setOutTradeNo(wechatPay.getOrderNumber());
            request.setOutRefundNo(wechatPay.getOrderNumber());
            // 支付總金額（分）
            long total = wechatPay.getTotal();
            // 設(shè)置退款金額
            AmountReq amount = new AmountReq();
            amount.setRefund(total);
            amount.setTotal(total);
            amount.setCurrency("CNY");
            request.setAmount(amount);
            // 請(qǐng)求API申請(qǐng)退款
            Refund refund = service.create(request);
            // 校驗(yàn)退款結(jié)果
            if (refund != null && Status.SUCCESS.equals(refund.getStatus())) {
                // 退款成功
                log.info("微信退款成功：{}", wechatPay);
            }
        } catch (Exception e) {
            log.error(e.getMessage(), e);
        }
    }