大家好，我是 `Java陈序员`。随着电商的兴起，各种支付也是蓬勃发展。微信支付、支付宝支付、银联支付等各种支付方式可是深入到日常生活中。可以说，扫码支付给我们的生活带来了极大的便利。同时，随着市场需求的变化，这也要求我们在企业开发中，需要集成第三方支付渠道！我们在集成第三方支付渠道时，常规的操作是查阅官方文档、封装代码、测试联调等。今天，给大家介绍一个已经封装好各种支付渠道的项目，开箱即用，我们就不用重复手动造轮子了！ ## 项目介绍 `IJPay` 的宗旨是**让支付触手可及**。封装了微信支付、`QQ` 支付、支付宝支付、京东支付、银联支付、`PayPal` 支付等常用的支付方式以及各种常用的接口。不依赖任何第三方 `MVC` 框架，仅仅作为工具使用简单快速完成支付模块的开发，开箱即用，可快速集成到系统中。 **功能模块：** - **微信支付：** 支持多商户多应用，普通商户模式与服务商商模式当然也支持境外商户、同时支持 `Api-v3` 与 `Api-v2` 版本的接口 - **个人微信支付：** 微信个人商户，最低费率 `0.38%`，官方直连的异步回调通知 - **支付宝支付：** 支持多商户多应用，签名同时支持普通公钥方式与公钥证书方式 - **银联支付：** 全渠道扫码支付、微信 `App` 支付、公众号&小程序支付、银联 `JS` 支付、支付宝服务窗支付 - **PayPal 支付：** 自动管理 `AccessToken`，极速接入各种常用的支付方式 ## 项目安装 **一次性添加所有支付方式的依赖** ```xml com.github.javen205 IJPay-All latest-version ``` **或者选择某一个/多个支付方式的依赖，如：** **支付宝支付** ```xml com.github.javen205 IJPay-AliPay latest-version ``` **微信支付** ```xml com.github.javen205 IJPay-WxPay latest-version ``` 更多支付方式依赖参考： ``` https://javen205.gitee.io/ijpay/guide/maven.html#maven ``` ## 集成Demo **以支付宝支付为例。** ### 引入依赖 ```xml com.github.javen205 IJPay-AliPay latest-version ``` ### 初始化客户端配置信息 ```java AliPayApiConfig aliPayApiConfig = AliPayApiConfig.builder() .setAppId(aliPayBean.getAppId()) .setAppCertPath(aliPayBean.getAppCertPath()) .setAliPayCertPath(aliPayBean.getAliPayCertPath()) .setAliPayRootCertPath(aliPayBean.getAliPayRootCertPath()) .setCharset("UTF-8") .setPrivateKey(aliPayBean.getPrivateKey()) .setAliPayPublicKey(aliPayBean.getPublicKey()) .setServiceUrl(aliPayBean.getServerUrl()) .setSignType("RSA2") // 普通公钥方式 //.build(); // 证书模式 .buildByCert(); // 或者 .setAppId(aliPayBean.getAppId()) .setAliPayPublicKey(aliPayBean.getPublicKey()) .setCharset("UTF-8") .setPrivateKey(aliPayBean.getPrivateKey()) .setServiceUrl(aliPayBean.getServerUrl()) .setSignType("RSA2") .build(); // 普通公钥方式 .build(appCertPath, aliPayCertPath, aliPayRootCertPath) // 2.3.0 公钥证书方式 AliPayApiConfigKit.setThreadLocalAppId(aliPayBean.getAppId()); // 2.1.2 之后的版本，可以不用单独设置 AliPayApiConfigKit.setThreadLocalAliPayApiConfig(aliPayApiConfig); ``` > 参数说明： > - `appId`: 应用编号 > - `privateKey`: 应用私钥 > - `publicKey`: 支付宝公钥，通过应用公钥上传到支付宝开放平台换取支付宝公钥(如果是证书模式，公钥与私钥在CSR目录)。 > - `appCertPath`: 应用公钥证书 (证书模式必须) > - `aliPayCertPath`: 支付宝公钥证书 (证书模式必须) > - `aliPayRootCertPath`: 支付宝根证书 (证书模式必须) > - `serverUrl`: 支付宝支付网关 > - `domain`: 外网访问项目的域名，支付通知中会使用 **多应用无缝切换：** 从上面的初始化配置中，可以看到 `IJPay` 默认是使用当前线程中的 `appId` 对应的配置。如果要切换应用可以调用 `AliPayApiConfigKit.setThreadLocalAppId` 来设置当前线程中的 `appId`, 实现应用的切换进而达到多应用的支持。 ### 调用支付API **App 支付** ```java public AjaxResult appPay() { try { AlipayTradeAppPayModel model = new AlipayTradeAppPayModel(); model.setBody("测试数据-Java陈序员"); model.setSubject("Java陈序员 App 支付测试"); model.setOutTradeNo(StringUtils.getOutTradeNo()); model.setTimeoutExpress("15m"); model.setTotalAmount("0.01"); model.setPassbackParams("callback params"); model.setProductCode("QUICK_MSECURITY_PAY"); String orderInfo = AliPayApi.appPayToResponse(model, aliPayBean.getDomain() + NOTIFY_URL).getBody(); result.success(orderInfo); } catch (AlipayApiException e) { e.printStackTrace(); result.addError("system error:" + e.getMessage()); } return result; } ``` **PC 支付** ```java public void pcPay(HttpServletResponse response) { try { String totalAmount = "0.01"; String outTradeNo = StringUtils.getOutTradeNo(); log.info("pc outTradeNo>" + outTradeNo); String returnUrl = aliPayBean.getDomain() + RETURN_URL; String notifyUrl = aliPayBean.getDomain() + NOTIFY_URL; AlipayTradePagePayModel model = new AlipayTradePagePayModel(); model.setOutTradeNo(outTradeNo); model.setProductCode("FAST_INSTANT_TRADE_PAY"); model.setTotalAmount(totalAmount); model.setSubject("Java陈序员 PC 支付测试"); model.setBody("Java陈序员 PC 支付测试"); model.setPassbackParams("passback_params"); AliPayApi.tradePage(response, model, notifyUrl, returnUrl); } catch (Exception e) { e.printStackTrace(); } } ``` **手机网站支付** ```java public void wapPay(HttpServletResponse response) { String body = "测试数据-Java陈序员"; String subject = "Java陈序员 Wap支付测试"; String totalAmount = "0.01"; String passBackParams = "1"; String returnUrl = aliPayBean.getDomain() + RETURN_URL; String notifyUrl = aliPayBean.getDomain() + NOTIFY_URL; AlipayTradeWapPayModel model = new AlipayTradeWapPayModel(); model.setBody(body); model.setSubject(subject); model.setTotalAmount(totalAmount); model.setPassbackParams(passBackParams); String outTradeNo = StringUtils.getOutTradeNo(); System.out.println("wap outTradeNo>" + outTradeNo); model.setOutTradeNo(outTradeNo); model.setProductCode("QUICK_WAP_PAY"); try { AliPayApi.wapPay(response, model, returnUrl, notifyUrl); } catch (Exception e) { e.printStackTrace(); } } ``` **扫码支付** ```java public String tradePreCreatePay() { String subject = "Java陈序员支付宝扫码支付测试"; String totalAmount = "0.01"; String storeId = "123"; String notifyUrl = aliPayBean.getDomain() + "/aliPay/cert_notify_url"; AlipayTradePrecreateModel model = new AlipayTradePrecreateModel(); model.setSubject(subject); model.setTotalAmount(totalAmount); model.setStoreId(storeId); model.setTimeoutExpress("15m"); model.setOutTradeNo(StringUtils.getOutTradeNo()); try { String resultStr = AliPayApi.tradePrecreatePayToResponse(model, notifyUrl).getBody(); JSONObject jsonObject = JSONObject.parseObject(resultStr); return jsonObject.getJSONObject("alipay_trade_precreate_response").getString("qr_code"); } catch (Exception e) { e.printStackTrace(); } return null; } ``` **单笔转账到支付宝账户** ```java public String transfer() { String totalAmount = "0.01"; AlipayFundTransToaccountTransferModel model = new AlipayFundTransToaccountTransferModel(); model.setOutBizNo(StringUtils.getOutTradeNo()); model.setPayeeType("ALIPAY_LOGONID"); model.setPayeeAccount("gxthqd7606@sandbox.com"); model.setAmount(totalAmount); model.setPayerShowName("测试退款"); model.setPayerRealName("沙箱环境"); model.setRemark("Java陈序员测试单笔转账到支付宝"); try { return AliPayApi.transferToResponse(model).getBody(); } catch (Exception e) { e.printStackTrace(); } return null; } ``` 其他支付方式集成可参考： ``` https://github.com/Javen205/IJPay/tree/dev/IJPay-Demo-SpringBoot ``` ## 总结可以说，目前 `IJPay` 集成了大部分主流的支付渠道。可以全部集成到项目中，也可以按需加载某一种、某几种支付渠道。最后，贴上项目地址： ``` https://github.com/Javen205/IJPay ``` 在线文档地址： ``` https://javen205.gitee.io/ijpay/ ``` ## 最后推荐的开源项目已经收录到 `GitHub` 项目，欢迎 `Star`： ``` https://github.com/chenyl8848/great-open-source-project ``` 或者访问网站，进行在线浏览： ``` https://chencoding.top:8090/#/ ``` > 大家的点赞、收藏和评论都是对作者的支持，如文章对你有帮助还请点赞转发支持下，谢谢！