IJPay 使用教程

📖 项目简介

IJPay 是一个 Java 支付工具库，封装了微信支付、支付宝、QQ支付、京东支付、银联支付、PayPal 等常用支付方式的接口。它不依赖任何第三方 MVC 框架，仅作为工具使用，可以轻松嵌入到任何 Java 系统中，帮助你快速完成支付模块的开发。

对于一人公司和独立开发者来说，IJPay 能让你在半天内搞定全平台支付对接，不再需要花一周时间逐个阅读各平台的支付文档。

💡

GitHub 地址： https://github.com/javen205/IJPay

✨ 核心亮点

🔌

六合一支付SDK

微信、支付宝、QQ、京东、银联、PayPal 全覆盖

🆓

零框架依赖

不依赖 Spring/MVC，嵌入任何 Java 项目

🏪

多商户多应用

同时管理多个商户号和应用，灵活配置

🔄

V2 + V3 双版本

微信支付 API-v2 和 API-v3 接口同时支持

💳 支持的支付方式

💚

微信支付

JSAPI、Native、APP、H5、小程序等全场景

🔵

支付宝

支持普通公钥和公钥证书两种签名方式

🐧

QQ 钱包

QQ 钱包支付全接口封装

🔴

京东 & 银联 & PayPal

京东支付、银联条码支付、PayPal 国际支付

🚀 快速接入（3步搞定）

添加 Maven 依赖

在项目的 pom.xml 中引入 IJPay 依赖。可按需引入单个支付模块，也可一次性引入全部：

                        xml
                        <!-- 全部支付（推荐快速体验） -->
<dependency>
    <groupId>com.github.javen205</groupId>
    <artifactId>IJPay-All</artifactId>
    <version>2.9.11</version>
</dependency>

<!-- 或按需引入，如仅微信支付 -->
<dependency>
    <groupId>com.github.javen205</groupId>
    <artifactId>IJPay-WxPay</artifactId>
    <version>2.9.11</version>
</dependency>
                    

配置商户信息

以微信支付为例，配置你的商户号、AppID、API 密钥等信息：

                        java
                        WxPayApiConfig wxPayApiConfig = WxPayApiConfig.builder()
    .appId("你的AppID")
    .mchId("你的商户号")
    .partnerKey("你的API密钥")
    .certPath("证书路径")
    .domain("https://api.mch.weixin.qq.com")
    .build();
                    

⚠️

请务必保管好 API 密钥和证书文件，不要提交到 Git 仓库中！

发起支付请求

使用封装好的 API 发起统一下单，几行代码即可：

                        java
                        // 微信 Native 支付（扫码支付）
Map<String, String> params = UnifiedOrderModel.builder()
    .appid(appId)
    .mch_id(mchId)
    .nonce_str(WxPayKit.generateStr())
    .body("商品描述")
    .out_trade_no("订单号")
    .total_fee("100")  // 单位：分
    .spbill_create_ip("127.0.0.1")
    .notify_url("https://你的域名/pay/notify")
    .trade_type(TradeType.NATIVE.getTradeType())
    .build()
    .createSign(partnerKey, SignType.MD5);

String result = WxPayApi.pushOrder(false, params);
                    

📦 官方 Demo 项目

IJPay 提供了完整的 Demo 项目，可以直接运行体验：

Spring Boot 版本：IJPay-Demo-SpringBoot
JFinal 版本：IJPay-Demo-JFinal
Solon 版本：IJPay-Demo-Solon

✅

建议先克隆 Demo 项目跑起来，再根据自己的业务需求进行修改，上手更快！

❓ 常见问题

Q: IJPay 需要依赖 Spring 框架吗？

不需要！IJPay 是纯工具库，不依赖任何 MVC 框架。你可以在 Spring Boot、JFinal、Solon 甚至纯 Servlet 项目中直接使用。

Q: 微信支付 V2 和 V3 接口应该选哪个？

如果是新项目，推荐使用 V3 接口，安全性更高、功能更完善。如果是老项目升级，V2 接口同样支持，可以平滑过渡。

Q: 支持个人开发者接入支付吗？

IJPay 本身不限制使用者身份，但各支付平台有自己的商户入驻门槛。微信支付需要企业或个体工商户资质，支付宝支持个人开发者接入部分功能。建议先在对应平台完成商户注册。

Q: 如何处理支付回调通知？

IJPay 封装了回调通知的验签和解析逻辑，只需在回调接口中调用 WxPayKit.verifyNotify() 即可自动完成签名验证和数据解析，非常方便。