DaxPay 开源版是一款基于 GNU LGPL v3.0 协议分发的开源支付系统,提供支付、退款、转账等支付相关的核心能力,面向支付服务商、多商户平台与跨境业务团队。

业务系统对接多种支付方式(支付宝、微信、银联等)通常面临:各通道接口规范、签名算法、回调机制各不相同,通道 SDK 依赖冲突、版本锁定与主业务耦合严重,多渠道资金对账、风控、终端设备管理分散。DaxPay 将各通道封装为统一的 HTTP 接口,业务系统只需对接一套标准协议即可接入多种支付方式;同时把第三方 SDK 隔离到独立部署的通道子应用中,显著降低对接、运维与升级的复杂度。

📌 快捷导航: 官方文档站 · 部署指南 · 交流群

DaxPay 开源版是一款基于 GNU LGPL v3.0 协议分发的开源软件,受中华人民共和国相关法律法规的保护和限制,可以在符合《用户授权使用协议》和 《GNU LGPL v3.0 或更高版本》开源协议情况下进行免费使用、学习和交流。在使用前请阅读上述协议,如果不同意请勿进行使用。

• 支付核心能力 — 覆盖支付、退款、查询、回调、同步、关闭、商户通知等完整交易闭环,支持全额/部分退款与差错处理
• 通道编排与对接分离 — 主应用负责通道路由、策略编排与配置管理,第三方 SDK 下沉到独立子应用,支持独立部署、独立升级、弹性伸缩
• Java + Go 双语言实现 — 通道子应用同时提供 Java(Spring Boot)与 Go(Gin)两套对等实现,按团队技术栈与性能诉求按需选用
• 统一 HTTP 接口 — 各通道封装为 RESTful 标准协议,业务系统一次对接、多通道通用,接口请求与响应支持 RSA 签名
• 多商户与服务商模式 — 运营端 + 商户端双入口架构,菜单与数据按 client_code 隔离,每个商户数据通过商户编号行级隔离
• 全端覆盖 — 运营/商户 Web 管理端 + PC 与移动双端 H5 网关;管理端小程序、商户端小程序、收银小程序为商业扩展包
• 安全签名与字段加密 — RSA 双向验签 + AES-256-GCM 字段级加密 + 双重 Nonce 防重放,Sa-Token 权限认证
• 国际化与时区 — 中日韩 + 东盟 10 语种支持,时间字段统一UTC 存储,适配各时区情况
• 沙箱 / 生产部署级隔离 — 通过部署隔离 + 全局开关让"沙箱"概念在生产部署中根本不存在,启动期 fail-fast 强制对齐

DaxPay 采用主应用编排 + 子应用对接的分层架构,这是其系统的核心设计:

主应用通过声明式 HTTP 客户端(@HttpExchange)调用子应用,链路全程 AES-GCM 传输加密。这样设计优点如下:

• SDK 依赖隔离 — 第三方 SDK 不污染主应用,避免版本冲突
• 独立升级 — 子应用可按通道单独发版,不影响主链路
• 弹性伸缩 — 高频通道(支付宝、微信)可多实例独立扩缩容

聚合通道(拉卡拉、海科融通、斗拱、乐刷、随行付、河马付、Adapay、富友、易宝等 )属于商业扩展包,由 dax-pay-channel-two 子应用承载,详见 版本清单。

DaxPay 在接口、传输、存储、认证多个层面构建安全防护:

• 接口签名防篡改 — 开放支付 API 采用 RSA(SHA256withRSA)双向验签:商户私钥签名、平台公钥验签,平台私钥签名响应、商户公钥验签,核心入口由 PaymentVerifyAspect 切面统一拦截
• 字段级加密 — 数据库敏感字段(通道密钥、API 凭证、OAuth clientSecret 等)采用 AES-256-GCM 透明加密(MyBatis-Plus TypeHandler),支持多版本密钥轮换,即使数据库被拖走也无法解密
• 传输加密 — 主应用与通道子应用之间全程 AES-GCM 加密,生产环境密钥强制通过环境变量注入
• 双重 Nonce 防重放 — 管理端 API(capability-nonce)由平台签发一次性 nonce + 时间窗口校验;开放支付 API 由商户自生成 nonceStr,基于 Redis SETNX 语义防重放 + 双向时间窗口校验
• 权限认证 — Sa-Token权限框架 + 菜单数据隔离,支持 TOTP 两步验证与社交登录(微信/支付宝/抖音/QQ/飞书/钉钉/GitHub 等)
• 生产部署 fail-fast 校验 — 通过 DeploymentModeEnforcer(SPI 注册)在容器启动前按 daxpay.platform.deployment.mode 强制校验一组"开发态功能"开关(沙箱、超管登录、Swagger、actuator 端点等),任一未关闭则拒绝启动,避免开发配置误带入生产。详见 部署指南

通过 SPI 扩展点实现可插拔业务增强,核心层 PayPluginAssistService 作为插件辅助接入点:

dax-pay-open/                       # 主后端应用
├── daxpay-platform/                # 基础层
│   ├── daxpay-platform-core/       #   通用契约
│   ├── daxpay-platform-common/     #   技术设施
│   ├── daxpay-platform-capability/ #   平台能力
│   └── daxpay-platform-service/    #   业务服务
├── daxpay-payment/                 # 支付核心
│   ├── daxpay-payment-core/        #   领域内核:下单 / 退款 / 同步 / 回调 / 通知 / 路由
│   ├── daxpay-payment-unipay/      #   统一开放 API
│   ├── daxpay-payment-admin/       #   运营端 API
│   ├── daxpay-payment-merchant/    #   商户端 API
│   ├── daxpay-payment-app-admin/   #   运营小程序 API
│   └── daxpay-payment-app-merchant/#   商户小程序 API
├── daxpay-channel/                 # 通道路由与编排
├── daxpay-plugin/                  # 插件机制(风控/易支付)
├── daxpay-demo/                    # 功能演示模块
└── daxpay-start/                   # 启动入口

DaxPay 开源版由多个独立 git 仓库组成,本仓库为主后端应用。配套子项目按交付形态分为两类:

下列项目为 DaxPay 商业版扩展组件不在开源版交付范围内,需购买对应版本授权使用。详见 版本清单。

演示账号部分功能权限未开放,完整功能请参考本地部署。启动后默认的本地账号密码为 bootx / 123123。

扫码加入 QQ 交流群: 839738244

微信扫码加小助手拉群: sdcit2020

微信公众号会定期更新使用教程、版本更新记录和各种活动情况,欢迎关注

感谢其他提供灵感和思路的开源项目

部分参考的开源项目和开源许可列表

GNU LGPL v3.0 或更高版本 (GNU Lesser General Public License v3.0 or later)