pay-spring-boot 开箱即用的Java支付模块，整合支付宝支付、微信

本文主要是介绍pay-spring-boot 开箱即用的Java支付模块，整合支付宝支付、微信，对大家解决编程问题具有一定的参考价值，需要的程序猿们随着小编来一起学习吧！

　　关于

　　使用本模块，可轻松实现支付宝支付、微信支付对接，从而专注于业务，无需关心第三方逻辑。

　　模块完全独立，无支付宝、微信SDK依赖。

　　基于Spring Boot。

　　依赖Redis。

　　我能做什么

　　支付宝：电脑网站支付、手机网站支付、扫码支付、APP支付。

　　微信：电脑网站支付(同扫码支付)、手机网站支付(微信外H5支付)、扫码支付、APP支付、JSAPI支付(微信内H5支付)。

　　统一支付方法。

　　异步回调封装。

　　订单状态查询。

　　退款。

　　公对私转账。

　　请确保支付宝、微信帐号已经申请了相应业务、权限

　　模块集成

　　只需要简单的、非侵入式的配置，即可集成到项目中。

　　添加模块到Maven项目中

　　父项目中添加pay-spring-boot模块依赖(pom.xml)：

　　1

　　2 ...

　　3 pay-spring-boot

　　4 ...

　　5

　　修改pay-spring-boot的父项目(pom.xml)：

　　1

　　2 yourself parent groupId

　　3 yourself parent artifactId

　　4 yourself parent version

　　5

　　支付凭证

　　在application.yml(或application-*.yml，视项目具体情况而定)中添加如下配置：

　　pay:

　　wx:

　　appid: wx1d96c6yxxc0d192a

　　mchid: 1519719912

　　key: A6nvI8Xp6A6nvI8Xp6A6nvI8Xp6

　　notifyURL: xxx/wxpay/notify

　　certPath: /data/cert/wx/apiclient_cert.p12

　　certPassword: 1517923901

　　ali:

　　appid: 2021138363328891

　　privateKey: MIIEuwIBADANBgkqhkiG9w...

　　notifyURL: xxx/alipay/notify

　　关于配置项的具体含义参考AliPayConfig、WxPayConfig两个类，里边有详细说明。

　　注入Redis连接池

　　在项目中创建一个Redis连接池工厂实现类，名称无所谓，必须实现RedisResourceFactory接口，然后添加@ResourceFactoryComponent注解，例如：

　　1 @ResourceFactoryComponent

　　2 public class DefaultRedisResourceFactory implements RedisResourceFactory {

　　3 @Override

　　4 public JedisPool getJedisPool() {

　　5 /*

　　6 框架不关心JedisPool是怎么来的

　　7 这里的RedisService是我自己实现的服务

　　8 根据项目实际情况换成你自己的实现

　　9 */

　　10 return RedisService.getPool();

　　11 }

　　12 }

　　如何支付

　　一般来说，项目中会有不同的支付场景，比如：购买商品、充值等支付业务。

　　现在用商品购买举例，通过这个例子展示如何使用框架。

　　创建支付适配器

　　支付适配器是支付模块和数据访问层的桥梁，适配器将支付结果抽象成支付成功(doPaySuccess)、支付失败(doPayFail)、退款成功(doRefundSuccess)、退款失败(doRefundFail)四种情况，代表了四个状态。

　　建议不同的场景使用不同的适配器，不要所有业务逻辑都放一起。

　　创建订单的操作，也建议放在适配器中实现。

　　以下是商品适配器例子：

　　1 @Service

　　2 public class GoodsTradeService extends AbstractPayAdaptor {

　　3

　　4 @Autowired

　　5 private GoodsTradeManager goodsTradeManager;

　　6 ?

　　7 /**

　　8 * 创建订单

　　9 * @param id 商品id

　　10 * @return

　　11 */

　　12 public Message createOrder(long id){

　　13

　　14 }

　　15 ?

　　16 @Override

　　17 public void doPaySuccess(String outTradeNo) {

　　18 //支付成功，这里一般要更新数据库的状态

　　19 }

　　20 ?

　　21 @Override

　　22 public void doPayFail(String outTradeNo) {

　　23 //支付失败，这里一般要更新数据库的状态

　　24 }

　　25 ?

　　26 @Override

　　27 public void doRefundSuccess(String outTradeNo) {

　　28 //退款成功，这里一般要更新数据库的状态

　　29 }

　　30 ?

　　31 @Override

　　32 public void doRefundFail(String outTradeNo) {

　　33 //退款失败，这里一般要更新数据库的状态

　　34 }

　　35 }

　　看起来非常简单，继承AbstractPayAdaptor抽象类，然后通过@Service注解交给Spring管理，为什么要交给Spring呢？因为这里你需要注入数据访问层的实例(Dao)，不然怎么操作数据库，只不过我这没有写而已~

　　这里有一个GoodsTradeManager，是接下来要介绍的支付管理器，先不管它。

　　仔细观察会发现，示例中的适配器名称叫GoodsTradeService，为什么我不管他叫GoodsTradePayAdaptor呢？从支付框架的角度看，这的确是一个适配器实现，但从业务的角度看，它是商品订单的服务中心，不仅要处理订单状态，还要承担创建订单的职责，它底层(数据库层)关联的本来就是一个订单表，把它称作订单服务，更加容易理解。

　　因此，所谓的适配器，就是用来适配支付框架和数据访问层的。

　　创建支付管理器

　　有了适配器，就有了数据访问的能力，再配上一个管理器作为统一调度中心，那么支付这事就搞定了，实现一个管理器非常容易：

　　1 @PayManagerComponent

　　2 public class GoodsTradeManager extends AbstractPayManager {

　　3 ?

　　4 @Autowired

　　5 private GoodsTradeService goodsTradeService;

　　6 ?

　　7 @Override

　　8 public String getTradeType() {

　　9 return "0";

　　10 }

　　11 ?

　　12 @Override

　　13 public AbstractPayAdaptor getPayAdaptor() {

　　14 return goodsTradeService;

　　15 }

　　16 }

　　首先继承AbstractPayManager，然后使用@PayManagerComponent注解注册管理器，这没什么神奇的，只不过是告诉框架这里有一个管理器，并且把这个管理器交给Spring维护。

　　getTradeType方法返回长度为1的字符串，建议取值范围[0-9a-z]，类型会拼接到订单号中，所以不建议使用特殊字符。因此，一个项目中最多可创建36个不同的管理器。

　　getPayAdaptor方法返回上一步创建的适配器，管理器中包含了适配器。

　　因此，所谓的管理器，管理的目标就是适配器，同时担负起统一支付调度的重任，管理器是支付模块的窗口。

　　最佳实践是：每对管理器-适配器对应一种支付业务。

　　发起支付

　　接下来就可以发起支付了，非常简单，先来看一个支付宝扫码支付示例：

　　1 Trade trade=AliTrade

　　2 .qrcodePay()

　　3 .subject("商品标题")

　　4 .body("商品描述")

　　5 .outTradeNo(goodsTradeManager.newTradeNo("你自己的用户唯一标识"))

　　6 .totalAmount("0.01")

　　7 .build();

　　8 TradeToken token=goodsTradeManager.qrcodePay(trade);

　　9 String url=token.value();

　　先通过AliTrade构造器的qrcodePay方法创建一个扫码支付订单，然后调用管理器的qrcodePay方法生成订单凭证，不同的支付产品的订单凭证可能不同，你可以自由选择泛型，扫码支付的凭证就是一个url链接，因此我使用的String类型，调用凭证的value方法，即可获得凭证内容，凭证内容直接返回给前端(网页或APP)，前端即可调起支付。

　　goodsTradeManager上一步已经创建好，直接@Autowired注入即可。

　　newTradeNo方法非常重要，它可以帮你生成一个订单号，也就是商户订单号，在我的设计中，为了省去繁琐的全局唯一订单号生成，将订单号和用户关联起来，规避了订单号唯一性问题，用户唯一标识根据你的系统自由选择，建议长度在[6-10]之间，并且为固定长度，不能使用特殊字符，用户唯一标识会直接拼接到订单号中，长度不固定或太长的话，订单号会非常难看，不规范，如需更多了解，直接看代码注释。

　　AliTrade构造器所有的属性均与支付宝官方文档相对应，具体含义参考代码注释或者支付宝官方文档。

　　订单的类型AliTrade.qrcodePay和管理器方法

　　goodsTradeManager.qrcodePay必须配套使用。

　　再来看一个微信H5支付的例子：

　　1 Trade trade=WxTrade

　　2 .webMobilePay()

　　3 .body("商品标题")

　　4 .outTradeNo(goodsTradeManager.newTradeNo("你自己的用户唯一标识"))

　　5 .totalFee("1")

　　6 .spbillCreateIp("127.0.0.1")

　　7 .sceneInfo("商品测试场景")

　　8 .build();

　　9 TradeToken token=goodsTradeManager.webMobilePay(trade);

　　10 String url=token.value();

　　只不过是把AliTrade换成了WxTrade，然后调用WxTrade.webMobilePay构造器，加上配套的

　　goodsTradeManager.webMobilePay即可完成微信H5支付。

　　微信H5支付的凭证也是一个url，直接交给前端处理即可。

　　由此可以看出，我们只需要关心订单构造器，将订单构造好，直接调用管理器对应的方法即可，管理器不关心支付宝还是微信，只需要接收一个配套的订单，最后拿到订单凭证，就算是完工了。

　　依此类推，即可完成其它类型的支付业务。

　　异步回调

　　涉及钱的事没有小事，别忘了还有支付结果异步回调。

　　前端的支付结果回调是同步回调，仅供参考，必须以后端的结果为准。

　　支付宝回调：

　　1 @PostMapping(value="/notify")

　　2 public void notify(HttpServletRequest request, HttpServletResponse response){

　　3 /*

　　4 解析请求参数

　　5 */

　　6 Map<String, String> params=NoticeManagers.getDefaultManager().receiveAliParams(request);

　　7

　　8 /*

　　9 封装

　　10 */

　　11 AliPayNoticeInfo info=new AliPayNoticeInfo();

　　12 TradeStatus status=NoticeManagers.getDefaultManager().execute(params, info);

　　13

　　14 /*

　　15 持久化回调数据

　　16 */

　　17 //TODO: 强烈建议将AliPayNoticeInfo持久化到数据库中，以备不时之需，当然你也可以忽略

　　18

　　19 /*

　　20 业务分发

　　21 */

　　22 AbstractPayManager payManager=(AbstractPayManager) PayManagers.find(status.getTradeNo());

　　23 payManager.doTradeStatus(status);

　　24

　　25 /*

　　26 响应

　　27 */

　　28 NoticeManagers.getDefaultManager().sendAliResponse(response);

　　29 }

　　微信回调：

　　1 @PostMapping(value="/notify")

　　2 public void notify(HttpServletRequest request, HttpServletResponse response){

　　3 /*

　　4 解析请求参数

　　5 */

　　6 Map<String, String> params=NoticeManagers.getDefaultManager().receiveWxParams(request);

　　7

　　8 /*

　　9 封装

　　10 */

　　11 WxPayNoticeInfo info=new WxPayNoticeInfo();

　　12 TradeStatus status=NoticeManagers.getDefaultManager().execute(params, info);

　　13

　　14 /*

　　15 持久化回调数据

　　16 */

　　17 //TODO: 强烈建议将WxPayNoticeInfo持久化到数据库中，以备不时之需，当然你也可以忽略

　　18

　　19 /*

　　20 业务分发

　　21 */

　　22 AbstractPayManager payManager=(AbstractPayManager) PayManagers.find(status.getTradeNo());

　　23 payManager.doTradeStatus(status);

　　24

　　25 /*

　　26 响应

　　27 */

　　28 NoticeManagers.getDefaultManager().sendWxResponse(response);

　　29 }

　　最基本的Spring MVC Controller代码不用我教了吧。

　　定义一个控制器，接收HTTP请求、响应对象，通过框架解析出参数和订单状态，然后将订单状态分发给适配器，实现订单状态更新，最后给支付宝、微信一个响应，告诉他们已经接收到请求。

　　回调处理非常规范化，基本不需要做什么改动(直接Copy)，唯一需要做的，也是非常重要的，就是根据你自己项目的实际情况，以恰当的方式持久化回调数据。

　　这里的@PostMapping请求路径，就是配置在application.yml中的notifyURL，必须保证公网可以无障碍访问。

　　主动同步订单状态

　　用来弥补特殊原因造成的异步回调丢失，异步回调不是100%可靠的。

　　由于需要请求支付宝、微信服务器，所以速度较慢。

　　支付宝订单：

　　1 Trade trade=AliTrade.query().outTradeNo("商户订单号").build();

　　2 TradeStatus status=goodsTradeManager.status(trade);

　　3 status.isPaySuccess(); //是否支付成功，其它状态不一一列举，自行看代码

　　微信订单：

　　1 Trade trade=WxTrade.basic().outTradeNo("商户订单号").build();

　　2 TradeStatus status=goodsTradeManager.status(trade);

　　3 status.isPaySuccess(); //是否支付成功，其它状态不一一列举，自行看代码

　　如何转账

　　公对私转账

　　由公司帐号向个人帐号转账。

　　支付宝转账：

　　1 /*

　　2 构造转账订单

　　3 */

　　4 AliTransferTrade transferTrade=AliTransferTrade

　　5 .transfer()

　　6 .outBizNo("商户转账唯一订单号")

　　7 .payeeAccount("收款人支付宝帐号")

　　8 .amount("0.01")

　　9 .build();

　　10

　　11 /*

　　12 转账

　　13 */

　　14 try{

　　15 AliTransfer.getInstance().transfer(transferTrade);

　　16 }catch (TransferException e){

　　17 // 转账失败处理逻辑...

　　18 }

　　转账方法无返回值，不发生异常代表转账成功，发生异常代表转账失败，自行处理。

　　订单参数含义参考支付宝官方文档或代码注释。

　　微信转账：

　　1 /*

　　2 构造转账订单

　　3 */

　　4 WxTransferTrade transferTrade=WxTransferTrade

　　5 .transfer()

　　6 .partnerTradeNo("商户转账唯一订单号")

　　7 .openid("收款人openid")

　　8 .amount("1")

　　9 .spbillCreateIp("127.0.0.1") //这里是调用接口的服务器公网IP，自行获取

　　10 .build();

　　11 /*

　　12 转账

　　13 */

　　14 try{

　　15 WxTransfer.getInstance().transfer(transferTrade);

　　16 }catch (TransferException e){

　　17 // 转账失败处理逻辑...

　　18 }

　　转账方法无返回值，不发生异常代表转账成功，发生异常代表转账失败，自行处理。

　　订单参数含义参考微信官方文档或代码注释。

　　转账状态查询

　　支付宝：

　　1 /*

　　2 构造转账查询订单

　　3 */

　　4 AliTransferTrade transferTrade=AliTransferTrade

　　5 .query()

　　6 .outBizNo("商户转账唯一订单号")

　　7 .build();

　　8 /*

　　9 转账查询

　　10 */

　　11 TransferStatus status=AliTransfer.getInstance().status(transferTrade);;

　　12 status.isSuccess(); //转账成功，其他状态自行查看代码，不一一列举

　　微信：

　　1 /*

　　2 构造转账查询订单

　　3 */

　　4 WxTransferTrade transferTrade=WxTransferTrade

　　5 .custom()

　　6 .partnerTradeNo("商户转账唯一订单号")

　　7 .build();

　　8 /*

　　9 转账查询

　　10 */

　　11 TransferStatus status=WxTransfer.getInstance().status(transferTrade);;

　　12 status.isSuccess(); //转账成功，其他状态自行查看代码，不一一列举

　　附加工具

　　获取客户端IP地址

　　微信支付大部分场景需要客户端IP地址，可以通过本模块

　　PayHttpUtil.getRealClientIp方法获取。

　　如果获取不到，请检查代理软件是否正确设置了X-Forwarded-For。

　　欢迎工作一到五年的Java工程师朋友们加入Java程序员开发： 721575865

　　群内提供免费的Java架构学习资料（里面有高可用、高并发、高性能及分布式、Jvm性能调优、Spring源码，MyBatis，Netty,Redis,Kafka,Mysql,Zookeeper,Tomcat,Docker,Dubbo,Nginx等多个知识点的架构资料）合理利用自己每一分每一秒的时间来学习提升自己，不要再用"没有时间“来掩饰自己思想上的懒惰！趁年轻，使劲拼，给未来的自己一个交代！

这篇关于pay-spring-boot 开箱即用的Java支付模块，整合支付宝支付、微信的文章就介绍到这儿，希望我们推荐的文章对大家有所帮助，也希望大家多多支持为之网！