# dax-pay

**Repository Path**: LightOfFaith/dax-pay

## Basic Information

- **Project Name**: dax-pay
- **Description**: 支持支付宝、微信、抖音、乐刷等通道，提供支付、退款、风控、分账等功能。通过HTTP方式进行调用，不与其他系统产生耦合关联，提供可视化界面进行管理。
- **Primary Language**: Java
- **License**: LGPL-3.0
- **Default Branch**: 4.0
- **Homepage**: https://doc.open.daxpay.cn/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 802
- **Created**: 2026-08-27
- **Last Updated**: 2026-09-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Dromara Dax-Pay-Open

<p align="left">
 <img src="https://img.shields.io/github/stars/dromara/dax-pay?style=flat&label=Github">
 <img src='https://gitee.com/bootx/dax-pay/badge/star.svg?theme=dark' alt='star'/>
 <img src="https://img.shields.io/badge/Dax%20Pay-4.0.0--beta4-success.svg" alt="Build Status"/>
 <img src="https://img.shields.io/badge/Author-Daxpay-orange.svg" alt="Build Status"/>
 <img src="https://img.shields.io/badge/Spring%20Boot-4.1.0-blue.svg" alt="Downloads"/>
 <img src="https://img.shields.io/badge/license-LGPL--3.0--or--later-green.svg"/>
</p>

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

业务系统只需对接一套**统一的 HTTP 标准协议**即可接入支付宝、微信、银联等多种支付方式;第三方 SDK 全部隔离到**独立部署的通道子应用**,对接、升级、扩容互不干扰。

> 📌 **快捷导航**: [官方文档站](https://doc.open.daxpay.cn) · [一键部署](https://doc.open.daxpay.cn/deployment/installer) · [部署指南](https://doc.open.daxpay.cn/deployment/run) · [交流群](#关于我们)

## 源码与演示

### 源码地址

| 项目 | Gitee | GitHub |
|------|-------|--------|
| 后端主应用(本仓库) | [dax-pay](https://gitee.com/dromara/dax-pay) | [dax-pay](https://github.com/dromara/dax-pay) |
| Web 管理端(运营端 + 商户端) | [dax-pay-ui](https://gitee.com/opendaxpay/dax-pay-ui) | [dax-pay-ui](https://github.com/opendaxpay/dax-pay-ui) |
| 通道子应用 · Java | [dax-pay-channel-one](https://gitee.com/opendaxpay/dax-pay-channel-one) | [dax-pay-channel-one](https://github.com/opendaxpay/dax-pay-channel-one) |
| 通道子应用 · Go | [dax-pay-channel-one-go](https://gitee.com/opendaxpay/dax-pay-channel-one-go) | [dax-pay-channel-one-go](https://github.com/opendaxpay/dax-pay-channel-one-go) |
| H5 网关端(PC + 移动) | [dax-pay-h5](https://gitee.com/opendaxpay/dax-pay-h5) | [dax-pay-h5](https://github.com/opendaxpay/dax-pay-h5) |

> 聚合通道(`dax-pay-channel-two`,拉卡拉 / 海科融通 / 斗拱 / 乐刷 / 随行付等)、运营 / 商户 / 收银小程序等属于商业扩展包,详见 [版本清单](https://doc.open.daxpay.cn/extension/pricing/overview)。

### 演示环境

> 演示账号暂未公布,完整功能请参考本地部署。启动后默认的本地账号密码为 `bootx / 121212`。

| 站点类型 | 地址 | 演示账号 |
|---------|------|---------|
| 运营端 | https://admin.open.daxpay.cn | 待公布 |
| 商户端 | https://merchant.open.daxpay.cn | 待公布 |
| H5 端 | https://h5.open.daxpay.cn | — |

## 核心特性

- **完整交易闭环** — 支付、退款、转账、查询、回调、同步、关闭、商户通知,支持全额/部分退款
- **通道编排与对接分离** — 主应用负责路由与策略编排,第三方 SDK 下沉到独立子应用,独立部署、独立升级、弹性伸缩
- **Java + Go 双语言通道实现** — 通道子应用提供两套对等实现,按团队技术栈与性能诉求选用
- **统一 HTTP 接口** — 各通道封装为 RESTful 标准协议,一次对接、多通道通用,请求与响应 RSA 签名
- **多商户与服务商模式** — 运营端 + 商户端双入口,菜单与数据按 `client_code` 隔离,商户数据行级隔离
- **全端覆盖** — 运营/商户 Web 管理端 + PC 与移动双端 H5 网关;三端小程序为商业扩展包
- **两级风控** — 平台级策略 + 商户级地理围栏:黑名单、海外 IP 拦截、门店围栏,交易前阻断、交易后补录
- **国际化与时区** — 中日韩 + 东盟 10 语种支持,时间字段统一 UTC 存储
- **沙箱 / 生产部署级隔离** — 部署隔离 + 全局开关,启动期 fail-fast 强制对齐

## 系统架构

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

| 层级                                             | 职责                                                      | 实现           |
|--------------------------------------------------|-----------------------------------------------------------|----------------|
| **编排层**(主应用 `dax-pay-open`)                | 通道声明、通道路由、支付策略编排、配置数据 CRUD、回调组装 | 不含第三方 SDK |
| **对接层**(子应用 `channel-one` / `channel-two`) | 第三方 SDK 直接调用、签名/验签、通道专属协议适配          | 独立部署       |

主应用通过声明式 HTTP 客户端(`@HttpExchange`)调用子应用,链路全程 **AES-GCM 传输加密**,SDK 依赖隔离、按通道独立升级、高频通道可多实例弹性伸缩。

## 支付通道

| 通道模块                | 所属机构 | 对接模式           |
|-------------------------|----------|--------------------|
| `daxpay-channel-alipay` | 支付宝   | 直连 + ISV(服务商) |
| `daxpay-channel-wechat` | 微信支付 | 直连 / 服务商      |
| `daxpay-channel-ums`    | 银联商务 | 直连               |
| `daxpay-channel-douyin` | 抖音支付 | 直连               |

> 聚合通道(拉卡拉、海科融通、斗拱、乐刷、随行付、河马付、Adapay、富友、易宝等 )属于商业扩展包,由 `dax-pay-channel-two` 子应用承载,详见 [版本清单](https://doc.open.daxpay.cn/extension/pricing/overview)。

## 安全机制

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

- **接口签名防篡改** — 开放支付 API 全链路 RSA(`SHA256withRSA`)双向验签,核心入口切面统一拦截
- **字段级加密** — 通道密钥、API 凭证等敏感字段 AES-256-GCM 透明加密,支持密钥轮换,拖库也无法解密
- **传输加密** — 主应用与通道子应用间全程 AES-GCM,生产环境密钥强制环境变量注入
- **双重 Nonce 防重放** — 管理端一次性 nonce 签发 + 开放 API 商户 `nonceStr`,Redis SETNX + 时间窗口校验
- **权限认证** — Sa-Token + 菜单数据隔离,支持 TOTP 两步验证与社交登录
- **生产 fail-fast 校验** — 启动前强制校验开发态开关(沙箱、超管、Swagger 等),未关闭则拒绝启动,详见 [部署指南](./_doc/DEPLOYMENT.md)

## 插件机制

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

| 插件                    | 说明                                                                                  |
|-------------------------|---------------------------------------------------------------------------------------|
| `daxpay-plugin-risk`    | 支付风控插件 — 黑名单(IP / 用户标识 / 省市地区)+ 海外 IP 拦截 + 门店地理围栏 + 命中记录,交易前阻断 / 交易后补录,支持平台策略与商户级 opt-in 两级门控 |
| `daxpay-plugin-easypay` | 易支付协议插件 — 实现易支付的订单/退款/凭证/配置对接,可直接与支持易支付协议的系统互通 |

## 核心技术栈

| 名称           | 描述       | 版本要求   |
|----------------|------------|------------|
| JDK            | Java 环境  | 25+        |
| Spring Boot    | 开发框架   | 4.1.x      |
| PostgreSQL     | 数据库     | 14 及以上  |
| Redis          | 分布式缓存 | 7.x 及以上 |
| Apache Artemis | 消息队列   | 2.55+      |
| OpenTelemetry  | 链路追踪   | 内置       |
| Go             | GoLang环境 | 1.22+      |

## 项目结构

```
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/                   # 启动入口
```

<p align="left">
  <img src="https://cdn.jsdmirror.com/gh/xxm1995/picx-images-hosting@master/20260727/1280X1280-(2).1vzcvhe692.webp" width="800" alt="DaxPay 系统架构图">
</p>

## 系统截图

<p align="left">
  <img src="https://cdn.jsdmirror.com/gh/xxm1995/picx-images-hosting@master/20260727/ScreenShot_2026-07-27_134631_746.7lkp72gaua.webp" width="800" alt="">
  <img src="https://cdn.jsdmirror.com/gh/xxm1995/picx-images-hosting@master/20260727/ScreenShot_2026-07-27_134752_374.8vnmddya4o.webp" width="800" alt="">
  <img src="https://cdn.jsdmirror.com/gh/xxm1995/picx-images-hosting@master/20260727/ScreenShot_2026-07-27_134652_881.7ehhbmu5es.webp" width="800" alt="">
  <img src="https://cdn.jsdmirror.com/gh/xxm1995/picx-images-hosting@master/20260727/ScreenShot_2026-07-27_134735_540.wj9ibj64l.webp" width="800" alt="">
  <img src="https://cdn.jsdmirror.com/gh/xxm1995/picx-images-hosting@master/20260727/ScreenShot_2026-07-27_152315_016.1lcj2df8zo.webp" width="800" alt="">
  <img src="https://cdn.jsdmirror.com/gh/xxm1995/picx-images-hosting@master/20260727/ScreenShot_2026-07-27_152337_157.9gx9zq1a9y.webp" width="800" alt="">
  <img src="https://cdn.jsdmirror.com/gh/xxm1995/picx-images-hosting@master/20260727/ScreenShot_2026-07-27_134710_519.92qu8vc9l6.webp" width="800" alt="">
  <img src="https://cdn.jsdmirror.com/gh/xxm1995/picx-images-hosting@master/20260727/ScreenShot_2026-07-27_134851_582.8z78b3rcul.webp" width="800" alt="">
  <img src="https://cdn.jsdmirror.com/gh/xxm1995/picx-images-hosting@master/20260727/ScreenShot_2026-07-27_152700_495.8dxkou9kkt.webp" width="800" alt="">
  <img src="https://cdn.jsdmirror.com/gh/xxm1995/picx-images-hosting@master/20260727/ScreenShot_2026-07-27_145448_013.64ek5ckpxk.webp" width="800" alt="">
</p>
<table align="left">
  <tr>
    <td align="center"><img src="https://cdn.jsdmirror.com/gh/xxm1995/picx-images-hosting@master/20260727/微信图片_20260727141720_489_69.92qu8tkfkw.webp" width="240" alt=""></td>
    <td align="center"><img src="https://cdn.jsdmirror.com/gh/xxm1995/picx-images-hosting@master/20260727/微信图片_20260727151707_493_69.3yf5jkkngh.webp" width="240" alt=""></td>
    <td align="center"><img src="https://cdn.jsdmirror.com/gh/xxm1995/picx-images-hosting@master/20260727/微信图片_20260727141719_488_69.6m4ltwdjod.webp" width="240" alt=""></td>
    <td align="center"><img src="https://cdn.jsdmirror.com/gh/xxm1995/picx-images-hosting@master/20260727/微信图片_20260727153019_494_69.7ehhboclbz.webp" width="240" alt=""></td>
  </tr>
  <tr>
    <td align="center"><img src="https://cdn.jsdmirror.com/gh/xxm1995/picx-images-hosting@master/20260727/微信图片_20260727141719_487_69.77e9g77zyz.webp" width="240" alt=""></td>
    <td align="center"><img src="https://cdn.jsdmirror.com/gh/xxm1995/picx-images-hosting@master/20260727/微信图片_20260727145731_491_69.lwfp6j58j.webp" width="240" alt=""></td>
    <td align="center"><img src="https://cdn.jsdmirror.com/gh/xxm1995/picx-images-hosting@master/20260727/微信图片_20260727150056_492_69.70b1ks11s5.webp" width="240" alt=""></td>
    <td align="center"><img src="https://cdn.jsdmirror.com/gh/xxm1995/picx-images-hosting@master/20260727/微信图片_20260727153639_496_69.ictri0pz9.webp" width="240" alt=""></td>

  </tr>
</table>

## 关于我们

### QQ 交流群

> 扫码加入 QQ 交流群: 839738244

<p>
<img src="https://cdn.jsdmirror.cn/gh/xxm1995/picx-images-hosting@master/20260611/qrcode_1781170853115.1e99dci0rp.webp" width = "330" height = "500"/>
</p>

### 微信交流群

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

<p>
<img alt="微信图片_20240226144703" height="480" src="https://cdn.jsdmirror.com/gh/xxm1995/picx-images-hosting@master/connect/微信图片_20240412152722.231nkeje2o.webp" width="330"/>
</p>

### 微信公众号

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

<p>
<img alt="微信公众号" height="440" src="https://cdn.jsdmirror.cn/gh/xxm1995/picx-images-hosting@master/connect/微信图片_20240412152722.231nkeje2o.webp" width="330"/>
</p>

## 鸣谢

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

[部分参考的开源项目和开源许可列表](./_license/LICENSE.md)

## License

`DaxPay` 基于 `GNU LGPL v3.0 或更高版本` 协议开源([LICENSE](LICENSE)),受中华人民共和国相关法律法规的保护和限制,可在符合 [《用户授权使用协议》](用户授权使用协议.txt) 与开源协议的前提下免费使用、学习和交流,**使用前请阅读上述协议,如不同意请勿使用**。