SpingBoot的项目实战--模拟电商【5.沙箱支付】

Welcome Huihui's Code World ! !

接下来看看由辉辉所写的关于SpringBoot电商项目的相关操作吧 

目录

Welcome Huihui's Code World ! !

一. 沙箱支付是什么

二.SpringBoot项目集成沙箱支付 

 1.进入支付宝开放平台

2.进入控制台

（1）找到沙箱

（2）设置公钥

（3）生成密钥

①下载密钥生成工具

②使用密钥生成工具生成密钥

3.Java集成沙箱支付

（1）进入文档中心

（2）下载依赖

（3）Alipay Easy SDK API 总览

（4）配置类AplipayConfig 

（5）编写controller 

（6）支付测试 

---

因为我们写的这个项目是用来练手的，用来熟练技术点的，所以自然也不能接入支付宝的接口【没有营业执照这些证件】。但是支付宝也提供了可以供我们开发使用的接口--沙箱支付

一. 沙箱支付是什么

        沙箱支付（Sandbox payment）是指在软件开发过程中用于模拟真实支付环境的测试工具。它提供了一个安全的环境，允许开发人员在不涉及真实货币交易的情况下进行支付系统的测试和调试。

        通常，沙箱支付系统会模拟真实支付系统的功能和流程，但使用虚拟货币或测试帐户来完成支付过程。这样，开发人员可以在没有真实金钱交易的情况下验证他们的支付代码是否正常工作，并进行必要的调试和优化。

        沙箱支付对于开发支付相关应用程序和网站非常有用，因为它们可以在不影响真实用户和真实支付的情况下进行测试和调试。通过使用沙箱支付，开发人员可以确保应用程序在正式上线之前能够正确处理支付事务，减少潜在的错误和风险。

需要注意的是，沙箱支付只用于开发和测试目的，不是真实的支付系统，不能进行真实的交易操作。

二.SpringBoot项目集成沙箱支付 

 1.进入支付宝开放平台

支付宝开放平台https://openhome.alipay.com/

如果说没有支付宝账号的话，需要进行注册

有的话直接登录就好了

2.进入控制台

（1）找到沙箱

往下滑找到沙箱

（2）设置公钥

因为我们再写的是一个模拟的电商项目，那么我们就也模拟一下商户和用户之间的交易--那么我们就需要用到自定义密钥

系统密钥与自定义密钥区别：

1. 系统密钥（System Key）：系统密钥是支付宝沙箱环境中的全局密钥，由支付宝提供。系统密钥用于对数据进行加密和签名，以确保数据的安全性和完整性。开发者在使用支付宝沙箱支付时，需要使用正确的系统密钥来进行数据加密和验证。

2. 自定义密钥（Custom Key）：自定义密钥是开发者在支付宝沙箱环境中创建和管理的密钥，用于模拟真实商户的身份和权限。开发者可以在支付宝开放平台上创建自定义密钥，并将其用于沙箱环境中的支付请求和验证。自定义密钥用于模拟真实商户的身份认证和数据签名。

（3）生成密钥

①下载密钥生成工具

②使用密钥生成工具生成密钥

将生成的密钥中的公钥填入即可

然后我们就可以查看到支付宝公钥了

点击查看也是一样可以查看到的

3.Java集成沙箱支付

（1）进入文档中心

支付宝文档中心https://opendocs.alipay.com/common/找到对应的SDK【软件开发工具包（Software Development Kit）】，这里我选择的是easy版，因为这个项目不是上线的项目，没有那么庞大的数据和复杂的场景

Java通用版与Java Easy版的区别：

1. Java通用版（General Version）：Java通用版是基于支付宝开放平台提供的Java SDK开发的，适用于更为复杂的场景和高度自定义需求。使用Java通用版可以更灵活地进行开发，但相应地也需要更多的配置和代码编写。开发者需要根据支付宝提供的API文档，手动构建请求参数、进行签名、发送请求并处理响应等操作。

2. Java Easy版：Java Easy版是基于支付宝提供的简化SDK开发的，旨在降低开发门槛，简化开发过程。Java Easy版封装了一些常用的功能和操作，提供了更简单、易用的接口，并自动处理一些繁琐的步骤，如参数构建、签名等。使用Java Easy版可以快速上手并进行基本的沙箱支付测试，减少了开发者的工作量。

（2）下载依赖

    com.alipay.sdk
    alipay-easysdk
    2.2.0

（3）Alipay Easy SDK API 总览

这里是其中提供的aip接口，大家也可以通过网站链接访问

Alipay Easy SDK API 总览https://opendocs.alipay.com/common/02n6z6?pathHash=f5e2a056

能力类别	场景类别	接口方法名称
Base（基础能力）	OAuth（用户授权）	getToken（获取授权访问令牌和用户 user_id）
Base（基础能力）	OAuth（用户授权）	refreshToken（刷新授权访问令牌）
Base（基础能力）	Qrcode（小程序二维码）	create（创建小程序二维码）
Base（基础能力）	Image（图片）	upload（上传门店照片）
Base（基础能力）	Video（视频）	upload（上传门店视频）
Member（会员能力）	Identification（支付宝身份认证）	init（身份认证初始化）
Member（会员能力）	Identification（支付宝身份认证）	certify（生成认证链接）
Member（会员能力）	Identification（支付宝身份认证）	query（身份认证记录查询）
Payment（支付能力）	Common（通用）	create（创建交易）
Payment（支付能力）	Common（通用）	query（查询交易）
Payment（支付能力）	Common（通用）	refund（交易退款）
Payment（支付能力）	Common（通用）	close（关闭交易）
Payment（支付能力）	Common（通用）	cancel（撤销交易）
Payment（支付能力）	Common（通用）	queryRefund（交易退款查询）
Payment（支付能力）	Common（通用）	downloadBill（查询对账单下载地址）
Payment（支付能力）	Common（通用）	verifyNotify（异步通知验签）
Payment（支付能力）	Huabei（花呗分期）	create（创建花呗分期交易）
Payment（支付能力）	FaceToFace（当面付）	pay（扫用户出示的付款码，完成付款）
Payment（支付能力）	FaceToFace（当面付）	precreate（生成交易付款码，待用户扫码付款）
Payment（支付能力）	App（手机APP）	pay（生成订单串，再使用客户端 SDK 凭此串唤起支付宝收银台）
Payment（支付能力）	Page（电脑网站）	pay（生成交易表单，渲染后自动跳转支付宝网站引导用户完成支付）
Payment（支付能力）	Wap（手机网站）	pay（生成交易表单，渲染后自动跳转支付宝网站引导用户完成支付）
Security（安全能力）	TextRisk（文本内容安全）	detect（检测内容风险）
Marketing（营销能力）	Pass（支付宝卡包）	createTemplate（卡券模板创建）
Marketing（营销能力）	Pass（支付宝卡包）	updateTemplate（卡券模板更新）
Marketing（营销能力）	Pass（支付宝卡包）	addInstance（卡券实例发放）
Marketing（营销能力）	Pass（支付宝卡包）	updateInstance（卡券实例更新）
Marketing（营销能力）	TemplateMessage（小程序模板消息）	send（发送模板消息）
Marketing（营销能力）	OpenLife（生活号）	createImageTextContent（创建图文消息内容）
Marketing（营销能力）	OpenLife（生活号）	modifyImageTextContent（更新图文消息内容）
Marketing（营销能力）	OpenLife（生活号）	sendText（群发本文消息）
Marketing（营销能力）	OpenLife（生活号）	sendImageText（群发图文消息）
Marketing（营销能力）	OpenLife（生活号）	sendSingleMessage（单发模板消息）
Marketing（营销能力）	OpenLife（生活号）	recallMessage（生活号消息撤回）
Marketing（营销能力）	OpenLife（生活号）	setIndustry（模板消息行业设置）
Marketing（营销能力）	OpenLife（生活号）	getIndustry（生活号查询行业设置）
Util（辅助工具）	AES（加解密）	decrypt（解密，常用于会员手机号解密）
Util（辅助工具）	AES（加解密）	encrypt（加密）
Util（辅助工具）	Generic（通用接口）	execute（自行拼接参数，执行OpenAPI调用）
Util（辅助工具）	Generic（通用接口）	sdkExecute（自行拼接参数，生成加签串，功能等同于通用版 SDK 中的 sdkExecute 方法）

（4）配置类AplipayConfig 

其中的appid

支付宝公钥

应用私钥

应用私钥是在我们的密钥生成工具中

package com.wh.easyshop.util;

import com.alipay.easysdk.factory.Factory;
import com.alipay.easysdk.kernel.Config;
import com.alipay.easysdk.payment.page.models.AlipayTradePagePayResponse;
import com.zking.starshop.pojo.Order;
import org.springframework.stereotype.Component;

@Component
public class AlipayConfig {

    private Config aliconfig() {
        Config config = new Config();
        //沙箱支付宝地址
        config.gatewayHost = "openapi-sandbox.dl.alipaydev.com";
        //协议https
        config.protocol = "https";
        //应用ID,您的APPID，收款账号既是您的APPID对应支付宝账号
        config.appId = "appId ";
        //支付宝公钥
        config.alipayPublicKey = "支付宝公钥";
        //签名方式
        config.signType = "RSA2";
        //商户私钥（应用私钥），您的PKCS8格式RSA2私钥
        config.merchantPrivateKey ="应用私钥";
        return config;
    }

   

}

需要修改沙箱支付的支付方式，改成网页支付：

public String goAlipay(Order order) {
        try {
            // 1. 设置参数（全局只需设置一次）
            Factory.setOptions(aliconfig());
            // 2. 发起API调用（subject商品标题、outTradeNo订单编号、totalAmount总金额、returnUrl异步通知地址）
            AlipayTradePagePayResponse response = Factory.Payment.Page()
                    .pay("SpringBoot练手项目收款",
                            order.getOid().toString(),//订单编号
                            order.getTotal().toString(),//总金额
                            //支付成功之后的异步通知（跳出到自己系统的哪个位置）
                            "http://localhost:8080/order/payDone");
            return response.body;
        } catch (Exception e) {
            e.printStackTrace();
            throw new RuntimeException(e);
        }
    }

（5）编写controller 

然后再前端接收到这个订单编号，并且把这个id带到指定的路径中

 $.post('/order/addOrder',order,resp=>{
        if(resp.code===200){
          let f=confirm("确认支付吗");
          if(f){
        location.href="/order/pay?oid="+resp.data;
          }else{
        location.href="/";
          }
        }
    },'json')

指定的路径：此方法用查询订单，然后把订单的信息带到支付页面中

这个是在配置类中缩写的支付成功之后的异步通知

package com.wh.easyshop.controller;

import com.alipay.easysdk.factory.Factory;
import com.baomidou.mybatisplus.core.conditions.update.UpdateWrapper;
import com.github.yitter.idgen.YitIdHelper;
import com.wh.easyshop.exception.BusinessException;
import com.wh.easyshop.model.Goods;
import com.wh.easyshop.model.Order;
import com.wh.easyshop.model.OrderItem;
import com.wh.easyshop.model.User;
import com.wh.easyshop.resp.JsonResponseBody;
import com.wh.easyshop.resp.JsonResponseStatus;
import com.wh.easyshop.service.IGoodsService;
import com.wh.easyshop.service.IOrderItemService;
import com.wh.easyshop.service.IOrderService;
import com.wh.easyshop.service.IRedisService;
import com.wh.easyshop.util.AlipayConfig;
import com.wh.easyshop.vo.CartVo;
import com.wh.easyshop.vo.OrderVo;
import org.springframework.beans.BeanUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.bind.annotation.RestController;

import java.math.BigDecimal;
import java.util.*;
import java.util.stream.Collectors;

/**
 * 

 * 订单信息表 前端控制器
 * 
 *
 * @author wh
 * @since 2023-12-27
 */
@RestController
@RequestMapping("/order")
public class OrderController {
    @Autowired
    IRedisService redisService;
    @Autowired
    IGoodsService goodsService;
    @Autowired
    IOrderItemService iOrderItemService;
    @Autowired
    IOrderService iOrderService;

    @RequestMapping("/addOrder")
    public JsonResponseBody order (User user, OrderVo orderVo) {
        //拿到其中的商品id
        String ids = orderVo.getIds();
        //拿到购物车中指定的商品【数量和id】
        List cartVos = redisService.loadCart(user, ids);
        List ds = cartVos.stream().map(CartVo::getGid).collect(Collectors.toList());
        //拿到数据库中的内容【名字，价格】
        List goods = goodsService.listByIds(ds);
        //遍历集合 赋值给对应的对象
        for (Goods g : goods) {
            //找到对应id相同的元素
            CartVo vo = cartVos.stream()
                    .filter(v -> Objects.equals(v.getGid(), g.getGid()))
                    .findFirst()
                    .get();
            //将商品g的属性赋值给vo【这样vo中的属性就有数据了】
            BeanUtils.copyProperties(g,vo);
        }
        //订单中的总价
        BigDecimal total =new BigDecimal(0);
        //生成订单详情
        //需要订单id【雪花id生成】
        long oid = YitIdHelper.nextId();
        //使用集合将需要加进去的订单详情装起来【使用批处理一次性处理掉】
        List orderItemList=new ArrayList<>();
        for (CartVo cartVo : cartVos) {
        //订单详情
            OrderItem orderItem = new OrderItem();
            //将vo类的属性赋值给orderitem【共有的属性赋值】
            BeanUtils.copyProperties(cartVo,orderItem);
            //还有一个数量的值没有赋成功【因为两个实体中的这个属性名字不一样】
            orderItem.setQuantity(cartVo.getNum());
            //设置订单详情的id
            orderItem.setOoid(YitIdHelper.nextId());
            //设置订单id
            orderItem.setOid(oid);
            //将订单详情加入到订单详情的集合中
            orderItemList.add(orderItem);
            //计算总价
            total=total.add(cartVo.xj());
        }
        //将生成的额订单详情加入到数据库中
        iOrderItemService.saveBatch(orderItemList,5);
        //生成订单
        Order order = new Order();
        //将其中的ordervo的属性赋值给order
        BeanUtils.copyProperties(orderVo,order);
        //订单id
        order.setOid(oid);
        //总价
        order.setTotal(total);
        //用户id
        order.setUserId(user.getId());
        //订单生成时间
        order.setCreateDate(new Date());
        //订单状态【0 未支付】
        order.setStatus(0);
        //将生成的订单加入到数据库
        iOrderService.save(order);
        //订单生成成功之后需要将购物车中的信息删除
        String ids1 = orderVo.getIds();
        List delids = Arrays.asList(ids1.split(","));
        redisService.delCart(delids,user);
        return JsonResponseBody.success(oid);
    }



    @RequestMapping("/pay")
    public String order (User user, String oid) {
        //根据传递过来的订单编号拿到订单对象
        Order order = iOrderService.getById(oid);
        AlipayConfig alipayConfig = new AlipayConfig();
        String body= alipayConfig.goAlipay(order);//表单内容
        return body;
    }

    /**
     * 支付成功之后的回调路径
     * @param ms
     * @return
     * @throws Exception
     */
    @RequestMapping("/payDone")
    @ResponseBody
    //@RequestParam没有这个注解就无法正确的接受参数
    public String payDone(@RequestParam Map ms) throws Exception {
        //验签【不然的话就可以在地址栏上手动传递参数】
        Boolean f = Factory.Payment.Common().verifyNotify(ms);
        //如果验证不通过，那就抛出一个异常
        if(!f){
            throw  new BusinessException(JsonResponseStatus.UN_KNOWN);
        }
        String oid = ms.get("out_trade_no");//拿到请求中的订单编号
        iOrderService.update(new UpdateWrapper()
                //根据订单编号，修改订单状态【未支付=>已支付】
                .eq("oid", oid)
                .set("status", 1)
                .set("pay_date", new Date())//设置支付的时间
        );
        return "";
    }


}

（6）支付测试 

如果支付成功就会跳到主页面中

好啦，今天的分享就到这了，希望能够帮到你呢！