YeautyYE / Justpay

感谢、致敬

感谢xxpay聚合支付的开源！这是个很棒的项目~本项目在xxpay中学到了很多好的思想及代码规范！ XxPay官网：http://www.xxpay.org

感谢Binary Wang的开源微信支付sdk，里面实现好了绝大多数微信支付的功能，使得我们简单的去调用(他还有很多关于微信的tool) Binary Wang主页：https://github.com/binarywang

项目介绍

• Justpay 使用Java开发，使用spring-boot2.0.0、dubbox实现SOA的分布式架构
• 只完成与支付相关的功能（支付、回调、查询、退款），没有其它业务逻辑相关模块，可直接接入生产环境
• 不同功能拆分成不同的服务，使得不同的支付服务更容易根据并发进行集群（可插拔）
• 使用了spring-boot2.0.0中新集成的spring-webflux (reactor)
• 目前实现了微信支付（4种模式：NATIVE、JSAPI、APP、MWEB），支付宝支付（4种模式：PC、WAP、APP）
• Justpay架构图
• Justpay接入到原系统中的架构位置

项目结构

justpay
├── justpay-common -- 公共模块
|    ├── justpay-config-interface -- 配置服务接口
|    ├── justpay-config-pojo -- 支付配置相关类
|    └── justpay-config-service -- 配置服务生产者
├── justpay-dispatcher -- 功能分发层
|    ├── justpay-dispatcher-interface -- 功能分发层接口
|    └── justpay-dispatcher-service -- 功能分发层服务生产者
└── justpay-pay -- 支付服务
     ├── justpay-pay-ali -- 支付宝支付
     |    ├── justpay-pay-ali-interface --支付宝接口
     |    └── justpay-pay-ali-service -- 支付宝服务生产者
     └── justpay-pay-wechat -- 微信支付
          ├── justpay-pay-wechat-interface --微信接口
          └── justpay-pay-wechat-service -- 微信服务生产者

说明

• 项目启动顺序：
  • justpay-pay-ali-service、justpay-pay-wechat-service > justpay-dispatcher-service

Dubbox

• 进入https://github.com/dangdangdotcom/dubbox ，将源码下载（当当网没有提交上maven仓库，所以不能直接从中央仓库依赖）；打包进本地仓库

mvn clean install -DskipTests

快速启动

1. 修改配置服务中的支付宝/微信配置文件
   
2. 修改启动项目中的zookeeper地址（这里使用的是dev配置，对于配置的切换请参考spring-boot文档）
   
3. 启动项目（ justpay-pay-ali-service、justpay-pay-wechat-service > justpay-dispatcher-service；推荐使用debug启动）
   
4. 测试项目是否正常

• 在浏览器输入 http://localhost:9093/pay/wechat_native/qrcode/1/微信测试商品/order_no_001 查看是否出现二维码，用微信扫一扫，是否金额为0.01
• 在浏览器输入 http://localhost:9093/pay/ali_pc/page/1/支付宝测试商品/order_no_001 查看是否跳转到支付宝支付页面，是否金额为0.01
• 如果都没问题~恭喜你！项目已经完美的启动了！

接入

项目接入方式有多种

• Dubbox : 将功能分发层中的接口(DispatcherService)复制到业务逻辑模块，通过Dubbox调用即可
  
• HTTP : 将请求发送到分发层的controller中（PayController中的build方法仅将参数适配到DispatcherService中，NotifyController简单适配了回调、QueryController简单适配了查询、RefundController简单适配了退款；PayController中还包含spring-webflux写出支付宝支付页面、微信支付二维码的展示代码）
• 其它RPC方式 : Thrift、GRPC等，只需对DispatcherService进行加强即可

测试用例(针对:DispatcherService进行测试)

• 在justpay-dispatcher-service的test里面有所有操作的测试用例，可以直接设置参数进行测试
• 也可以通过HTTP请求controller进行测试

API列表(入口:DispatcherService)

参数说明

下单请求

回调请求

查询请求

退款请求

下单响应

回调响应

查询响应

退款响应