luban-mall项目中的电商支付流程实战详解

用户3587585

发布于 2022-09-21 06:43:42

1.1K0

发布于 2022-09-21 06:43:42

文章被收录于专栏：阿福谈Web编程

前言

在电商项目中几乎是绕不开实现支付业务的，那么本文就以项目中接入支付宝作为第三方支付来讲一讲如何实现luban-mall电商项目中的支付流程。希望看完本文后，能给正在学习电商项目的读者带来一些的帮助！

1 阿里扫描支付演示全过程

1.1 当面支付介绍

当面付帮助商家在线下消费场景下实现快速收款，支持条码支付和扫码支付两种付款方式。商家可通过以下任一方式进行收款，提升商家收银效率，资金实时到账。

商家通过扫描线下买家支付宝钱包中的条码、二维码等方式完成收款。
买家通过使用支付宝 “扫一扫” 功能，扫描商家的二维码等方式完成支付。文档地址：https://opensupport.alipay.com/support/helpcenter/85/201602490909

扫码支付的应用场景

用户打开支付宝中的扫一扫功能，扫描商家展示的二维码进行支付。该模式适用于线下实体店支付、面对面支付、自助售货机等场景。流程如下图所示：

使用说明

收银员在商家收银系统操作生成支付宝订单，并生成二维码。
用户登录支付宝，点击首页扫一扫或点击付钱-扫码付，进入扫码界面。
用户扫收银员提供的二维码，核对金额，确认支付。
用户付款支付宝提示成功或失败，商家收银系统会拿到支付成功或者失败的结果。

1.2 扫码支付demo使用

下载Demo https://opendocs.alipay.com/open/54/104506

扫码支付依赖包 https://mvnrepository.com/artifact/com.alipay.sdk/alipay-sdk-java

沙箱环境 https://opendocs.alipay.com/open/200/105311

生成公私钥工具 https://opendocs.alipay.com/open/291/introduce

公私钥设置说明 https://opendocs.alipay.com/open/291/105971#LDsXr

沙箱app下载地址 https://openhome.alipay.com/platform/appDaily.htm

注意：沙箱环境是一个虚拟环境，主要为了方便开发和测试人员实现接入阿里支付功能的联调，沙箱环境阿里支付宝钱包可以任意转入转出金额。只是沙箱环境App目前只有安卓版，没有IOS版本，这对于经常使用苹果手机的开发者有点不太方便自己测试效果。

1.2.1 下载支付演示代码包

1.2.2 引入扫码支付依赖包

<dependency>   
   <groupId>com.alipay.sdk</groupId>
    <artifactId>alipay-sdk-java</artifactId>
    <version>4.10.0.ALL</version>
</dependency>

1.2.3 导入demo的代码文件

即将下载的demo包解压后拷贝到电商项目中

1.2.4 修改支付宝配置文件

文件名 : zfbinfo.properties

#此处请填写你的PID
pid = 2088702364893848
# 此处请填写你当面付的APPID
appid = 2021000116675801
#此处请填写你的商户私钥且转PKCS8格式
private_key = xxx
#此处请填写你的商户公钥
public_key = xxx

#SHA256withRsa对应支付宝公钥
alipay_public_key = xxx

注：以上private_key、public_key和alipay_public_key都是通过阿里生成公私钥工具获得，具体可查看蚂蚁技术支持官方文档链接：如何生成及配置RSA2密钥(https://opensupport.alipay.com/support/helpcenter/207/201602469554?ant_source=antsupport)

1.2.5 appid 设置

需要前往支付宝开放平台查看，查看链接如下：

https://openhome.alipay.com/platform/appDaily.html

1.2.6 pid 设置

来源：登入支付宝开发者中心查看账户信息

https://openhome.alipay.com/dev/workspace/account-center/main-account-manage

1.2.7 公私钥生成

利用下载的支付宝开放平台开发助手软件生成密钥即可

1.2.8 阿里支付公钥生成

alipay_public_key 来源：

1) 查看密钥

2) 生成支付宝公钥

3) 加签和验签流程

1.5 下载沙箱支付宝APP

点击沙箱应用，使用手机支付宝 App扫描二维码即可下载安装包，安装完成后使用沙箱账号登录

2 整合电商下单
2.1 新建Module

IDEA打开luban-mall项目后选中项目，然后右键->New->Module 选择Maven，点击Next，然后在弹出的对话框中输入模块名mall-order后点击确定即可

2.2 引入Maven依赖

order-pay模块项目pom.xml文件中引入相关maven依赖

<dependencies>
        <!--spring mvc-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!--mysql连接驱动 -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>

        <!-- 支付宝支付SDK -->
        <dependency>
            <groupId>com.alipay.sdk</groupId>
            <artifactId>alipay-sdk-java</artifactId>
            <version>3.3.87.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.10</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>
       <!--使用google gson作为json序列化反序列化工具-->
        <dependency>
            <groupId>com.google.code.gson</groupId>
            <artifactId>gson</artifactId>
            <version>2.8.5</version>
        </dependency>
        <!-- luban-mall公共依赖 -->
        <dependency>
            <groupId>com.luban.mall</groupId>
            <artifactId>mall-common</artifactId>
        </dependency>
    </dependencies>

2.3 导入demo包java文件

（1）将TradePaySDK包下文件拷贝到工程下

将F2FPay_Demo_Java工程两个Java文件和配置文件拷贝到工程下

Main.java

zfbinfo.properties

open_api_domain = https://openapi.alipay.com/gateway.do
mcloud_api_domain = http://mcloudmonitor.com/gateway.do
pid = 此处请填写你的PID
appid = 此处请填写你当面付的APPID
# RSA私钥、公钥和支付宝公钥
private_key = 此处请填写你的商户私钥且转PKCS8格式
public_key = 此处请填写你的商户公钥
#SHA1withRsa对应支付宝公钥
#alipay_public_key = MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDDI6d306Q8fIfCOaTXyiUeJHkrIvYISRcc73s3vF1ZT7XN8RNPwJxo8pWaJMmvyTn9N4HQ632rwCtzvzQETrNRwVxLO5jVmRGi60j8Ue1efIlzPXV9je9mkjzOmdssymZkh2QhUrCmZYI/FCEa3/cNMW0QIDAQAB
#SHA256withRsa对应支付宝公钥
alipay_public_key = MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAjrEVFMOSiNJXaRNKicQuQdsREraftDA9Tua3WNZwcpeXeh8Wrt+V9JilLqSa7N7sVqwp6hEg97Oxe6GKUmzaZRNh0cZZ88vpkn5tlgL4mH/dhSr3Ip00kvM4rHq9PwuT4k7z1DpZAf1eghK8Q5BgxL88d0X07m9X96Ijd0yMkXArzD7jg+noqfbztEKoH3kPMRJC2w4ByVdweWUT2PwrlATpZZtYLmtDvUKG/sOkNAIKEMg3Rut1oKWpjyYanzDgS7Cg3awr1KPTl9rHCazk15aNYowmYtVabKwbGVToCAGK+qQ1gT3ELhkGnf3+h53fukNqRH+wIDAQ

2.4 创建支付下单服务

2.4.1 新建下订单和查询订单状态接口

在mall-order模块项目下的com.luban.mall.service包下新建接口TradeService

类名：com.order.service.impl.PayServiceImpl

public String genQrCode(OrderDetail orderDetail) {
    //支付二维码的访问路径
    String qrCodePath = null;
    // (必填) 商户网站订单系统中唯一订单号，64个字符以内，只能包含字母、数字、下划线，
    // 需保证商户系统端不能重复，建议通过数据库sequence生成，
    String outTradeNo = "tradepay" + System.currentTimeMillis()
            + (long) (Math.random() * 10000000L);
    // (必填) 订单标题，粗略描述用户的支付目的。如“xxx品牌xxx门店消费”
    String subject = "xxx品牌xxx门店当面付消费";
    // (必填) 订单总金额，单位为元，不能超过1亿元
    // 如果同时传入了【打折金额】,【不可打折金额】,【订单总金额】三者,则必须满足如下条件:【订单总金额】=【打折金额】+【不可打折金额】
    String totalAmount = orderDetail.getPayAmount().toString();
    // (必填) 付款条码，用户支付宝钱包手机app点击“付款”产生的付款条码
    String authCode = "用户自己的支付宝付款码"; // 条码示例，286648048691290423
    // (可选，根据需要决定是否使用) 订单可打折金额，可以配合商家平台配置折扣活动，如果订单部分商品参与打折，可以将部分商品总价填写至此字段，默认全部商品可打折
    // 如果该值未传入,但传入了【订单总金额】,【不可打折金额】 则该值默认为【订单总金额】- 【不可打折金额】
    //        String discountableAmount = "1.00"; //
    // (可选) 订单不可打折金额，可以配合商家平台配置折扣活动，如果酒水不参与打折，则将对应金额填写至此字段
    // 如果该值未传入,但传入了【订单总金额】,【打折金额】,则该值默认为【订单总金额】-【打折金额】
    String undiscountableAmount = "0.0";
    // 卖家支付宝账号ID，用于支持一个签约账号下支持打款到不同的收款账号，(打款到sellerId对应的支付宝账号)
    // 如果该字段为空，则默认为与支付宝签约的商户的PID，也就是appid对应的PID
    String sellerId = "";
    // 订单描述，可以对交易或商品进行一个详细地描述，比如填写"购买商品3件共20.00元"
    String body = String.format("购买商品%s件共%s元",orderDetail.getItemList().size(),orderDetail.getPayAmount());
    // 商户操作员编号，添加此参数可以为商户操作员做销售统计
    String operatorId = "bole";
    // (必填) 商户门店编号，通过门店号和商家后台可以配置精准到门店的折扣信息，详询支付宝技术支持
    String storeId = "bole_store_id";
    // 业务扩展参数，目前可添加由支付宝分配的系统商编号(通过setSysServiceProviderId方法)，详情请咨询支付宝技术支持
    String providerId = "2088100200300400500";
    ExtendParams extendParams = new ExtendParams();
    extendParams.setSysServiceProviderId(providerId);
    // 支付超时，线下扫码交易定义为5分钟
    String timeoutExpress = "5m";
    // 商品明细列表，需填写购买商品详细信息，
    List<GoodsDetail> goodsDetailList = new ArrayList<GoodsDetail>();
    // 创建一个商品信息，参数含义分别为商品id（使用国标）、名称、单价（单位为分）、数量，如果需要添加商品类别，详见GoodsDetail
    //GoodsDetail goods1 = GoodsDetail.newInstance("goods_id001", "xxx面包", 1000, 1);
    // 创建好一个商品后添加至商品明细列表
    //goodsDetailList.add(goods1);
    // 继续创建并添加第一条商品信息，用户购买的产品为“黑人牙刷”，单价为5.00元，购买了两件
  //  GoodsDetail goods2 = GoodsDetail.newInstance("goods_id002", "xxx牙刷", 500, 2);
  //  goodsDetailList.add(goods2);
    if(orderDetail!=null){
        orderDetail.getItemList().forEach(o->{
            GoodsDetail good = GoodsDetail.newInstance(o.getOrderSn(),o.getProductName(),o.getProductPrice().multiply(new BigDecimal(100)).longValue(),o.getProductQuantity());
            goodsDetailList.add(good);
        });
    }
    String appAuthToken = "应用授权令牌";//根据真实值填写
    // 创建条码支付请求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);
    // 调用tradePay方法获取当面付应答
    AlipayF2FPrecreateResult result = tradeService.tradePrecreate(builder);
    switch (result.getTradeStatus()) {
        case SUCCESS:
            log.info("支付宝支付成功!");
            AlipayTradePrecreateResponse response= result.getResponse();
            print(response);
            String qrPath=String.format(payConfig.getAlipayPath()+"/qr-%s.png",response.getOutTradeNo());
            String fullQrPath=payConfig.getQrBasePath()+qrPath;
            log.info("本地二维码生成："+fullQrPath);
            ZxingUtils.getQRCodeImge(response.getQrCode(), 256, fullQrPath);
            qrCodePath=payConfig.getHttpResourcePath()+qrPath;
            break;
        case FAILED:
            log.error("支付宝支付失败!!!");
            break;
        case UNKNOWN:
            log.error("系统异常，订单状态未知!!!");
            break;
        default:
            log.error("不支持的交易状态，交易返回异常!!!");
            break;
    }

2.5 映射二维码本地路径到网络

这一功能需要在实现WebMvcConfigurer类的配置类中实现

新建配置类ResourceConfig

@Configuration
publicclass ResourceConfig implements WebMvcConfigurer {
    @Autowired
    private TradePayProp tradePayProp;

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {

        String os = System.getProperty("os.name");
        if(os.toLowerCase().startsWith("win")){ //windows系统
            /** 支付码图片QrCode图片存储路径 */
            registry.addResourceHandler(tradePayProp.getHttpBasePath()
                    +"/**")
                    .addResourceLocations("file:" + tradePayProp.getStorePath() + "/");
        }else{ //linux或者mac
            registry.addResourceHandler("/static/resources/**")
                    .addResourceLocations("file:/usr/local/resources/"); //静态资源
                    //.addResourceLocations("classpath:/META-INF/resources/"); //swagger2页面
        }
    }

}

2.6 创建下单Controller

@PostMapping("/genQrCode")
public CommonResult genQrCode(@RequestBody OrderDetail orderDetail) throws BusinessException {
    String path = payService.genQrCode(orderDetail);
    if(StringUtils.isNotEmpty(path)){
        return  CommonResult.success(path);
    }
    return CommonResult.failed();
}