在developer开发需要包含支付模块的系统时，通常会同时适配微信、支付宝、云闪付等第三方支付平台。通常，developer需要对多个平台进行适配。这些工作具有类似的对接流程，但是API却各成一派，大不相同。对接三家支付平台，就意味着您需要同时阅读三份API文档，维护三套代码。

MatrixPay(目标): 使用一套文档，一套API同时对接三家支付平台。

图片，以前的对接方式。 现在的对接方式

二、Matrix API风格

Matrix API本质是对支付平台官方或第三方API进行二次封装，让其有相同的入参返回值（包括错误码）。这样的好处是可以享受SDK本身升级带来的红利。

Matrix 使用非常受欢迎的Java微信支付开发包 WxJava 相同的API风格，您可以无缝将自己的项目切换到Matrix Pay。并且对于熟悉 WxJava API的开发者更加友好。

三、快速开始

3.1. 下载代码

您可以在国内开源社区Gitee下载（推荐）：https://gitee.com/iotechn/matrix-pay

您可以在国际开源社区Github下载：https://github.com/iotechn/matrix-pay

分支约定

① master： 基本可用的最新版本

② develop：正在开发的版本，不保证能用

③ release：发行版，经过测试过，较稳定版本

3.2. maven引入

请确定您已经将 JAVA_HOME 配置，并将mvn命令配置到PATH中，若出现找不到命令，或找不到JAVA_HOME，请参考此文档

在项目根目录，打开命令行。并执行 ：

mvn install -Dmaven.test.skip=true

引入maven坐标到工程pom.xml文件中。

<groupId>com.dobbinsoft</groupId>
<artifactId>fw-pay</artifactId>
<version>1.0-SNAPSHOT</version>

3.3. 使用Spring集成

1. 写一个实现类，实现 com.dobbinsoft.fw.pay.config.PayProperties，此类用于MatrixPay获取配置文件。

2. // 编写支付成功回调通知处理类，实现Handler即可
   package com.dobbinsoft.fw.pay.handler.MatrixPayCallbackHandler;
   
   public interface MatrixPayCallbackHandler {
   
      /**
       * 在校验回调之前调用，可以在此添加上下文
       * @param request
       */
      void beforeCheckSign(HttpServletRequest request);
   
      /**
       * 默认入参 PayOrderNotifyResult
       * @param result
       * @param request 原始请求
       * @return
       */
      Object handle(MatrixPayOrderNotifyResult result, HttpServletRequest request);
   
   }

3. // 将所有Handler加入到IoC中，并指派回调通知链接。并将MatrixPayService加入IoC
   @Configuration
   public class PayConfig {
   
      @Bean
      public PayProperties payProperties() {
          return new PayMerchantPropertiesImpl();
      }
   
      @Bean
      public MatrixPayService matrixPayService() {
          return new MatrixPayServiceImpl(payProperties());
      }
   
      @Bean
      public CheckstandMatrixPayCallbackHandler checkstandMatrixPayCallbackHandler() {
          return new CheckstandMatrixPayCallbackHandler();
      }
   
      @Bean
      public ServletRegistrationBean servletRegistrationBean() {
          Map urlHandlerMap = new HashMap<>();
          urlHandlerMap.put("/cb/unify", checkstandMatrixPayCallbackHandler());
          return new ServletRegistrationBean(new PayHttpCallbackServlet(matrixPayService(), urlHandlerMap), urlHandlerMap.keySet().toArray(new String[]{}));
      }
   
   }

4. 支付下单，matrixPayService.createOrder

四、完整文档

Matrix Pay API文档：

五、特别注意

Matrix 并没有接入支付全套API。仅仅接入了之前用到的API。

请查看以下列表是否满足您的业务需求：

1. 统一下单 createOrder
2. 查询订单 queryOrder
3. 关闭订单 closeOrder
4. 订单退款 refund
5. 退款查询 refundQuery
6. 当面付 micropay

...若需要其他接口，请自行适配，欢迎将您的贡献PR到本仓库。特别感谢！

六、贡献 & 社区

Matrix Pay 在API适配中，也许您所需要适配的字段，映射存在偏差或框架存在BUG，您可以直接在仓库中发布Pull Request。本项目欢迎所有开发者一起维护，并永久开源。

Matrix Pay 统一支付开源SDK最先出现在道宾云dobbinsoft。

(English Documents Available)

社区版

Unimall 针对中小商户、企业和个人学习者开发。使用Java编码，采用SpringBoot、Mybatis-Plus等易用框架，适合个人学习研究。同时支持单机部署、集群部署，中小商户企业可根据业务动态扩容。unimall使用uniapp前端框架，可同时编译到 微信小程序、H5、Android App、iOS App等几个平台，可为中小商户企业节约大量维护成本。也可支撑中小商户企业前期平台横扩需求。

Unimall社区版源码包含:

• Java 后端服务
  • unimall-runner: 启动器（打包打这个就行）
  • unimall-admin-api: 提供管理员管理系统的WebApi
  • unimall-app-api: 提供APP、小程序、H5用户请求的WebApi
  • unimall-biz: 提供通用业务代码
  • unimall-data: 提供数据模型以及数据访问层封装
  • Vue 前端页面
  • unimall-admin: 基于element-ui的后台管理页面
  • unimall-app: 基于uniapp的小程序、H5、APP前端代码
• sql: 数据库初始化SQL脚本

About this repository 关于

• release: 已经发布的分支
• develop: 正在开发的分支
  • develope-v3: 此分支已经完全测试过，但还没上过生产，可直接使用

Contact 联系

QQ讨论群：656676341(1群已满) 940197916(2群已满) 936569693(3群) (进群前，请在网页右上角点star)

微信群： (微信群二维码超100人，请加此微信备注意图，接受邀请)

Experience 体验

• Client
  • 扫描下面二维码体验不同终端 （体验APP使用浏览器扫码）

• Pages

• Admin
  • 后台演示地址: https://unimall.v3.dobbinsoft.com
  • 登录名:guest 密码:123456 验证码:666666 (guest仅有只读权限，无读配置权限)
• Pages

New Features (v3) 新特性v3

描述
- 框架： 支持对象、字段注解生成文档
- 框架： 添加数据库扩展
- 框架： 支持滑动窗口Api限流
- 框架： 对接腾讯云对象存储
- 框架： 支持开放平台
- 功能： 添加用户在线支付开通、续费VIP
- 功能： 对接App支付宝在线支付
- 功能： 对接支持道宾云ERP进销存系统

The Framework 架构

Getting started 快速开始

服务器可根据自身业务来选购，单机环境推荐2C4G

方式一： docker 运行

视频教程： https://www.bilibili.com/video/BV1db4y1e7Vi/

文档教程：点击查看

方式二（推荐）： 编译运行

视频教程：https://www.bilibili.com/video/BV1EL4y1J7w5/

文档教程：文档1 文档2 文档3

Document 文档

框架v3文档

Copyright 版权

本项目后端由重庆驽驹科技有限公司开发，您可以在以任何方式部署或修改源代码。

前端代码使用的 mix.R 的开源模板，在此模板的基础上对接了Unimall后端Api，作者说不做商用限制，保留原地址，所以授权仅针对后端代码商用授权。

mix模板地址：https://ext.dcloud.net.cn/plugin?id=200

Service 服务

一、项目定制开发服务

若需要软件需求外包，小程序、App、网站、微信定制开发，请联系微信：dobbinsoft（请备注意图）

二、电商小程序 SaaS 服务 (无代码快速上线微信小程序)

对于缺少技术的创业团队来说，使用SaaS服务即可解决掉技术问题。简单的说，就是由我们为客户统一运维，每年付一定的钱给我们就行了。

Unimall SaaS版每年980元。这个价格就和服务器的价格差不多，并且我们还可以免费代申请微信小程序，这可以节约300元的认证费。

使用Unimall SaaS版的优势1：

功能	Unimall 开源版	Unimall Pro SaaS
拖拽功能布局
主题引用（一键引入自己行业主题）
商品管理
订单管理
运费模板
O2O骑手配送
云订单打印 直接出小票
商品团购
优惠券
页面广告配置
类目管理
三级分销（渠道分销）
用户分销 用户推广获得返佣
好友砍价 邀请好友砍价
商品秒杀
积分 签到/购买商品 获取积分
VIP卡 以VIP价格购买
服务商品-扫码核销
服务商品-资源编排
专属客服
系统优化（不另收费）
费用	免费商用（不可二次出售或再次开源）	980/年 无需服务器费用

使用Unimall SaaS版的优势2：更多模板

DG模板(可拖拉拽页面)	Mix模板（开源Mix+更多功能)	FA模板（精美生鲜/前置仓)

支持试用：https://console.dobbinsoft.com/

注册账号，即可免费试用，试用规则： 未上线，不记时间，上线后，可免费试用7天。

Contributing 贡献

如果你有好的意见或建议，欢迎给我们提 Issues 或 Pull Requests，为Unimall开源商城贡献力量。关于分支/issue及PR。

Unimall 开源商城最先出现在道宾云dobbinsoft。

Unimall Pro SaaS服务最先出现在道宾云dobbinsoft。

ERP进销存管理系统最先出现在道宾云dobbinsoft。