Dromara Dax-Pay(开源支付系统-单商户版)

Dromara Dax-Pay(开源支付系统-单商户版)

❗使用须知

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

⚠️多商户版本建议征询

近期将会开启多商户版本的开发，为了更好的听取大家的建议，特建立一个征集需求建议的issues，欢迎提出各种功能需求和建议，填写地址：功能和建议填写

🍈项目介绍

DaxPay是一套开源支付网关系统，已经对接支付宝、微信支付相关的接口。可以独立部署，提供接口供业务系统进行调用，不对原有系统产生影响

gateway为开发分支，本地运行请使用master分支进行测试，当前正在进行整个系统的优化重构工作，请勿在生产环境中使用，请等待生产可用的版本发布，

🧭 特色功能

封装各类支付通道的接口为统一的接口，方便业务系统进行调用，简化对接多种支付方式的复杂度
已对接微信支付、支付宝和云闪付相关的接口，后续版本将支持V3版本的接口
支持支付、退款、对账、分账等支付相关的能力
提供HTTP方式接口调用能力，和Java版本的SDK，方便业务系统进行对接
接口请求和响应数据支持启用签名机制，可根据实际需要进行开关，保证交易安全可靠
提供管理平台，方便运营人员进行管理和操作，不需要懂IT技术也可以轻松使用
提供聚合支付、电脑收银台和手机收银台的演示模块，供开发者参考其实现支付功能的逻辑

📃 文档和源码地址

文档地址

在 Bootx开源文档站下的支付网关(DaxPay)模块下可以进行查阅相关文档，具体链接地址如下：快速指南、支付对接、操作手册

项目地址

项目	GITEE	GITHUB
后端地址	GITEE	GITHUB
Web前端地址	GITEE	GITHUB
H5前端地址	GITEE	GITHUB

🏬 系统演示

管理平台:

注：演示账号部分功能修改删除权限未开放。

地址：https://daxpay.demo.bootx.cn

账号：daxpay

密码：123456

网关接口

注：接口平台只开放支付网关相关的接口，不开放系统其他接口。

地址: https://daxpay.server.bootx.cn/doc.html

账号: daxpay

密码: 123456

收银台演示

请勿大额支付，可以通过后台管理端进行退款

电脑收银台地址: https://daxpay.demo.bootx.cn/#/cashier

手机收银台地址: https://daxpay.demo.bootx.cn/h5/#/cashier/uniCashier

🥞 核心技术栈

名称	描述	版本要求
Jdk	Java环境	1.8+，11版本可以正常使用，但17+版本暂不支持
Spring Boot	开发框架	2.7.x
Redis	分布式缓存	5.x版本及以上
MySQL	数据库	基于5.7.X版本开发，基本支持8.x版本
Vue	前端框架	3.x

🛠️ 业务系统接入

业务系统想接入支付网关的话，不需要集成到业务系统里，只需要单独部署一份支付系统，然后业务系统通过接口调用即可拥有对应的支付能力，不会对原业务系统的架构产生影响。如果是Java项目，可以使用SDK简化接入流程，其他语言可以参照中的说明使用HTTP接口方式接入。

Java客户端SDK

SDK版本号与支付网关的版本保持一致，如果需要使用，请在pom.xml中添加如下依赖。SDK使用方式参考SDK使用说明。

 <!-- 支付SDK -->
<dependency>
    <groupId>cn.bootx.platform</groupId>
    <artifactId>daxpay-single-sdk</artifactId>
    <version>${latest.version}</version>
</dependency>

SDK调用示例

此处以简单支付接口为例，演示业务系统如何调用支付网关进行支付，其他接口的调用方式类似，具体请参考支付对接。

package cn.bootx.platform.daxpay.sdk;
import cn.bootx.platform.daxpay.sdk.code.PayChannelEnum;
import cn.bootx.platform.daxpay.sdk.code.PayMethodEnum;
import cn.bootx.platform.daxpay.sdk.model.PayOrderModel;
import cn.bootx.platform.daxpay.sdk.net.DaxPayConfig;
import cn.bootx.platform.daxpay.sdk.net.DaxPayKit;
import cn.bootx.platform.daxpay.sdk.param.pay.SimplePayParam;
import cn.bootx.platform.daxpay.sdk.response.DaxPayResult;
import org.junit.Before;
import org.junit.Test;
/**
 * 简单支付
 * @author xxm
 * @since 2024/2/2
 */
public class SimplePayOrderTest {
    @Before
    public void init() {
        // 初始化支付配置
        DaxPayConfig config = DaxPayConfig.builder()
                .serviceUrl("http://127.0.0.1:9000")
                // 需要跟网关中配置一致
                .signSecret("123456")
                .signType(SignTypeEnum.HMAC_SHA256)
                .build();
        DaxPayKit.initConfig(config);
    }
    @Test
    public void simplePay() {
        // 简单支付参数
        SimplePayParam param = new SimplePayParam();
        param.setBusinessNo("P0001");
        param.setAmount(1);
        param.setTitle("测试支付宝支付");
        param.setChannel(PayChannelEnum.ALI.getCode());
        param.setPayWay(PayWayEnum.QRCODE.getCode());
        DaxPayResult<PayOrderModel> execute = DaxPayKit.execute(param, true);
        System.out.println(execute);
        PayOrderModel data = execute.getData();
        System.out.println(data);
    }
}