https://github.com/deific/supay
极简（super）支付系统
https://github.com/deific/supay
pay payment
Last synced: 6 months ago
JSON representation
极简（super）支付系统
- Host: GitHub
- URL: https://github.com/deific/supay
- Owner: deific
- License: apache-2.0
- Created: 2020-05-15T13:57:28.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2025-06-29T03:23:36.000Z (about 1 year ago)
- Last Synced: 2025-06-29T04:26:29.408Z (about 1 year ago)
- Topics: pay, payment
- Language: Java
- Homepage:
- Size: 1.48 MB
- Stars: 3
- Watchers: 0
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# supay
### [极简（super）支付系统](https://gitee.com/orangesoft/supay)
极简(super)支付系统，抽象统一简化接口，轻量级可扩展的支付SDK封装，支持微信、支付宝等主流应用，让支付接入更简洁。提供了优雅架构设计的支付工具包和完善的支付系统。
[](https://gitee.com/geekgarden/supay/stargazers)
[](https://gitee.com/geekgarden/supay/members)
Gitee：[https://gitee.com/geekgarden/supay](https://gitee.com/geekgarden/supay)
GitHub：[https://github.com/deific/supay](https://github.com/deific/supay)
欢迎 Star，欢迎 PR！
## 特性
- 极少依赖,结构清晰，轻量级可扩展的工具包SDK,可嵌入任何系统
- 统一支付入口和方法,命名简化清晰,简化调用,隐藏开发者不需要关注的细节
- 高度抽象接口和出入参数数据bean，免去各种拼装和解析json与xml的痛苦
- 支持多商户多应用，随心切换
- 支持调用过滤器机制,可以灵活扩展调用逻辑,第三方接口灵活切换使用
- Context支付上下文设计,可以灵活控制和监控每一笔支付交易
## 运行环境
JDK1.8
## 安装
### maven仓库安装
暂未发布上传到maven中央仓库，请先git clone到本地安装测试！
## 支持方法
请先熟悉支付宝/微信支付流程和机制，请具有基本的 debug 能力，本质上我们还是调用的是它们的接口！！！！
| 方法 | 说明 | 微信 | 支付宝 |
| :---------- | :----------- | :--- | :----- |
| web | 电脑支付 | 无 | 支持 |
| wap/H5 | 手机网站支付 | 支持 | 支持 |
| app | APP 支付 | 支持 | 支持 |
| face | 刷卡支付 | 支持 | 支持 |
| scan | 扫码支付 | 支持 | 支持 |
| mini | 小程序支付 | 支持 | 支持 |
| mp | 公众号支付 | 支持 | 无 |
| refund | 退款 | 支持 | 支持 |
| query | 支付查询 | 支持 | 支持 |
| refundQuery | 退款查询 | 支持 | 支持 |
| notify | 通知 | 支持 | 支持 |
## 痛点
调用第三方支付系统通常在自身业务中中经常遇到，支付流程总的来说大差不多，但各大第三方支付系统，银行的支付接口各自不一样：
- 接口签名方法不一样
```java
例如:微信和支付宝的接口签名算法不一样,有的还需要有证书,有的不需要
```
- 参数要求不一样，传输格式不一样
```java
例如:同样一笔支付请求,微信和支付的支付参数要求不一样,简单点的可以几个参数,复杂的几十个参数.微信用xml传输,支付宝用json等
```
- 接口交互方式不一样
```java
例如:有的接口是直接返回交易结果数据,有的接口实际返回html片段,需要在浏览器再次提交
```
这些不一样的地方造成开发人员在对接支付系统时，不得不去详细了解各个第三方支付系统自身的实现机制，还需要考虑自身业务在使用不同渠道时如何设计路由等。
更过情况下，可能会在不同项目中复制粘贴代码的方式去复用代码，容易出错，而且对于其他人员接手又需要了解支付的机制。
## 设计
基于上述痛点的考虑，supay的力图在一个统一层面消除不同支付系统接口的不一致性，对于业务暴露出统一的支付交互接口和交互流程，降低业务系统方使用支付的
难度，统一成一套流程，并且提供扩展性。
- 抽象和统一支付交易流程，屏蔽支付系统差异
- 内部架构设计支付扩展第三方支付系统
**设计思路请参考 [wiki](https://gitee.com/geekgarden/supay/wikis/supay%20%E6%9E%81%E7%AE%80%E6%94%AF%E4%BB%98) 设计文档**
工具包可单独使用，通过整合、抽象、聚合第三方支付系统接口，对外提供简洁的使用和调用接口完成第三方支付接口（微信,支付宝,银联等等）调用，实现了扫码支付、H5支付、小程序支付等，支付与业务完全剥离，简单几行代码即可实现支付，简单快速完成支付模块的开发，可轻松嵌入到任何系统里。并且采用灵活的扩展性架构，以便实现更多的第三方支付接口。
支付系统完善的支付系统。包括商户管理，用户账户体系，支付管理，支付路由，订单管理，上下游对账，清结算等支付核心功能，目标是打造一个开源的完善的可扩展的用于生产的支付系统。
**supay思维导图**
## 示例&效果
**简单Demo**
简单的支付demo，使用配置文件配置相关支付参数，直接执行main函数运行
Gitee：[supay-simaple-demo](https://gitee.com/geekgarden/supay/tree/master/supay-demo/supay-simaple-demo)
GitHub： [supay-simaple-demo](https://github.com/deific/supay/tree/master/supay-demo/supay-simaple-demo)
**springboot版本 Demo**
基于springboot体系搭建的demo,通过api接口调用处方
Gitee：[supay-boot-demo](https://gitee.com/geekgarden/supay/tree/master/supay-demo/supay-boot-demo)
GitHub： [supay-boot-demo](https://github.com/deific/supay/tree/master/supay-demo/supay-boot-demo)
### 普通用法
```java
String orderCode = IdUtil.fastSimpleUUID();
// 阿里支付调用
// 构建支付上下文
SupayContext cxt = AliPayPageRequest.builder()
.outTradeNo(orderCode)
.payType(SupayPayType.ALI_PAGE_PAY)
.subject("测试网页支付")
.totalAmount("1")
.returnUrl("http://taobao.com")
.build().toContext(channelConfig.getAppId(), false);
// 本地模拟支付
cxt.setLocalMock(true);
// 调用支付接口
cxt = (SupayContext) SupayCore.pay(cxt);
log.debug("交易状态：{} 信息：{} 耗时：{}ms 接口响应数据：{}", cxt.hasError(),
cxt.getMsg(), cxt.duration(), JSONUtil.toJsonStr(cxt.getResponse()));
// 微信支付调用
// 构建支付上下文
SupayContext cxt = WxPayUnifiedOrderRequest.builder()
.body("测试微信支付订单")
.outTradeNo(orderCode)
.productId("12")
.notifyUrl("https://www.spay.org.cn/notify")
.totalFee("100")
.timeStart(DateUtil.format(new Date(), "yyyyMMddHHmmss"))
.timeExpire(DateUtil.format(DateUtil.offsetMinute(new Date(), 15), "yyyyMMddHHmmss"))
.tradeType(SupayPayType.WX_MP_PAY.getCode())
.openid(props.getStr("wx.openId"))
.spbillCreateIp("127.0.0.1")
.nonceStr(String.valueOf(System.currentTimeMillis()))
.build().toContext(channelConfig.getAppId(), false);
// 调用支付接口
cxt = (SupayContext) SupayCore.pay(cxt);
if (!cxt.hasError()) {
cxt.getResponse();
}
log.debug("交易状态：{} 信息：{} 耗时：{}ms 接口响应数据：{}", cxt.hasError(), cxt.getMsg(), cxt.duration(), cxt.getResponse());
// 查询支付订单
WxPayOrderQueryRequest qReq = WxPayOrderQueryRequest.builder().outTradeNo(orderCode).build();
SupayContext qCtx = SupayContext.buildContext(channelConfig, qReq, false);
// SupayCore.queryPayOrder(qCtx);
// 获取具体渠道支付服务
ChannelPayService wxPayChannelService = SupayCore.getPayChannelService(SupayChannelType.WECHAT);
wxPayChannelService.queryTradeInfo(qCtx);
log.debug("查询结果：{}", qCtx.getResponse());
```
### 简洁用法
在大多数支付业务场景中，使用到的只有支付、退款、查询等几个高频业务接口，多数情况下也只要需要知道和传输几个必要的参数，所有针对高频接口我们又做了更简洁静态方法封装，调用更明确清晰，参数更简洁。
特性：
- 统一Supay核心入口
- 明确的静态方法
- 必要简洁的业务参数
- 几行代码完成
- 过滤器机制，全程可监控扩展
```java
// 扫码支付，根据appId的配置自动识别微信，支付宝
String orderCode = IdUtil.fastSimpleUUID();
String qrCodeUrl = Supay.scanPay(channelConfig.getAppId(), "测试支付", orderCode, new BigDecimal(0.01), "https://www.spay.org.cn/notify");
log.debug("二维码支付内容：{}", qrCodeUrl);
// app支付
String orderCode = IdUtil.fastSimpleUUID();
String appParamJson = Supay.appPay(channelConfig.getAppId(), "测试支付", orderCode, new BigDecimal(0.01), "https://www.spay.org.cn/notify");
log.debug("app支付内容：{}", appParamJson);
// 退款
String orderCode = IdUtil.fastSimpleUUID();
String refundCode = IdUtil.fastSimpleUUID();
Supay.refund(channelConfig.getAppId(), orderCode, refundCode, new BigDecimal(0.01), new BigDecimal(0.01), "https://www.spay.org.cn/notify");
```
## 统一支付入口Supay
抽象各个第三方渠道支付接口和调用过程，统一支付SupayCore提供入口，对于不同的第三方渠道支付，Supay的方法入参和返回值不同。并且调用过程中增加了过滤器设计，可以灵活扩展各渠道调用过程。
## 进度&计划
开发中
### 贡献代码
最后如果该库对你有帮助，不妨右上角点点 Star或者任意赞助支持，我更喜欢你 Fork PR 成为项目贡献者 .
## 支付官方文档
主要的第三方支付接口文档。
- [微信委托扣款 API-服务商模式](https://pay.weixin.qq.com/wiki/doc/api/pap_sl.php?chapter=17_1)
- [微信委托扣款 API-普通商户模式](https://pay.weixin.qq.com/wiki/doc/api/pap.php?chapter=17_1)
- [支付宝开发平台](https://docs.open.alipay.com)