Jeepay：开源聚合支付系统

本文介绍 Jeepay（计全支付），一套面向互联网企业的开源聚合支付系统，支持微信支付、支付宝、云闪付等多渠道对接，涵盖服务商和普通商户两种模式。

项目简介

Jeepay 是由计全科技（Jeequan）团队主导开发的开源支付系统，其名称由 "Jee"（计全科技）与 "pay"（支付）组合而成，中文名称为"计全支付"，寓意"计出万全、支付安全"。项目由原 XxPay 支付系统作者带领团队开发，团队拥有多年支付系统的开发经验，在支付领域的架构设计和业务逻辑处理上有着深厚积累。

作为一套完整的支付解决方案，Jeepay 采用前后端分离架构，后端基于 Spring Boot 3.x 开发，前端使用 Ant Design Vue 构建，集成了 Spring Security 实现权限管理。系统支持分布式部署和高并发场景，可以满足中小型互联网企业的支付接入需求。对于需要快速搭建支付能力、但又不想从零开始开发的企业来说，Jeepay 是一个经过实战验证的可靠选择。

核心特性

Jeepay 的功能设计围绕支付业务的核心场景展开，以下是其主要特性：

多渠道支付对接：已集成微信支付、支付宝、云闪付三大主流支付渠道的官方接口
双模式支持：同时支持服务商模式和普通商户模式，适配不同业务场景
微信支付全接口：支持 V2 和 V3 接口版本，覆盖服务商和普通商户两种接入方式
支付宝全接口：支持 RSA 和 RSA2 签名算法，覆盖服务商和普通商户模式
云闪付对接：服务商接口支持，可选择多家支付机构进行资金清算
聚合码支付：支持将多个支付渠道整合到一个二维码中，用户扫码后自动识别支付方式
多商户多应用：一个商户可以创建多个应用独立接入支付，便于管理不同业务线的支付
MQ 消息通知：支付结果回调使用消息队列实现，保证高可用和消息可达性
签名安全机制：接口请求和响应数据均采用签名机制，保障交易安全性
配置自动化：支付渠道的接口参数配置界面自动生成，降低接入门槛
SDK 多语言支持：提供 Java、Python SDK 和 PHP 对接示例，方便各类技术栈的接入方快速集成
一键部署：支持 Docker 部署，官方提供宝塔面板和 Shell 脚本一键安装方案

技术栈

Jeepay 的技术选型兼顾了开发效率、运行性能和社区生态：

组件	说明	版本
JDK	Java 运行环境	17
Spring Boot	后端核心框架	3.3.7
Redis	分布式缓存与会话管理	3.2.8+
MySQL	关系型数据库	5.7.X / 8.0
MQ	消息中间件	ActiveMQ / RabbitMQ / RocketMQ
Ant Design Vue	前端 UI 组件库	4.2.6
MyBatis-Plus	ORM 增强工具	3.4.2
WxJava	微信开发 Java SDK	4.6.0
Hutool	Java 通用工具类库	5.8.26
Spring Security	认证与权限管理框架	内置

后端采用多模块 Maven 项目结构，按业务职责拆分为支付网关、运营平台、商户系统、业务服务层等独立模块，清晰的功能边界有利于团队协作和二次开发。

安装指南

Jeepay 提供了多种部署方式，适合不同运维水平的用户：

方式一：宝塔面板一键安装（推荐新手）

安装宝塔面板 9.2.0 及以上版本
在 Docker 管理中搜索 "jeepay"
一键安装即可完成部署

方式二：Shell 脚本一键安装

CentOS 系统（推荐 Anolis OS 8.8）：

bash

yum install -y wget && wget -O install.sh https://gitee.com/jeequan/jeepay/raw/master/docs/install/install.sh && sh install.sh

Ubuntu 系统（推荐 Ubuntu 22.04 64位）：

bash

apt update && apt-get -y install docker.io && apt-get -y install git && wget -O install.sh https://gitee.com/jeequan/jeepay/raw/master/docs/install/install.sh && sh install.sh

官方宣称整个部署过程约 10 分钟即可完成，适合快速体验和测试。

方式三：手动 Docker 部署

项目仓库中提供了完整的 Docker 配置文件（位于 docker/ 目录下），可以自行使用 Docker Compose 编排部署，适合需要自定义配置的生产环境。

快速开始

1. 环境准备

确保以下环境已就绪：

JDK 17
MySQL 5.7+ 或 8.0
Redis 3.2.8+
消息中间件（ActiveMQ / RabbitMQ / RocketMQ 任选其一）

2. 数据库初始化

项目提供了完整的 SQL 初始化脚本，位于 docs/sql/ 目录下，需要按照顺序导入到 MySQL 数据库中。

3. 配置修改

项目部署使用的配置文件存放在 conf/ 目录下，以 .yml 格式存储。主要需要修改以下配置项：

数据库连接信息（地址、端口、用户名、密码）
Redis 连接信息
消息中间件连接配置
支付渠道的相关密钥和证书

4. 启动服务

系统包含三个核心服务，按顺序启动：

支付网关（端口 9216）：负责接收和处理支付请求
运营平台（端口 9217）：面向平台运营人员的管理后台
商户系统（端口 9218）：面向接入商户的管理后台

5. 在线体验

如果只是想快速了解系统功能，可以直接访问官方提供的在线演示环境：

支付流程体验：https://www.jeequan.com/demo/jeepay_cashier.html
运营平台和商户系统演示：https://www.jeequan.com/doc/detail_84.html

使用示例

SDK 集成对接

Jeepay 提供了 Java 和 Python 的 SDK，以下以 Java SDK 为例说明基本的对接流程：

下载 SDK 包（地址：https://doc.jeequan.com/#/integrate/open/api/116）
在业务系统中引入 SDK 依赖
配置商户号、应用 ID 和密钥信息
调用统一下单接口创建支付订单
接收异步通知回调，更新业务订单状态
对接退款、查询等补充接口

接口市场扩展

对于需要接入更多第三方支付渠道或银行直连的用户，计全官方提供了丰富的付费接口插件，目前已发布包括：

三方支付：汇付 Adapay、斗拱支付、银盛支付、银联支付、杉德支付、富友支付、通联支付等二十余种
银行直连：工行支付、浦发银行、建行龙支付、交行支付
四方支付：付呗支付、米花支付

接口插件以插件化方式安装，无需修改核心代码，安装说明详见官方文档。

项目结构概览

text

jeepay/
├── conf/                    -- 系统部署配置文件
├── docker/                  -- Docker 相关文件
├── docs/                    -- 项目文档
│   ├── install/             -- 部署脚本
│   ├── script/              -- 启动脚本
│   └── sql/                 -- 数据库初始化脚本
├── jeepay-components/       -- 公共组件
│   ├── jeepay-components-mq -- MQ 消息组件
│   └── jeepay-components-oss -- OSS 存储组件
├── jeepay-core/             -- 核心依赖包
├── jeepay-manager/          -- 运营平台服务端
├── jeepay-merchant/         -- 商户系统服务端
├── jeepay-payment/          -- 支付网关
├── jeepay-service/          -- 业务层代码
└── jeepay-z-codegen/        -- MyBatis 代码生成器

项目链接

服务端仓库：https://github.com/jeequan/jeepay
前端仓库：https://github.com/jeequan/jeepay-ui
Gitee 镜像：https://gitee.com/jeequan/jeepay
项目文档：https://doc.jeequan.com/#/integrate/open
接口市场：https://www.jeequan.com/ifstore/list.html
在线演示：https://www.jeequan.com/demo/jeepay_cashier.html
视频教程：https://www.bilibili.com/video/BV17C411Y7EZ/
开源协议：LGPL-3.0 License