Java SDK 概览与安装

聚合付科技官方 Java SDK：jeepay-java-sdk，位于仓库 sdk/jeepay-java-sdk（独立 Maven 模块，不进主工程编译）。

特性

• 零框架依赖：仅依赖 fastjson，HTTP 使用 JDK 标准库，JDK 8+ 可用；
• 与服务端同源签名：SignUtils 与 jeepay-core JeepayKit.getSign 算法逐行一致；
• 自动补齐公共字段（version / signType / reqTime）并自动计算 sign；
• 响应携带 sign 时自动验签，失败抛出 JeepayException；
• 覆盖：统一下单、查单、关单、退款、退款查询、转账、转账查询、分账、分账接收者绑定、投诉查询/回复/完结。

模块结构

sdk/jeepay-java-sdk
├── pom.xml
└── src/main/java/com/jeepay/sdk
    ├── JeepayClient.java        # 客户端（全部 API 方法）
    ├── JeepayResponse.java      # 统一响应（code/msg/data/sign）
    ├── JeepayException.java     # 异常
    ├── SignUtils.java           # 签名工具
    └── model/                   # 各接口请求模型类

安装

方式一：Maven 本地安装

cd sdk/jeepay-java-sdk
mvn install

业务工程中引用：

<dependency>
    <groupId>com.jeepay</groupId>
    <artifactId>jeepay-java-sdk</artifactId>
    <version>1.0.0</version>
</dependency>

方式二：源码直接引入

将 src/main/java/com/jeepay/sdk 目录拷贝到业务工程，加上 fastjson 依赖即可。

API 一览

方法	接口	鉴权
unifiedOrder	POST /api/pay/unifiedOrder	appSecret 签名
queryOrder	POST /api/pay/query	appSecret 签名
closeOrder	POST /api/pay/close	appSecret 签名
refundOrder	POST /api/refund/refundOrder	appSecret 签名
queryRefundOrder	POST /api/refund/query	appSecret 签名
transferOrder	POST /api/transferOrder	appSecret 签名
queryTransferOrder	POST /api/transfer/query	appSecret 签名
divisionExec	POST /api/division/exec	appSecret 签名
divisionReceiverBind	POST /api/division/receiver/bind	appSecret 签名
complaintList	GET /api/complaints/list	X-Api-Key
complaintReply	POST /api/complaints/reply	appSecret 签名
complaintFinish	POST /api/complaints/finish	appSecret 签名

下一步见 SDK 快速上手。