一步步教你如何在SpringBoot项目中引入支付功能

article/2025/10/15 6:19:02

听说微信搜索《Java鱼仔》会变更强哦！

本文收录于JavaStarter ，里面有我完整的Java系列文章，学习或面试都可以看看哦

（一）引言

支付功能如今已经成为一个需要盈利的网站的基本功能了，如今的网站如果想要做支付功能，往往都是将支付宝或者微信的支付功能集成进来。尽管支付宝已经给出了许多文档和代码，但是这项工作并没有那么简单。今天我就一步步带大家去实现在SpringBoot项目中对支付宝的功能引入。

（二）功能介绍

我们要实现的功能很简单，当传入用户购买的信息之后，生成一个二维码供支付使用，同时提供一个查询接口查询该笔订单是否已支付，这种支付方式叫做当面付。学会这一种支付方式之后，支付宝的其他的功能也会很容易上手。

首先给出当面付的文档地址：https://opendocs.alipay.com/open/194

文档中很详细地描述了支付的整体逻辑。

（三）开发前准备

首先需要引入相关的依赖，我把这个项目中会用到的依赖一次性给出：

<!--支付宝依赖-->
<!-- https://mvnrepository.com/artifact/com.alipay.sdk/alipay-sdk-java -->
<dependency><groupId>com.alipay.sdk</groupId><artifactId>alipay-sdk-java</artifactId><version>4.10.218.ALL</version><exclusions><exclusion><artifactId>commons-logging</artifactId><groupId>commons-logging</groupId></exclusion></exclusions>
</dependency>
<dependency><groupId>commons-lang</groupId><artifactId>commons-lang</artifactId><version>2.6</version>
</dependency>
<dependency><groupId>commons-configuration</groupId><artifactId>commons-configuration</artifactId><version>1.8</version><exclusions><exclusion><artifactId>commons-logging</artifactId><groupId>commons-logging</groupId></exclusion></exclusions>
</dependency>
<dependency><groupId>commons-codec</groupId><artifactId>commons-codec</artifactId><version>1.11</version>
</dependency>
<dependency><groupId>com.google.zxing</groupId><artifactId>core</artifactId><version>3.2.1</version>
</dependency>
<dependency><groupId>org.hamcrest</groupId><artifactId>hamcrest-core</artifactId><version>1.3</version><scope>test</scope>
</dependency>
<dependency><groupId>com.google.code.gson</groupId><artifactId>gson</artifactId><version>2.8.6</version>
</dependency>
<dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId>
</dependency>

同时官方已经提供了Demo，我们也直接下载下来：
https://opendocs.alipay.com/open/54/104506

在这里插入图片描述

另外支付功能还涉及到私钥公钥的加签，支付宝给我们提供了密钥加密工具，也需要下载：
https://opendocs.alipay.com/open/291/105971

最后还要一个沙箱环境的地址，这个地址用于测试：
https://opendocs.alipay.com/open/200/105311

（四）项目搭建

首先搭建一个SpringBoot项目，这一步就跳过了，打开我们上面下载的Demo文件，里面有一个TradePayDemo和TradePaySDK，TradePaySDK是支付过程中需要调用的一些类，因此需要把TradePaySDK中的代码引进来：

在这里插入图片描述
将上面这四个文件引入到我们的项目中：

在这里插入图片描述

TradePayDemo中提供了具体代码如何调用的示例，src目录下有一个文件叫做：zfbinfo.properties，把这个文件放入到resource目录下。关于zfbinfo.properties文件，里面有五个参数是需要我们自己去填写的：
注意，由于是测试环境，因此将open_api_domain修改成：
https://openapi.alipaydev.com/gateway.do
在这里插入图片描述
pid是每个人自己账号的Id，登陆沙箱环境后，点击右上角的账号，选中账户中心，里面的账号ID就是pid。

在这里插入图片描述

在沙箱环境中，你还能看到自己的appid，将这个appid赋值到配置文件中的appid处：

在这里插入图片描述

接下来就是公钥和私钥以及支付宝的公钥，上面让大家下载了工具，打开后直接用默认的加密方式生成公私钥：

在这里插入图片描述
将上面的私钥和公钥分别放入对应的private_key和public_key中。

在沙箱环境中，将上面生成的公钥复制上去，可以得到支付宝的公钥，配置文件就齐全了

在这里插入图片描述

（五）业务开发

完成上面一长串工作后，就可以开始写业务了，Demo文件中还要一个包叫做TradePayDemo的，我们主要参考里面的Main方法。

5.1 二维码生成功能

新建一个Service叫做TradeService，再新建他的实体类TradeServiceImpl

@Slf4j
@Service
public class TradeServiceImpl implements TradeService {// 支付宝当面付2.0服务private static AlipayTradeService tradeService;@PostConstructprivate void init(){/** 一定要在创建AlipayTradeService之前调用Configs.init()设置默认参数*  Configs会读取classpath下的zfbinfo.properties文件配置信息，如果找不到该文件则确认该文件是否在classpath目录*/Configs.init("zfbinfo.properties");/** 使用Configs提供的默认参数*  AlipayTradeService可以使用单例或者为静态成员对象，不需要反复new*/tradeService = new AlipayTradeServiceImpl.ClientBuilder().build();}@Overridepublic String tradeQrCode(OrderDetail orderDetail){//支付二维码的访问路径String qrCodePath=null;// (必填) 商户网站订单系统中唯一订单号，64个字符以内，只能包含字母、数字、下划线，// 需保证商户系统端不能重复，建议通过数据库sequence生成，String outTradeNo = "tradeprecreate" + System.currentTimeMillis()+ (long) (Math.random() * 10000000L);// (必填) 订单标题，粗略描述用户的支付目的。如“xxx品牌xxx门店当面付扫码消费”String subject = orderDetail.getSubject();// (必填) 订单总金额，单位为元，不能超过1亿元// 如果同时传入了【打折金额】,【不可打折金额】,【订单总金额】三者,则必须满足如下条件:【订单总金额】=【打折金额】+【不可打折金额】String totalAmount = orderDetail.getTotalAmount();// (可选) 订单不可打折金额，可以配合商家平台配置折扣活动，如果酒水不参与打折，则将对应金额填写至此字段// 如果该值未传入,但传入了【订单总金额】,【打折金额】,则该值默认为【订单总金额】-【打折金额】String undiscountableAmount = "0";// 卖家支付宝账号ID，用于支持一个签约账号下支持打款到不同的收款账号，(打款到sellerId对应的支付宝账号)// 如果该字段为空，则默认为与支付宝签约的商户的PID，也就是appid对应的PIDString sellerId = "";// 订单描述，可以对交易或商品进行一个详细地描述，比如填写"购买商品2件共15.00元"String body = String.format("购买商品%s件共%s元",orderDetail.getGoodsDetail().size(),totalAmount);// 商户操作员编号，添加此参数可以为商户操作员做销售统计String operatorId = "javayz";// (必填) 商户门店编号，通过门店号和商家后台可以配置精准到门店的折扣信息，详询支付宝技术支持String storeId = "javayz001";// 业务扩展参数，目前可添加由支付宝分配的系统商编号(通过setSysServiceProviderId方法)，详情请咨询支付宝技术支持ExtendParams extendParams = new ExtendParams();extendParams.setSysServiceProviderId("2088100200300400500");// 支付超时，定义为120分钟String timeoutExpress = "120m";// 商品明细列表，需填写购买商品详细信息，List<GoodsDetail> goodsDetailList = new ArrayList<GoodsDetail>();orderDetail.getGoodsDetail().stream().forEach((item)->{// 创建一个商品信息，参数含义分别为商品id（使用国标）、名称、单价（单位为分）、数量，如果需要添加商品类别，详见GoodsDetailGoodsDetail goods1 = GoodsDetail.newInstance(item.getGoodsId(), item.getGoodsName(), Long.valueOf(item.getPrice())*100, Math.toIntExact(item.getQuantity()));// 创建好一个商品后添加至商品明细列表goodsDetailList.add(goods1);});// 创建扫码支付请求builder，设置请求参数AlipayTradePrecreateRequestBuilder builder = new AlipayTradePrecreateRequestBuilder().setSubject(subject).setTotalAmount(totalAmount).setOutTradeNo(outTradeNo).setUndiscountableAmount(undiscountableAmount).setSellerId(sellerId).setBody(body).setOperatorId(operatorId).setStoreId(storeId).setExtendParams(extendParams).setTimeoutExpress(timeoutExpress)//                .setNotifyUrl("http://www.test-notify-url.com")//支付宝服务器主动通知商户服务器里指定的页面http路径,根据需要设置.setGoodsDetailList(goodsDetailList);AlipayF2FPrecreateResult result = tradeService.tradePrecreate(builder);switch (result.getTradeStatus()) {case SUCCESS:log.info("支付宝预下单成功: )");AlipayTradePrecreateResponse response = result.getResponse();dumpResponse(response);// 需要修改为运行机器上的路径String filePath = String.format("F:/qrcode/static/qrcode/qr-%s.png",response.getOutTradeNo());log.info("filePath:" + filePath);//创建二维码ZxingUtils.getQRCodeImge(response.getQrCode(), 256, filePath);qrCodePath=filePath;break;case FAILED:log.error("支付宝预下单失败!!!");break;case UNKNOWN:log.error("系统异常，预下单状态未知!!!");break;default:log.error("不支持的交易状态，交易返回异常!!!");break;}return qrCodePath;}// 简单打印应答private void dumpResponse(AlipayResponse response) {if (response != null) {log.info(String.format("code:%s, msg:%s", response.getCode(), response.getMsg()));if (StringUtils.isNotEmpty(response.getSubCode())) {log.info(String.format("subCode:%s, subMsg:%s", response.getSubCode(),response.getSubMsg()));}log.info("body:" + response.getBody());}}
}

代码注释已经解释的很清楚了，就是设置参数，生成二维码。

新建一个类OrderController，创建一个Post请求的接口：

@RestController
@RequestMapping("/order")
public class OrderController extends BaseController {@Autowiredprivate TradeService tradeService;//创建支付二维码@PostMapping("/qrcode")public CommonResult getQrCode(@RequestBody OrderDetail orderDetail){String path = tradeService.tradeQrCode(orderDetail);if (StringUtils.isNotEmpty(path)){return CommonResult.success(path);}return CommonResult.fail();}
}

访问http://localhost:8190/order/qrcode，参数可参考如下：

在这里插入图片描述

输出二维码的地址：
在这里插入图片描述
验证支付功能务必要使用沙盒地址中的钱包：

在这里插入图片描述

5.2 验证订单是否被支付

一样的逻辑，从Demo中找到验证订单的代码，放入TradeServiceImpl中

    @Overridepublic String alipayTradeQuery(String orderSn){//返回信息String responseResult="";// (必填) 商户订单号，通过此商户订单号查询当面付的交易状态String outTradeNo = orderSn;// 创建查询请求builder，设置请求参数AlipayTradeQueryRequestBuilder builder = new AlipayTradeQueryRequestBuilder().setOutTradeNo(outTradeNo);AlipayF2FQueryResult result = tradeService.queryTradeResult(builder);switch (result.getTradeStatus()) {case SUCCESS:responseResult="查询返回该订单支付成功";log.info("查询返回该订单支付成功: )");AlipayTradeQueryResponse response = result.getResponse();dumpResponse(response);log.info(response.getTradeStatus());if (Utils.isListNotEmpty(response.getFundBillList())) {for (TradeFundBill bill : response.getFundBillList()) {log.info(bill.getFundChannel() + ":" + bill.getAmount());}}break;case FAILED:responseResult="查询返回该订单支付失败或被关闭";log.error("查询返回该订单支付失败或被关闭!!!");break;case UNKNOWN:responseResult="系统异常，订单支付状态未知";log.error("系统异常，订单支付状态未知!!!");break;default:responseResult="不支持的交易状态，交易返回异常";log.error("不支持的交易状态，交易返回异常!!!");break;}return responseResult;}

在Controller中加一个接口

    //查询订单情况@PostMapping("/queryOrderStatus")public CommonResult queryOrderStatus(@RequestParam("orderSn") String orderSn){String result = tradeService.alipayTradeQuery(orderSn);if (StringUtils.isEmpty(result)){return CommonResult.fail();}else {return CommonResult.success(result);}}

5.3 设置一个回调的接口

可以通过5.2中的方法定时轮询订单是否被支付，也可以写一个回调接口给支付宝调用，但是这个接口必须确保能被支付宝外网访问到，这里我给出代码示例：

    @PostMapping("payCallback")public void payCallback(){Map<String,String> map=new HashMap<>();Enumeration<String> parameterNames = getRequest().getParameterNames();while (parameterNames.hasMoreElements()){String parameter = parameterNames.nextElement();if (!parameter.toLowerCase().equals("sign_type")){map.put(parameter,getRequest().getParameter(parameter));}}try {boolean result = AlipaySignature.rsaCertCheckV2(map, Configs.getPublicKey(), "utf-8", Configs.getSignType());PrintWriter writer = getResponse().getWriter();if (result){writer.print("success");}else {writer.print("unSuccess");}} catch (AlipayApiException e) {e.printStackTrace();} catch (IOException e) {e.printStackTrace();}}

然后在生成二维码的代码中增加回调接口

在这里插入图片描述

（六）总结

到这里，当面付的功能我们就开发好了，说简单也不简单，各种步骤都比较繁琐，但是只要把整体逻辑理清楚了，后续其他支付功能的开发就会很简单了。我是鱼仔，我们下期再见!


http://chatgpt.dhexx.cn/article/2vrZLjgd.shtml

相关文章

支付功能怎么测试？

支付功能怎么测试？

跳槽高峰期&#xff0c;作为测试&#xff0c;不管是面试还是笔试&#xff0c;必然要被考验到的就是”测试思维“。在面试中就是体现在如下面试题中&#xff1a; “说说你项目中的 xx 模块你是如何测试的&#xff1f;” “给你一个购物车&#xff0c;你要怎么测试&#xff1f;”…
阅读更多...
面试题：支付功能怎么测试？如何回答？

面试题：支付功能怎么测试？如何回答？

文章末尾给大家准备了大量福利 前言 九月了&#xff0c;有很多的小伙伴已经全面武装好准备找工作了&#xff0c;九月和十月是黄金期——俗称”金九银十“。那么&#xff0c;作为测试&#xff0c;不管是面试还是笔试&#xff0c;必然要被考验到的就是”测试思维“。在面试中就…
阅读更多...
支付功能测试用例（参考微信平台）

支付功能测试用例（参考微信平台）

支付功能测试用例xmind&#xff0c;功能点以支付方式&#xff0c;支付手段&#xff0c;支付金额划分的 支付方式&#xff1a; 1.余额&#xff08;零钱&#xff09;支付 2.储蓄卡支付 3.第三方支付微信&#xff0c;支付宝&#xff0c;京东、百度、&#xff09; 4.信用卡支付…
阅读更多...
vue项目支付功能

vue项目支付功能

目录 1.支付宝方式&#xff1a; 代码&#xff1a; ​ 2.微信支付 二维码展示代码&#xff1a; ​请求后端的支付二维码接口 1.支付宝方式&#xff1a; 支付宝方式&#xff1a;点击支付宝支付, 调用后台接口(携带订单号)&#xff0c;后台返回一个form表单(HTML字符串结构)&am…
阅读更多...
在线支付功能实现代码

在线支付功能实现代码

我们都知道&#xff0c;在现在的网站中&#xff0c;基本上都会有支付功能&#xff0c;在线支付作为一个潮流已是现代化网站的必备功能模块&#xff0c;那么几天我就分享一下如果来做这个在线支付功能。 在线支付一般来说有两种实现方式&#xff0c;一种是调用各个银行提供的接口…
阅读更多...
Java实现微信支付功能

Java实现微信支付功能

微信实现支付功能与支付宝实现支付功能是相似的&#xff0c;接入前的准备工作&#xff0c;包括申请APPID、申请mchid、绑定APPID及mchid、配置API key、下载并配置商户证书等&#xff0c;具体可查看微信支付文档 接入前准备-APP支付 | 微信支付商户平台文档中心 (qq.com)正在上…
阅读更多...
Java开发支付宝支付功能

Java开发支付宝支付功能

之前做开发过程中&#xff0c;没有接触过支付相关的功能&#xff0c;最近做了一个支付相关功能的开发&#xff0c;包括支付宝和微信支付&#xff0c;为了避免以后忘记相关的流程&#xff0c;记录一下这次的开发经验&#xff0c;这里先介绍一下支付宝相关的开发。 首先在进行jav…
阅读更多...
支付宝支付功能实现

支付宝支付功能实现

支付宝支付功能 1、电脑网站支付&#xff0c;手机网站支付&#xff0c;app支付1.1、异步通知介绍1.2、API和请求示例介绍 2、当面付3、小程序支付接入4、代码完整代码 支付宝开发文档中心 注意&#xff1a;个人无法使用此功能&#xff0c;因为个人申请使用是不会通过的 1、电脑…
阅读更多...
支付功能

支付功能

Django rest framework之支付功能 一.支付宝支付 1.进入蚂蚁金服开放平台&#xff08;查看api&#xff09;&#xff1a; 1.1在正式生产环境中需要创建应用&#xff08;需审核&#xff09;&#xff1a; 1.2沙箱环境&#xff08;测试&#xff09;&#xff1a; 可以在文档中查看对…
阅读更多...
springboot实现支付宝支付功能

springboot实现支付宝支付功能

支付系统中容易出现的问题 1&#xff0c;用户在页面下订单后&#xff0c;价格被篡改&#xff1b; 解决方案&#xff1a;通过后端计算订单的总金额 2&#xff0c;订单重复处理。用户支付成功后&#xff0c;支付宝会短时间内多次调用我们的回调接口&#xff0c;如果出现网络波动…
阅读更多...
2021年，Flutter 与 React Native该如何选择？，安卓app开发教程

2021年，Flutter 与 React Native该如何选择？，安卓app开发教程

一、Flutter 应用的优势 =========================================================================== 1. 热重载 = 快速编码 Flutter 允许开发人员使用一种更复杂、更快速的方式来创建应用程序。这是 Flutter 的最大优势之一，也是所有顶级移动应用开发公司都颇为看重的…
阅读更多...
一大波开发者福利来了，一份微软官方Github上发布的开源项目清单等你签收

一大波开发者福利来了，一份微软官方Github上发布的开源项目清单等你签收

目录 微软Github开源项目入口微软开源项目受欢迎程度排名 Visual Studio CodeTypeScriptRxJS.NET Core 基础类库CNTKMicrosoft calculatorMonaco editorMS-DOSRedis windows版.NET Core CLR (公共语言运行时)ASP.NET CoreEntity Framework CorePowerShell如何在其中搜索自己需要…
阅读更多...
.Net资讯 | 一大波开发者福利来了， 一份微软官方Github上发布的开源项目清单等你签收...

.Net资讯 | 一大波开发者福利来了， 一份微软官方Github上发布的开源项目清单等你签收...

目录 微软Github开源项目入口微软开源项目受欢迎程度排名 Visual Studio CodeTypeScriptRxJS.NET Core 基础类库CNTKMicrosoft calculatorMonaco editorMS-DOSRedis windows版.NET Core CLR (公共语言运行时)ASP.NET CoreEntity Framework CorePowerShell如何在其中搜索自己需要…
阅读更多...
FullCalendar:eventColor,eventBackgroundColor, eventBorderColor, and eventTextColor

FullCalendar:eventColor,eventBackgroundColor, eventBorderColor, and eventTextColor

<!DOCTYPE html><html><head><meta charsetutf-8 /><title>背景色設定</title><link href../fullcalendar.min.css relstylesheet /><link href../fullcalendar.print.min.css relstylesheet mediaprint /><script src../l…
阅读更多...
Flutter 与 React Native 该如何选择

Flutter 与 React Native 该如何选择

跨平台程序员之间关于 React Native 和 Flutter 的旷日持久的争论越来越白热化了。前几年&#xff0c;React Native 还是开发人员的首选框架&#xff0c;但是自 2017 年 Flutter 发布以来&#xff0c;其已经发展成为 React Native 的一个强有力竞争对手。 最近&#xff0c;随着…
阅读更多...
2021年，Flutter 与 React Native该如何选择？

2021年，Flutter 与 React Native该如何选择？

????????关注后回复 “进群” &#xff0c;拉你进程序员交流群???????? 作者 | Wasim Charoliya 译者 | 王强 策划 | 田晓旭 2021 年&#xff0c;跨平台程序员之间关于 React Native 和 Flutter 的旷日持久的争论越来越白热化了。前几年&#xff0c;React Nati…
阅读更多...
React Native 三端同构实践

React Native 三端同构实践

⚠️ 博客中涉及的代码内容可查看 Github: react-native-isomorphism React Native三端同构皆在&#x1f22f;️在不改动 React Native 代码下&#xff0c;公用一套代码架构, 在浏览器中实现同样的展示、交互、功能。 在实际开发过程中, 尤其创业公司, 需求的迭代周期是非常快…
阅读更多...
吐血推荐｜2万字总结Mac所有应用程序、软件工具和相关资料

吐血推荐｜2万字总结Mac所有应用程序、软件工具和相关资料

现在随着互联网的发展&#xff0c;越来越多的公司都鼓励Mac办公&#xff0c;属实MacOS系统对于我们的工作开发效率有很大提升&#xff0c;所以我们需要收集各种类别非常好用的 Mac 应用程序、软件以及工具。作为一个资深 Mac 用户&#xff0c;我需要它们帮助我快乐、高效的工作…
阅读更多...
网易云音乐React Native体系建设与发展

网易云音乐React Native体系建设与发展

本文作者&#xff1a;章伟东 &#xff08;网易云音乐大前端团队&#xff09; 0.33 历史 17 年 3 月份&#xff0c;为了解决商城性能和用户体验问题&#xff0c;云音乐技术团队组建了一只 4 人 ReactNative 开发小分队&#xff1a;我负责 RN 前端开发&#xff0c;安卓和 iOS 两…
阅读更多...
每周分享第 26 期

每周分享第 26 期

这里记录过去一周&#xff0c;我看到的值得分享的东西&#xff0c;每周五发布。 Basecamp 是 IT 行业很有名的一家公司&#xff0c;提供团队协作工具&#xff0c;同时也是 Rails on Ruby 框架的创造者。这家公司的特别之处在于&#xff0c;它不仅写软件&#xff0c;还写畅销书&…
阅读更多...
推荐文章

Copyright @ 2022~2023