百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术文章 > 正文

Spring Boot中的微信支付(小程序)

haoteby 2025-03-10 16:05 37 浏览

前言

微信支付是企业级项目中经常使用到的功能,作为后端开发人员,完整地掌握该技术是十分有必要的。

logo

一、申请流程和步骤

图1-1

  • 注册微信支付账号
  • 获取微信小程序APPID
  • 获取微信商家的商户ID
  • 获取微信商家的API私钥
  • 配置微信支付回调地址
  • 绑定微信小程序和微信支付的关系
  • 搭建SpringBoot工程编写后台支付接口
  • 发布部署接口服务项目
  • 使用微信小程序或者UniAPP调用微信支付功能
  • 支付接口的封装
  • 配置jwt或者openid的token派发
  • 原生微信小程序完成支付对接

二、注册商家

2.1商户平台

商家或者企业想要通过微信支付来进行商品的销售,必须先通过微信平台(pay.weixin.qq.com)去将商家进行注册。注册成功后将会有商户信息等界面,包括商家的账户信息、企业信息等等。如图2-1所示:

图2-1

2.2商户id

商户id是项目开发中的唯一标识,是微信支付给予每个商户或者企业的唯一id。也是客户(消费者)在拉起微信支付时的凭据之一,在图2-1中的“微信支付商户号”就是商户id。


三、API私钥(支付密钥)

在注册商户成功后,同样在微信平台(pay.weixin.qq.com)可以对API私钥进行设置。如图3-1所示:

图3-1

API私钥也称为支付密钥,商户id和API密钥是用户拉起微信支付时后台所必须获取的。


四、商户签约微信支付产品

商户可以根据需要签约微信支付的产品,主要包括有:

  1. JSAPI支付:商户通过调用微信支付提供的JSAPI接口,在支付场景中调起微信支付模块完成收款;
  2. Native支付:商户系统按微信支付协议生成支付二维码,用户再用微信“扫一扫”完成支付的模式;
  3. 小程序支付:通过好友分享或扫描二维码在微信内打开小程序时,可以调用微信支付完成下单购买的流程;
  4. 付款码支付:用户出示微信钱包中的条码、二维码,商家通过扫描用户条码即可完成收款;
  5. 刷脸支付:用户在集成微信刷脸支付SDK的线下机具上"刷脸"即可完成支付。

如图4-1所示:

图4-1


五、配置回调地址

支付回调地址是微信支付服务器返回给用户支付信息(通知)的地址。如果商户签约的是微信小程序产品,那么支付回调地址可以配置也可以不进行配置。该地址为公司的域名,或者不加以配置。


六、小程序获取APPID

首先要登录申请官网进行微信小程序的注册:https://mp.weixin.qq.com/,如图6-1所示:

图6-1

注册成功后即可获得小程序唯一的APPID。如图6-2所示:

图6-2

七、微信支付与小程序绑定

在微信支付平台对APPID进行绑定即可。如图7-1所示:

图7-1


八、实战部分


8.1SpringBoot框架搭建

  • 首先创建一个初始化SpringBoot项目;
  • 在项目/模块的resources文件夹下,编写properties/yml配置文件;
    • 配置文件中需隔离dev环境与prod环境;
    • 配置文件中还包括了server、数据库、spring、token、日志、时区、json格式、mybatis-plus、swagger、redis、服务器配置、微信小程序配置(包括支付相关)等等全局统一配置。
  • 项目基本架构(SSM:Spring+SpringMVC+MyBatis)
    • controller后端接口,与前端数据交互
    • config云服务器配置Swagger配置接口拦截器(路由)微信支付配置(引入微信相关服务)
    • commonconstantenumsAjaxresultBaseControllerBaseEntityPage(Page与Table返回参数)
    • domain接口与页面所需参数(DTO、entity、req、res、VO等)
    • mappermapper文件接口(SQL方法定义)
    • serviceService:承接Controller层的接口方法定义Impl(接口实现类):接口的具体实现逻辑
    • utils文件工具类Json工具类时间格式工具类第三方登录工具类

8.2微信支付相关接口

8.2.1小程序用户登录接口

用户首先需要在小程序端进行微信用户登录授权,需调用接口获取登录凭证(code)。通过凭证进而换取用户登录态信息,包括用户在当前小程序的唯一标识(openid)、微信开放平台帐号下的唯一标识(unionid,若当前小程序已绑定到微信开放平台帐号)及本次登录的会话密钥(session_key)等。

具体的登录流程如图8-1所示:

图8-1

此时调用服务端接口,请求参数如图8-2所示:

图8-2

用户登录后的返回参数,如图8-3所示:

图8-3

8.2.2统一下单接口

用户登录小程序后,在小程序页面拉起支付请求时,会调用统一的下单接口。

在拉起支付请求时,下单接口参数需要两部分:一是商户、小程序相关的openid,appid等,二是需要商品相关的价格,名称,数量等参数。

以下将用代码来对微信支付接口做详细的讲解,代码以REST风格API接口的形式编写。

统一下单接口

@ApiOperation(value = "统一下单接口")
@RequestMapping(value = "/unifiedOrder",method = RequestMethod.POST)
public AjaxResult unifiedOrder(HttpServletRequest req,@RequestBody){
    //校验小程序(微信)用户登录
    //查询数据库订单信息(状态)
    //只有未支付订单才能发起支付
    //0元购买不调支付
    /**
     * 设置商户、小程序相关请求参数
     * */
    //获取小程序的appId
    String appId = WxMaUtil.getAppId(request);
    WxPayUnifiedOrderRequest wxPayUnifiedOrderRequest = new WxPayUnifiedOrderRequest();
    wxPayUnifiedOrderRequest.setAppid(appId);
    //商品名称
    String body = sysOrdersCourse.getCourseName();
    body =body.length() > 40 ? body.substring(0,39) : body;
    wxPayUnifiedOrderRequest.setBody(body);
    //订单编号
    wxPayUnifiedOrderRequest.setOutTradeNo(sysOrders.getOrderNo());
    //订单金额
    wxPayUnifiedOrderRequest.setTotalFee(sysOrders.getOrderAmount().multiply(new             BigDecimal(100)).intValue());
    //交易类型
    wxPayUnifiedOrderRequest.setTradeType("JSAPI");
    //支付回调地址
         wxPayUnifiedOrderRequest.setNotifyUrl(env.getProperty("notify-host")+"/wx/api/order/notify-order");
    wxPayUnifiedOrderRequest.setSpbillCreateIp("127.0.0.1");
    //用户在当前小程序中的唯一标识
    wxPayUnifiedOrderRequest.setOpenid(wxUser.getOpenId());
    //调用微信服务类
    WxPayService wxPayService = WxPayConfiguration.getPayService();
    return AjaxResult.success(JSONUtils.parse(wxPayService.createOrder(wxPayUnifiedOrderRequest)));
}

8.2.3创建订单接口

创建订单接口

用户可以在商品页面对某个商品进行下单,此时需要创建该用户购买某个商品的订单。

该过程主要是通过接口去请求用户信息、商品信息等参数,经过逻辑判断(是否存在已购买的订单)后创建(数据库插入相关信息)新的订单,最后返回该订单的所需数据。

@ApiOperation(value = "创建订单")
    @RequestMapping(value = "/create",method = RequestMethod.POST)
    public AjaxResult create(@RequestBody WxOrderRequest wxOrderRequest){
        //微信用户信息
        //判断是否购买过相同商品,若已经购买过,则无法创建新的订单
        //满足条件后将数据插入数据库
         WxOrderResponse wxOrderResponse = orderService.add(wxOrderRequest);
        //如果新增失败,则返回提示
         if (wxOrderResponse == null){
             return AjaxResult.error("订单创建失败");
         }
         return AjaxResult.success(wxOrderResponse);
     }

8.2.4取消订单接口

取消订单接口

当用户拉起微信支付时,如果在付款界面点击×取消付款(但此时订单已经创建),则该操作视为取消订单支付,同时在订单页面应当显示此时该订单的支付状态。

该接口可以通过订单id来作为请求参数,首先判断数据库中是否存在该订单信息,接着对可以取消支付的订单类型进行限制,最后更新数据库表(订单、商品和声明周期)状态。

@ApiOperation(value = "取消订单")
@RequestMapping(value = "/cancel/{orderId}",method = RequestMethod.PUT)
    public AjaxResult cancel(@PathVariable Long orderId){
        //判断订单是否存在
        SysOrders sysOrders = sysOrdersService.getById(orderId);
        if(sysOrders==null){
            return AjaxResult.error("订单不存在");
        }
        //只有未支付的订单能取消
        if(!CommonConstants.NO.equals(sysOrders.getIsPay())){
            return AjaxResult.error(MyReturnCode.ERR_70001.getCode(), MyReturnCode.ERR_70001.getMsg());
        }
        sysOrdersService.orderCancel(sysOrders);
        return AjaxResult.success();
    }

8.2.5订单详情接口

订单详情接口

当订单生成后,用户可以在页面查看该商品订单的详情。

该接口通过订单id即可从数据库获取详情信息,而该页面展示的数据由业务需求确定。

@ApiOperation(value = "订单详情")
@RequestMapping(value = "/myOrderDetail/{orderId}",method = RequestMethod.GET)
@ApiImplicitParams({@ApiImplicitParam(name = "orderId", value = "订单Id")})
     public AjaxResult myOrderDetail(@PathVariable Long orderId){
     //从数据库获取详情参数
     SysOrderDetailResponse detailResponse = sysOrdersService.getDetail(orderId);
     return AjaxResult.success(detailResponse);
     }

订单详情逻辑

    /**
     * 订单详情页面参数处理
     * @param orderId
     * @return sysOrderDetailResponse
     */
    @Override
    public SysOrderDetailResponse getDetail(Long orderId) {
        SysOrderDetailResponse sysOrderDetailResponse =  orderMapper.getDetail(orderId);
        //对页面的手机号做处理
        String phoneNum = sysOrderDetailResponse.getMobile();
        sysOrderDetailResponse.setMobile(phoneNum.substring(0,3) + "****" +       phoneNum.substring(7,phoneNum.length()));
        //根据订单状态不同,显示不同的数据
        //计算剩余待支付时间并展示
        return sysOrderDetailResponse;
    }

8.2.6支付回调接口

微信支付回调是用户在对商品进行支付操作后,将数据发送至微信服务器,微信服务器再将支付的结果返回(通知)给用户和商家的过程。

其中,主要关注的是用户支付-微信回调判断-修改数据库这个过程。

支付回调接口

@ApiOperation("支付回调")
@RequestMapping(value = "notify-order", method = RequestMethod.POST)
    public String notifyOrder(@RequestBody String xmlData) throws WxPayException {
        log.info("支付回调:" + xmlData);
        //微信支付服务
        WxPayService wxPayService = WxPayConfiguration.getPayService();
        WxPayOrderNotifyResult notifyResult = wxPayService.parseOrderNotifyResult(xmlData);
        log.info("支付回调解析结果" + notifyResult);
        //对创建的订单进行支付
        SysOrders sysOrders = orderService.getOne(notifyResult.getOutTradeNo());
        if (sysOrders != null) {
            if (sysOrders.getOrderAmount().multiply(new BigDecimal(100)).intValue() == notifyResult.getTotalFee()){
                 String timeEnd = notifyResult.getTimeEnd();
                 LocalDateTime paymentTime = LocalDateTimeUtils.parse(timeEnd);
                 //支付时间
                 sysOrders.setPaymentTime(paymentTime);
                 sysOrders.setOrderAmount(sysOrders.getOrderAmount());
                 //微信订单编号
                 sysOrders.setTransactionId(notifyResult.getTransactionId());
                 //更新数据库
                 orderService.notifyOrder(sysOrders);
                 log.info("支付回调成功通知:" + sysOrders.getOrderNo());
                 return WxPayNotifyResponse.success("支付成功");
            } else {
                 return WxPayNotifyResponse.fail("付款金额与订单金额不符");
            }
        } else {
            return WxPayNotifyResponse.fail("无此订单");
        }
    }

其中,notifyOrder方法的作用是在支付成功后在数据库更新订单的状态。

notifyOrder(SysOrders sysOrders)方法

@Override
    @Transactional(rollbackFor = Exception.class)
    public void notifyOrder(SysOrders sysOrders) {
       //只有未支付订单能操作,即is_pay字段为0的订单
       if(CommonConstants.NO.equals(sysOrders.getIsPay())) {
       //更新订单支付状态
       sysOrders.setIsPay(CommonConstants.YES);
       sysOrders.setStatus(OrderInfoEnum.STATUS_1.getValue());
       sysOrdersMapper.updateById(sysOrders);
       //更新商品表状态
       //更新订单生命周期表
       }
    }

至此,Spring Boot中的微信支付全过程已经分享完成。如有不足,望大家指正。

文章来自
https://www.cnblogs.com/Apluemxa/p/16315443.html

相关推荐

蜗牛矿机改NAS后远程访问教程,花生壳盒子完美解决

今年不少烧友都在玩星际蜗牛的机器,,我也跟风入手一台,用星际蜗牛改装了一台NAS,在星际蜗牛上安装了多个版本的NAS系统,各方面都不错,就是远程访问功能实现不了。由于本地运营商不提供公网IP,就只能考...

不吹不黑,揭秘网工提升效率的7大神器!

作为一个网络工程师,在日常工作中肯定会使用许多方便的实用软件来提高效率,下面就简单介绍一下网络工程师常用的7种软件。01、FileZilla...

有线网间歇性断网?3个步骤帮你解决 90% 有线网中断问题

有线网络偶尔中断可能由硬件故障、网络设置、线路问题或外部干扰等多种因素导致。一、常见原因及验证方法1.硬件设备...

「这 25 年我被天气 PUA 的日常」

翻出手机相册里每年6月拍的天空,白到发亮的云层下总配着同一句文案:"热到裂开"。掐指一算被高温暴打的四分之一个世纪里,每个夏天都在上演《关于我和天气互相折磨的那些年》。2003年绝对...

数码爱好者必备工具:POWER-Z KM001C多功能测试仪

作为一名数码类爱好者,平时要测试手机、平板、充电器、充电宝等等电子产品,一款好用的测试工具尤为重要。近期,通过充电头网购入了一款POWER-ZKM001C多功能测试仪,主要用来平日里测试快充头和充电...

监控摄像头常用测试命令大全(摄像头测试项目)

以下是监控摄像头在Linux系统中常用的测试命令大全,涵盖设备检测、参数调整、视频录制、网络监控等方面,结合多个来源的信息整理而成:一、摄像头设备检测与调用1.查看摄像头设备①`ls/dev/v...

中级消防设施操作员考试-计算机基础知识学习笔记

消防设施操作员模块八计算机基础课程摘要消防设施操作员模块八主要介绍了计算机基础知识,包括计算机系统的组成和功能、硬件和软件、输入输出设备、外存储器、内存条、中央处理器、机箱等硬件部分,以及系统软件和应...

今日揭秘:上网行为监控软件是如何监控的?7个功能图文介绍

同事A:“哎,你们听说了吗?隔壁部门小王昨天上班刷短视频被领导抓包了!”同事B:“真的假的?公司不是没装摄像头吗?怎么知道的?”...

USB详细介绍(usb简介)

USB概念1.概念USB是通用串行总线(UniversalSerialBus),分为HOST/DEVICE两个角色,所有的数据传输都由主机主动发起,而设备只是被动的负责应答。例如,在读数据时,U...

程序员必备,Fiddler和spy-debugger的远程调试手机APP

背景笔者从事Web开发,不论是PC端还是APP端,调试抓包都是必不可少的环节,懂前端的人都知道,PC端调试非常方便,Chrome或者火狐等浏览器等都自带了非常方便且易于使用的开发者工具,便于我们抓包调...

通用无线网络破解抓包跑包教程(wifi抓包跑包教程)

由于很多的信号很强,但是后面都没有带WPS,怎么办呢,现在我给大家介绍一个简单的抓包跑字典的办法来解决这个难题,首先搜索信号,水滴,关注我的这个应该都会了吧!选择一个信号,点击启动,记住不是点...

抓包神器wireshark安装保姆级教程

简介当我们进行网络抓包时,我们通常需要借助其他的工具进行抓取,比如Charles,fiddler等,今天我们给大家介绍一款同样非常流行的抓包工具——wireshark,本文将介绍wireshark的安...

别让资料拖后腿!STM32开发‘作弊包’开源,工程师直呼内行!

一、开发环境与编译工具...

背完这套 Java 面试八股文,自动解锁面试牛逼症被动技能

前言国内的互联网面试,恐怕是现存的、最接近科举考试的制度。很多人对八股文都嗤之以鼻,认为无法衡量出一个程序员的真是水平。还有一部分人则是深恶痛绝,因为实在太难背了。但是国内大环境如此,互联网IT行...

混合云的多活架构指南(混合云架构图)

文/董晓聪吕亚霖在之前的《如何正确选择多云架构?》一文中介绍了混合云(广义的多云)的诸多架构以及各自的优势,本篇会重点来介绍下混合云下的多活架构。...