一篇文章帶你入門Springboot沙箱環(huán)境支付寶支付(附源碼)

更新時(shí)間：2021年06月11日 17:34:25 作者：興趣使然的草帽路飛

螞蟻沙箱環(huán)境 (Beta) 是協(xié)助開發(fā)者進(jìn)行接口功能開發(fā)及主要功能聯(lián)調(diào)的輔助環(huán)境。沙箱環(huán)境模擬了開放平臺(tái)部分產(chǎn)品的主要功能和主要邏輯

0.前言

文章需求：

對(duì)于學(xué)生來說，目前網(wǎng)上確實(shí)沒有比較統(tǒng)一而且質(zhì)量好的支付教程。因?yàn)橹Ц秾?duì)個(gè)人開發(fā)者尤其是學(xué)生來說不太友好。因此，自己折騰兩天，算是整理了一篇關(guān)于支付寶沙箱支付的文章。

那么為什么不用微信沙箱支付呢？

微信支付我在另一篇文章中寫過，用的是別人的公眾號(hào)和開放平臺(tái)賬號(hào)，而微信的沙箱測試我自己也搞了好幾天了也沒弄好，確實(shí)沒有支付寶沙箱測試容易。因?yàn)橹Ц秾毺峁┝艘惶譸c客戶端和手機(jī)端的測試軟件(比如沙箱版支付寶)！

微信和支付寶官方為了開發(fā)者測試和學(xué)習(xí)方便，都提供了沙箱測試環(huán)境下模擬支付業(yè)務(wù)。這篇文章我們就來動(dòng)手搭建一個(gè)支付寶沙箱環(huán)境支付的demo，如果想額外了解微信支付可以看下我的另一篇文章：Springboot整合微信登錄與微信支付(附源碼)

個(gè)人覺得，在沙箱測試支付方面，支付寶會(huì)相較于微信來說更簡單一些，文檔相對(duì)而言比較詳細(xì)，有附帶沙箱支付寶APP，測試遠(yuǎn)比微信沙箱方便！

1.效果展示

說明：沙箱測試并不是真正的支付，所以付款金額也都是模擬的！

在這里插入圖片描述

2.技術(shù)棧介紹

前端demo ：
- Vue-Cli3.x
- Vue3.x
后端demo：SpringBoot2.x + (LomBook插件)
第三方支付：AliPay-SDK

3.前期準(zhǔn)備

第一步：申請(qǐng)一個(gè)沙箱測試賬號(hào)

支付寶沙箱測試賬號(hào)申請(qǐng) 進(jìn)入鏈接后掃碼登錄！

在這里插入圖片描述

第二步：電腦下載一個(gè)支付寶提供的客戶端用于生成RSA2

客戶端工具下載(密鑰生成操作文檔)

在這里插入圖片描述

下載安裝完成后，開始使用，使用參考文檔:幫助文檔

在這里插入圖片描述

第三步：手機(jī)下載【沙箱版支付寶】

在這里插入圖片描述

可以自行掃碼下載，也可以手機(jī)點(diǎn)入鏈接下載，沙箱支付寶下載鏈接

下載后打開沙箱支付寶如下圖：

踩坑：沙箱支付寶登錄所用的賬號(hào)和密碼是以開放平臺(tái)提供的沙箱賬號(hào)為準(zhǔn)，而不是我們的手機(jī)號(hào)或者淘寶賬號(hào)！如圖：

在這里插入圖片描述

如果萌新沒有注意到這一點(diǎn)，直接用自己的手機(jī)號(hào)登錄，是會(huì)出現(xiàn)超時(shí)或者操作頻繁的提示而登錄不了的！(沒錯(cuò)，我就是這個(gè)萌新…)

哈哈，沙箱支付寶里的錢要能轉(zhuǎn)到支付寶中就好了！

4.后端搭建

項(xiàng)目目錄結(jié)構(gòu)

在這里插入圖片描述

pom.xml

<dependencies>
    <!--
       springboot新版本踩坑：
       不加這個(gè)依賴的話，當(dāng)在配置類中
       使用@ConfigurationProperties(prefix = "xxx")注解時(shí)，
       我這個(gè)版本的spring boot會(huì)提示有問題
    -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-configuration-processor</artif
        <optional>true</optional>
    </dependency>
    <!-- 支付寶支付jar包 -->
    <dependency>
        <groupId>com.alipay.sdk</groupId>
        <artifactId>alipay-sdk-java</artifactId>
        <version>3.1.0</version>
    </dependency>
    <!-- fastjson -->
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>fastjson</artifactId>
        <version>1.2.62</version>
    </dependency>
    <!-- web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!-- mybatis -->
    <dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>2.1.3</version>
    </dependency>
    <!-- 熱部署 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-devtools</artifactId>
        <scope>runtime</scope>
        <optional>true</optional>
    </dependency>
    <!-- mysql -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <scope>runtime</scope>
    </dependency>
    <!-- lombok -->
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <optional>true</optional>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
        <exclusions>
            <exclusion>
                <groupId>org.junit.vintage</groupId>
                <artifactId>junit-vintage-engine</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
</dependencies>

application.yml

由于只是demo 演示所以可以不加數(shù)據(jù)庫和mybatis相關(guān)的配置，只留server相關(guān)配置即可

#=====================================server相關(guān)配置=====================================
server:
  port: 8080
#=====================================數(shù)據(jù)庫相關(guān)配置=====================================
spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://127.0.0.1:3306/alipay?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=UTC
    username: root
    password: root
    # 使用Alibaba的druid數(shù)據(jù)源，默認(rèn)使用自帶的
    type: com.alibaba.druid.pool.DruidDataSource
#=====================================mybatis相關(guān)配置=====================================
# 開啟控制臺(tái)打印sql日志
mybatis:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
    # mybatis 下劃線轉(zhuǎn)駝峰配置
    map-underscore-to-camel-case: true
  # 配置mapper文件掃描
  mapper-locations: com.haust.alipaydemoserver.mapper/*.xml
  # 配置實(shí)體類掃描
  type-aliases-package: com.haust.alipaydemoserver.pojo

application-alipay.proerties

# APPID
alipay.appId:2016110100784885
# 商戶私鑰, 即PKCS8格式RSA2私鑰
alipay.privateKey:MIIEvAIBADANBgkqhkiG9w0BAQEFAASCBKYwggSiAgEAAoIBAQCQiliwqcldz8Kb6HALM35rFNif0Tvg7qiywMzC5F8ySt5HgqN5VWIDC/ABTsUb6MlWhdGbC15r7uIwFB7mkDutG6vIZahhfWnCzisZuMebUkMGO9vJJiJDird20nOGyVuvxHYwQ+E777tZKnJM239psXL+o/vfWEtkVu1A6zEoseGc26gBp7Z6czAFGcOvorrWsj6Z93+ZE4LNAb21Hdc0KgILniYwKev38xACRjNn3a3lpRb+e4QQ24vPqIoLTGmw5DcpsEv3uKMRZwQBK8UB7b8ZwJP+yVSJdCVx+6LHP9VQd+RT5BlD8U6328VITsTr3WteHuPxP+t2a17/RWD1AgMBAAECggEATDHiFx8qG94OBQo/Jmh62BAhMf6mxiiJndGtH4Ar/uMg0im365prFJgSaV4Q4mmQ2Z+po0YW/GbtrdKth3W5P8Q6hmWwodPvENaGOgUClIqE8qBTeHI11c0mcej3JbK4NqwmccMW1PXHmXWa05FSVXFJ4ZqoiFCPTdHVOEfDnmN54DFgoEKYPk6q/xxQmIpwqHQH+s3S2eFSU0rt0aqiKBg2mqKSMYzLE+8vB7FWJS61Cy0mzYVugfgWx2KTQy8y1SC4i4mjQ50DQQ2AgbNr+k8l5G7p7Cja+KDQ6JbGv4nR8DC+sPNhxECDHrSpYDn6BYqw8aRwvN6nmaCdoU3GcQKBgQDheWn3kpJz8r8wdy15WaWzItZD+c8Qwou997bn3iBR7RdFi5INNXmlr5TRc3Lr3d5uidzl4ues2dLnqRYh7tYMQudB6HoweWoPlig6gXblamn6am5MvpFRK9Lsl1zNbN82DDvVH6oaDPvqD+KLPvZ1MIWRQiTz7eRvwo9NYTqKYwKBgQCkG+Q2N2U5g0t6baZ1/TlWpFKnb1t17JTHfwfmbwotnLcKQRVWzqayOdPsKtFHqyhmnhH7BlLt1a1QqK5d/a2KH80i7Y0jmv8Pglpt+gfxEQt87gD8+uZrvx33EpU8KCIwhFNshw4FUr5yB5BcLNQo92NsO0ujHhFC6Q/LxX9axwKBgH3WJS3mv5W2hL2nxdlUDwZLCwolAUt5SERdW9dMQP14NOS7YGe+0IWH2KaMqDa7PMi0aHRkjqgJaYug8pk9kniFXkuKU6d6G5dXVlxQpOqk2UDI5YYvVSrYKn+gekqr2GdxrHLlmSmw1WdsNiNAoIwG6ISJRdZdjoBRNWkaOnHBAoGADpa0KOWvx/cWBKIuxBpouH0PI/dQSCFp8Hood6GzY+6kjvLONNNWGk3tuvbrd9WNV+IBczFSufXe3GbCaXSdssO09r/rZhjnR7es1k392r5LKSX3TIX5aeapgUdToO9oaqu4xtMSugJrD7QAb1FE4wdq/TogNTX9DtetIc5Czg0CgYBGmAHwxJmvokrFmk8ZPkj544tZ9emY1aaUY0jqW21wWCHcRID2+56jsDXXb6IH/Hn9DgHndkl3v9ql6Ha2Y/j2t2Q9XA31QoUmKHU+6QA1aw+GP3VSaLTwlCMgGeWjA9imiFc3pEkS3JrNm3ASdwp+1TPIjcWcxa/ZU+JWrdM3bA==
# 支付寶公鑰, 即對(duì)應(yīng)APPID下的支付寶公鑰
alipay.publicKey:MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAlREBzwWQaJd6ZzSrYlnucsvlX3jV1swYdnymIRsbrObxftBFoKcvuMnqzCgRhvqZN4NEJvW+cQZkbk4otPvk+g+uIK1ZNjF+Cln/gePwHq3WRCrhWFwwBVWASJwPg/XISuaahjXicLb9z2AxvKcNZsLDL46HHO442mniGGOlD8PqK6LvvrhRUvhYgvY5SQ0RfRT0LUnxNl2evsdVOl3dlS6EuQVe4DrqpKS2WseVuXsA8nbXzBKwmR3vcqoxnDI/Nu8ldSLS+KEMEFh6MUL9OcTwhHr4/F8MdKtMSSWru+5m4q8BGNxW4PAP5GM3e1cBlxi/8FnBamL0jIlnhH/8qwIDAQAB
# 服務(wù)器異步通知頁面路徑, 需http://格式的完整路徑
# 踩坑:不能加?type=abc這類自定義參數(shù)
alipay.notifyUrl:
# 頁面跳轉(zhuǎn)同步通知頁面路徑, 需http://格式的完整路徑
# 踩坑:不能加?type=abc這類自定義參數(shù)
alipay.returnUrl:http://192.168.0.106:8084/#/paySuccess
# 簽名方式
alipay.signType:RSA2
# 字符編碼格式
alipay.charset:utf-8
# 支付寶網(wǎng)關(guān)
alipay.gatewayUrl:https://openapi.alipaydev.com/gateway.do
# 日志打印地址
alipay.logPath:"F:\\"

Order訂單實(shí)體類

這里我使用了lombok插件，所以以注解的方式節(jié)省了setter/getter 以及構(gòu)造函數(shù)

package com.haust.alipaydemoserver.pojo;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.experimental.Accessors;
/**
 * @Auther: csp1999
 * @Date: 2020/11/13/21:49
 * @Description: 商品訂單實(shí)體類(支付實(shí)體對(duì)象)
 */
@Data
@AllArgsConstructor
@NoArgsConstructor
@Accessors(chain = true)
public class Order {
    /**
     * 商戶訂單號(hào)，必填
     */
    private String out_trade_no;
    /**
     * 訂單名稱，必填
     */
    private String subject;
    /**
     * 付款金額，必填
     * 根據(jù)支付寶接口協(xié)議，必須使用下劃線
     */
    private String total_amount;
    /**
     * 商品描述，可空
     */
    private String description;
    /**
     * 超時(shí)時(shí)間參數(shù)
     */
    private String timeout_express = "10m";
    /**
     * 產(chǎn)品編號(hào)
     */
    private String product_code = "FAST_INSTANT_TRADE_PAY";
}

Service層

/**
 * @Auther: csp1999
 * @Date: 2020/11/13/21:55
 * @Description: 支付 service
 */
public interface AliPayService {
    /**
     * 支付寶支付接口
     * @param order
     * @return
     * @throws AlipayApiException
     */
    String aliPay(Order order) throws AlipayApiException;
}

/**
 * @Auther: csp1999
 * @Date: 2020/11/13/21:56
 * @Description: 支付service 實(shí)現(xiàn)類
 */
@Service
public class AliPayServiceImpl implements AliPayService {
    @Autowired
    private Alipay alipay;
    @Override
    public String aliPay(Order order) throws AlipayApiException {
        return alipay.pay(order);
    }
}

Controller層

/**
 * @Auther: csp1999
 * @Date: 2020/11/13/21:47
 * @Description: 支付寶沙箱測試 controller
 */
@RestController
public class PayController {
    @Autowired
    private AliPayService aliPayService;
    /**
     * 支付寶支付 api
     *
     * @param outTradeNo
     * @param subject
     * @param totalAmount
     * @param description
     * @return
     * @throws AlipayApiException
     */
    @PostMapping(value = "/order/alipay")
    public String alipay(String outTradeNo, String subject,
                         String totalAmount, String description) throws AlipayApiException {
        Order order = new Order();
        order.setOut_trade_no(outTradeNo);
        order.setSubject(subject);
        order.setTotal_amount(totalAmount);
        order.setDescription(description);
        System.out.println(order);
        return aliPayService.aliPay(order);
    }
}

配置類

支付寶支付配置類以及支付寶支付組件注入Spring容器

AliPayConfig.java

/**
 * @Auther: csp1999
 * @Date: 2020/11/13/19:19
 * @Description: 支付寶配置類(讀取配置文件)
 */
@Configuration
@PropertySource("classpath:application-alipay.properties")
@ConfigurationProperties(prefix = "alipay")
@Data
public class AliPayConfig {
    /**
     * APPID
     */
    private String appId;
    /**
     * 商戶私鑰, 即PKCS8格式RSA2私鑰
     */
    private String privateKey;
    /**
     * 支付寶公鑰
     */
    private String publicKey;
    /**
     * 服務(wù)器異步通知頁面路徑,需http://格式的完整路徑
     * 踩坑:不能加?type=abc這類自定義參數(shù)
     */
    private String notifyUrl;
    /**
     * 頁面跳轉(zhuǎn)同步通知頁面路徑,需http://格式的完整路徑
     * 踩坑:不能加?type=abc這類自定義參數(shù)
     */
    private String returnUrl;
    /**
     * 簽名方式
     */
    private String signType;
    /**
     * 字符編碼格式
     */
    private String charset;
    /**
     * 支付寶網(wǎng)關(guān)
     */
    private String gatewayUrl;
    /**
     * 日志打印地址
     */
    private String logPath;
}

Alipay.java

/**
 * @Auther: csp1999
 * @Date: 2020/11/13/21:57
 * @Description: 調(diào)用支付寶支付的組件
 */
@Component
public class Alipay {
    @Autowired
    private AliPayConfig alipayConfig;
    /**
     * 支付接口
     *
     * @param order
     * @return
     * @throws AlipayApiException
     */
    public String pay(Order order) throws AlipayApiException {
        // 支付寶網(wǎng)關(guān)
        String serverUrl = alipayConfig.getGatewayUrl();
        // APPID
        String appId = alipayConfig.getAppId();
        // 商戶私鑰, 即PKCS8格式RSA2私鑰
        String privateKey = alipayConfig.getPrivateKey();
        // 格式化為 json 格式
        String format = "json";
        // 字符編碼格式
        String charset = alipayConfig.getCharset();
        // 支付寶公鑰, 即對(duì)應(yīng)APPID下的支付寶公鑰
        String alipayPublicKey = alipayConfig.getPublicKey();
        // 簽名方式
        String signType = alipayConfig.getSignType();
        // 頁面跳轉(zhuǎn)同步通知頁面路徑
        String returnUrl = alipayConfig.getReturnUrl();
        // 服務(wù)器異步通知頁面路徑
        String notifyUrl = alipayConfig.getNotifyUrl();
        // 1、獲得初始化的AlipayClient
        AlipayClient alipayClient = new DefaultAlipayClient(
                serverUrl, appId, privateKey, format, charset, alipayPublicKey, signType);
        // 2、設(shè)置請(qǐng)求參數(shù)
        AlipayTradePagePayRequest alipayRequest = new AlipayTradePagePayRequest();
        // 頁面跳轉(zhuǎn)同步通知頁面路徑
        alipayRequest.setReturnUrl(returnUrl);
        // 服務(wù)器異步通知頁面路徑
        alipayRequest.setNotifyUrl(notifyUrl);
        // 封裝參數(shù)(以json格式封裝)
        alipayRequest.setBizContent(JSON.toJSONString(order));
        // 3、請(qǐng)求支付寶進(jìn)行付款，并獲取支付結(jié)果
        String result = alipayClient.pageExecute(alipayRequest).getBody();
        // 返回付款信息
        return result;
    }
}

跨域攔截器配置以及注冊(cè)

CorsInterceptor.java

/**
 * @Auther: csp1999
 * @Date: 2020/10/21/12:06
 * @Description: 跨域攔截器
 */
public class CorsInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, 
                             HttpServletResponse response, Object handler) throws Exception {
        //表示接受任意域名的請(qǐng)求,也可以指定域名
        response.setHeader("Access-Control-Allow-Origin", request.getHeader("origin"));
        //該字段可選，是個(gè)布爾值，表示是否可以攜帶cookie
        response.setHeader("Access-Control-Allow-Credentials", "true");
        response.setHeader("Access-Control-Allow-Methods", "GET, HEAD, POST, PUT, PATCH, DELETE, OPTIONS");
        response.setHeader("Access-Control-Allow-Headers", "*");
        // 預(yù)檢處理，方行所有非簡單請(qǐng)求方法
        if (HttpMethod.OPTIONS.toString().equals(request.getMethod())) {
            return true;
        }
        return true;
    }
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, 
                           Object handler, ModelAndView modelAndView) throws Exception {
    }
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, 
                                Object handler, Exception ex) throws Exception {
    }
}

InterceptorConfig.java

/**
 * @Auther: csp1999
 * @Date: 2020/10/20/13:26
 * @Description: 攔截器配置
 */
@Configuration
public class InterceptorConfig implements WebMvcConfigurer {
    /*
     * 將跨域攔截器交給spring容器托管
     * @return: com.haust.online_class.interceptor.CorsInterceptor
     * @create: 2020/10/21 12:20
     * @author: csp1999
     */
    @Bean
    public CorsInterceptor corsInterceptor() {
        return new CorsInterceptor();
    }
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        // 跨域攔截器注冊(cè)(注意：跨域攔截器注冊(cè)要放在最上方)
        registry.addInterceptor(corsInterceptor()).addPathPatterns("/**");
        WebMvcConfigurer.super.addInterceptors(registry);
    }
}