付出宝沙箱版（什么是付出宝沙箱、配置付出宝沙箱、配置内网穿透、在Spring ...

0. 媒介

许多项目都需要有付出功能，但是对接第三方付出又需要企业资质，作为个人开发者，达不到这个条件，但付出功能是项目中一个很紧张的的部门，面试官也比较喜好问，如果面试官问与付出功能的相关的问题时，我们说由于没有企业资质，跳过了付出功能，那就错失了一次在面试官面前表现本身的机会
本日为大家介绍的付出宝沙箱正是为相识决这一痛点，通过使用付出宝沙箱，我们就能够在项目中模拟真正的付出，让我们的项目锦上添花（使用付出宝沙箱无需企业资质，只需要一个付出宝账号）
1. 什么是付出宝沙箱

付出宝沙箱（Alipay Sandbox）是付出宝为开发者提供的一个模拟真实付出宝情况的测试平台。开发者可以在沙箱情况中进行应用程序的开发和测试，无需使用真实的付出宝账户进行买卖业务

---

以下是付出宝沙箱的一些特点和用途：

• 安全隔离：沙箱情况与生产情况是隔离的，开发者可以在不影响真实用户数据的情况下进行测试
  
• 模拟买卖业务：沙箱允许开发者模拟各种买卖业务场景，如付出、退款、转账等，以便验证应用程序的功能
  
• 测试账号：付出宝沙箱提供测试用的商户ID和应用ID，以及模拟的买家和卖家账户，用于测试付出流程
  
• API调用：开发者可以使用沙箱情况中的API进行接口调用，测试接口的相应和数据返回是否符合预期
  
• 问题排查：在沙箱中测试可以资助开发者发现和解决在集成付出宝付出时可能出现的问题
  
• 文档和工具：付出宝沙箱提供详细的文档和测试工具，资助开发者更快地熟悉和掌握付出宝API的使用
  

---

付出宝沙箱对于希望集成付出宝付出服务的开发者来说是一个非常有用的工具，它能够资助开发者在不影响实际业务的情况下，高效、安全地完成付出功能的开发和测试工作
2. 配置付出宝沙箱

付出宝沙箱官网：沙箱应用 - 开放平台 （打开官网后需要用真实的付出宝账号进行登录）
2.1 沙箱应用的应用信息（获取app-id和gateway-url）

APPID 和 付出宝网关所在 字段下面会用到

2.2 沙箱账号的商家信息和买家信息

买家账号在付款时会用到

2.3 下载秘钥工具

下载所在：密钥工具下载 - 付出宝文档中央 (alipay.com)

   请不要安装在含有空格的目次路径下，否则会导致公私钥乱码的问题
  2.4 天生秘钥（获取private-key）

秘钥天生乐成的界面（应用私钥对应 private-key）

2.5 配置秘钥（获取alipay-public-key）

配置所在：沙箱应用 - 开放平台 (alipay.com)

---

点击自定义秘钥，再点击公钥模式的设置并检察

将刚才天生的应用公钥复制过来，接着点击生存按钮

最后点击确定按钮

将得到的付出宝公钥生存下来（付出宝公钥对应 alipay-public-key）
3. 配置内网穿透

3.1 使用cpolar实现内网穿透

我们使用 cpolar 来实现内网穿透，cpolar 的使用教程可参考我的另一篇博文：使用cpolar实现内网穿透，将Web项目部署到公网上
3.2 创建隧道（获取notify-url）

在欣赏器输入以下网址，创建隧道

1. http://localhost:9200/#/tunnels/create

复制代码

创建隧道后会有一个公网所在，下面会用到

   cpolar 天生的公网所在在电脑重启之后可能会发生变化
  4. 在SpringBoot项目中怎样对接付出宝沙箱

本次演示的后端情况为：JDK 17.0.7 + SpringBoot 3.0.2
4.1 引入依赖（付出宝文档中央）

在项目的 pom.xml 文件中引入依赖（本次演示使用的是较新的版本，付出宝文档中央的版本是 4.34.0.ALL）

1. <dependency>
2.     <groupId>com.alipay.sdk</groupId>
3.     <artifactId>alipay-sdk-java</artifactId>
4.     <version>4.39.218.ALL</version>
5. </dependency>

复制代码

完备的官方文档：通用版 - 付出宝文档中央 (alipay.com)

---

为了方便测试，我们额外引入 Spring Web 和 fastjson2 的依赖

1. <dependency>
2.     <groupId>org.springframework.boot</groupId>
3.     <artifactId>spring-boot-starter-web</artifactId>
4. </dependency>

复制代码

1. <dependency>
2.     <groupId>com.alibaba.fastjson2</groupId>
3.     <artifactId>fastjson2</artifactId>
4.     <version>2.0.53</version>
5. </dependency>

复制代码

4.2 编写实体类

我们编写一个简单的实体类，用于测试

1. /**
2. * 订单类
3. */
4. public class Order {
6.     /**
7.      * 用于唯一标识一次支付请求，可以是订单号或与其他业务相关的唯一标识
8.      */
9.     private Long id;
11.     /**
12.      * 支付的总金额
13.      */
14.     private String totalAmount;
16.     /**
17.      * 支付时显示的商品描述
18.      */
19.     private String productDescription;
21.     /**
22.      * 支付时显示的商品名称
23.      */
24.     private String productName;
26.     public Long getId() {
27.         return id;
28.     }
30.     public void setId(Long id) {
31.         this.id = id;
32.     }
34.     public String getTotalAmount() {
35.         return totalAmount;
36.     }
38.     public void setTotalAmount(String totalAmount) {
39.         this.totalAmount = totalAmount;
40.     }
42.     public String getProductDescription() {
43.         return productDescription;
44.     }
46.     public void setProductDescription(String productDescription) {
47.         this.productDescription = productDescription;
48.     }
50.     public String getProductName() {
51.         return productName;
52.     }
54.     public void setProductName(String productName) {
55.         this.productName = productName;
56.     }
58.     @Override
59.     public String toString() {
60.         return "Order{" +
61.                 "id=" + id +
62.                 ", totalAmount='" + totalAmount + '\'' +
63.                 ", productDescription='" + productDescription + '\'' +
64.                 ", productName='" + productName + '\'' +
65.                 '}';
66.     }
68. }

复制代码

4.3 编写配置属性类

AlipayConfiguration.java

1. import org.springframework.boot.context.properties.ConfigurationProperties;
2. import org.springframework.stereotype.Component;
4. @Component
5. @ConfigurationProperties(prefix = "alipay")
6. public class AlipayConfiguration {
8.     private String appId;
10.     private String gatewayUrl;
12.     private String privateKey;
14.     private String alipayPublicKey;
16.     private String notifyUrl;
18.     private String returnUrl;
20.     public String getAppId() {
21.         return appId;
22.     }
24.     public void setAppId(String appId) {
25.         this.appId = appId;
26.     }
28.     public String getGatewayUrl() {
29.         return gatewayUrl;
30.     }
32.     public void setGatewayUrl(String gatewayUrl) {
33.         this.gatewayUrl = gatewayUrl;
34.     }
36.     public String getPrivateKey() {
37.         return privateKey;
38.     }
40.     public void setPrivateKey(String privateKey) {
41.         this.privateKey = privateKey;
42.     }
44.     public String getAlipayPublicKey() {
45.         return alipayPublicKey;
46.     }
48.     public void setAlipayPublicKey(String alipayPublicKey) {
49.         this.alipayPublicKey = alipayPublicKey;
50.     }
52.     public String getNotifyUrl() {
53.         return notifyUrl;
54.     }
56.     public void setNotifyUrl(String notifyUrl) {
57.         this.notifyUrl = notifyUrl;
58.     }
60.     public String getReturnUrl() {
61.         return returnUrl;
62.     }
64.     public void setReturnUrl(String returnUrl) {
65.         this.returnUrl = returnUrl;
66.     }
68.     @Override
69.     public String toString() {
70.         return "AlipayConfiguration{" +
71.                 "appId='" + appId + '\'' +
72.                 ", gatewayUrl='" + gatewayUrl + '\'' +
73.                 ", privateKey='" + privateKey + '\'' +
74.                 ", alipayPublicKey='" + alipayPublicKey + '\'' +
75.                 ", notifyUrl='" + notifyUrl + '\'' +
76.                 ", returnUrl='" + returnUrl + '\'' +
77.                 '}';
78.     }
80. }

复制代码

4.4 编写controller（设置notify-url和return-url）

AlipayController.java

1. import cn.edu.scau.config.AlipayConfiguration;
2. import cn.edu.scau.pojo.Order;
3. import com.alibaba.fastjson2.JSONObject;
4. import com.alipay.api.AlipayApiException;
5. import com.alipay.api.AlipayClient;
6. import com.alipay.api.DefaultAlipayClient;
7. import com.alipay.api.diagnosis.DiagnosisUtils;
8. import com.alipay.api.domain.AlipayTradeRefundModel;
9. import com.alipay.api.request.AlipayTradePagePayRequest;
10. import com.alipay.api.request.AlipayTradeRefundRequest;
11. import com.alipay.api.response.AlipayTradeRefundResponse;
12. import jakarta.servlet.http.HttpServletRequest;
13. import jakarta.servlet.http.HttpServletResponse;
14. import org.springframework.stereotype.Controller;
15. import org.springframework.web.bind.annotation.*;
17. import java.io.IOException;
18. import java.util.ArrayList;
19. import java.util.Arrays;
20. import java.util.List;
21. import java.util.Map;
23. import static com.alipay.api.AlipayConstants.*;
25. @Controller
26. @RequestMapping("/alipay")
27. public class AlipayController {
29.     private final AlipayConfiguration alipayConfiguration;
31.     public AlipayController(AlipayConfiguration alipayConfiguration) {
32.         this.alipayConfiguration = alipayConfiguration;
33.     }
35.     @GetMapping("/pay")
36.     public void pay(@RequestParam Long orderId, HttpServletResponse httpResponse) throws IOException {
37.         // 创建默认的支付宝客户端实例
38.         AlipayClient alipayClient = new DefaultAlipayClient(
39.                 alipayConfiguration.getGatewayUrl(),
40.                 alipayConfiguration.getAppId(),
41.                 alipayConfiguration.getPrivateKey(),
42.                 FORMAT_JSON,
43.                 CHARSET_UTF8,
44.                 alipayConfiguration.getAlipayPublicKey(),
45.                 SIGN_TYPE_RSA2
46.         );
48.         AlipayTradePagePayRequest alipayTradePagePayRequest = new AlipayTradePagePayRequest();
49.         // 设置异步通知地址
50.         alipayTradePagePayRequest.setNotifyUrl(alipayConfiguration.getNotifyUrl());
51.         // 设置重定向地址
52.         alipayTradePagePayRequest.setReturnUrl(alipayConfiguration.getReturnUrl());
54.         Order order = new Order();
55.         order.setId(orderId); // 商户订单号
56.         order.setProductName("爱国者键盘"); // 商品名称
57.         order.setProductDescription("键盘中的战斗机"); // 商品描述
58.         order.setTotalAmount("0.01"); // 付款金额，必填
60.         // 构造业务请求参数（如果是电脑网页支付，product_code是必传参数）
61.         JSONObject jsonObject = new JSONObject();
62.         jsonObject.put("out_trade_no", order.getId());
63.         jsonObject.put("subject", order.getProductName());
64.         jsonObject.put("body", order.getProductDescription());
65.         jsonObject.put("total_amount", order.getTotalAmount());
66.         jsonObject.put("product_code", "FAST_INSTANT_TRADE_PAY");
68.         alipayTradePagePayRequest.setBizContent(jsonObject.toJSONString());
70.         // 请求支付宝接口
71.         String alipayForm;
72.         try {
73.             alipayForm = alipayClient.pageExecute(alipayTradePagePayRequest).getBody();
74.         } catch (AlipayApiException e) {
75.             throw new RuntimeException(e);
76.         }
78.         // 将表单直接输出到页面，用户点击后会跳转到支付宝支付页面
79.         httpResponse.setContentType("text/html;charset=" + CHARSET_UTF8);
80.         httpResponse.getWriter().write(alipayForm);
81.         httpResponse.getWriter().flush();
82.         httpResponse.getWriter().close();
83.     }
85.     /**
86.      * 处理支付宝异步通知的接口（注意这里必须是POST接口）
87.      *
88.      * @param request HTTP请求对象，包含支付宝返回的通知信息
89.      * @return 返回给支付宝的确认信息
90.      */
91.     @PostMapping("/notify")
92.     @ResponseBody
93.     public String payNotify(HttpServletRequest request) {
94.         System.err.println("====================payNotify====================");
96.         // 获取支付宝返回的各个参数
97.         Map<String, String[]> requestParameterMap = request.getParameterMap();
98.         requestParameterMap.forEach((key, value) -> System.err.println(key + " = " + Arrays.toString(value)));
100.         // 检查交易状态是否为成功
101.         if ("TRADE_SUCCESS".equals(request.getParameter("trade_status"))) {
102.             System.err.println("交易成功");
104.             // 执行更新数据库中的订单状态等操作
105.         }
107.         System.err.println("====================payNotify====================");
108.         System.err.println();
110.         // 告诉支付宝，已经成功收到异步通知
111.         return "success";
112.     }
114.     @GetMapping("/return")
115.     public void payReturn(HttpServletRequest request, HttpServletResponse response) throws Exception {
116.         System.out.println("====================payReturn====================");
118.         // 获取支付宝返回的各个参数
119.         Map<String, String[]> requestParameterMap = request.getParameterMap();
120.         System.out.println("支付宝返回的参数：");
121.         requestParameterMap.forEach((key, value) -> System.out.println(key + " = " + Arrays.toString(value)));
123.         System.out.println("====================payReturn====================");
124.         System.out.println();
126.         // 设置响应的字符编码为UTF-8，防止中文乱码
127.         response.setCharacterEncoding("UTF-8");
129.         // 设置响应的内容类型为HTML，并指定字符编码为UTF-8
130.         response.setContentType("text/html; charset=UTF-8");
132.         // 重定向到指定的HTML页面（需要提前与前端沟通好支付成功后要跳转的页面）
133.         response.sendRedirect("http://localhost:5173/paySuccess");
134.     }
136.     @GetMapping("/refund")
137.     @ResponseBody
138.     public String refund(@RequestParam(required = false) Long id, @RequestParam(required = false) String tradeNo) {
139.         System.out.println("====================refund====================");
141.         // 创建默认的支付宝客户端实例
142.         AlipayClient alipayClient = new DefaultAlipayClient(
143.                 alipayConfiguration.getGatewayUrl(),
144.                 alipayConfiguration.getAppId(),
145.                 alipayConfiguration.getPrivateKey(),
146.                 FORMAT_JSON,
147.                 CHARSET_UTF8,
148.                 alipayConfiguration.getAlipayPublicKey(),
149.                 SIGN_TYPE_RSA2
150.         );
152.         Order order = new Order();
153.         order.setId(id);
154.         order.setProductName("爱国者键盘");
155.         order.setProductDescription("键盘中的战斗机");
156.         order.setTotalAmount("0.01");
158.         AlipayTradeRefundRequest alipayTradeRefundRequest = new AlipayTradeRefundRequest();
159.         AlipayTradeRefundModel alipayTradeRefundModel = new AlipayTradeRefundModel();
161.         // 设置商户订单号
162.         if (id != null) {
163.             alipayTradeRefundModel.setOutTradeNo(String.valueOf(order.getId()));
164.         }
166.         // 设置查询选项
167.         List<String> queryOptions = new ArrayList<>();
168.         queryOptions.add("refund_detail_item_list");
169.         alipayTradeRefundModel.setQueryOptions(queryOptions);
170.         // 设置退款金额
171.         alipayTradeRefundModel.setRefundAmount("0.01");
172.         // 设置退款原因说明
173.         alipayTradeRefundModel.setRefundReason("正常退款");
174.         // 设置流水订单号
175.         if (tradeNo != null && !tradeNo.isEmpty()) {
176.             alipayTradeRefundModel.setTradeNo(tradeNo);
177.         }
179.         alipayTradeRefundRequest.setBizModel(alipayTradeRefundModel);
180.         // 执行请求
181.         AlipayTradeRefundResponse alipayTradeRefundResponse = null;
183.         int count = 1;
184.         int limit = 3;
185.         while (count <= limit) { // 最多重试3次
186.             try {
187.                 alipayTradeRefundResponse = alipayClient.execute(alipayTradeRefundRequest);
188.                 break;
189.             } catch (AlipayApiException e) {
190.                 System.out.println("第" + count + "次重试");
191.                 e.printStackTrace();
192.                 count++;
193.             }
194.         }
196.         if (count > limit || alipayTradeRefundResponse == null) {
197.             return "退款失败，请联系客服人员";
198.         }
200.         System.out.println("alipayTradeRefundResponse.getBody() = " + alipayTradeRefundResponse.getBody());
201.         System.out.println("====================refund====================");
202.         System.out.println();
204.         if (!alipayTradeRefundResponse.isSuccess()) {
205.             // SDK版本是"4.38.0.ALL"及以上,可以参考下面的示例获取诊断链接
206.             String diagnosisUrl = DiagnosisUtils.getDiagnosisUrl(alipayTradeRefundResponse);
207.             System.out.println("diagnosisUrl = " + diagnosisUrl);
209.             return "退款失败，请联系客服人员";
210.         }
212.         if ("N".equals(alipayTradeRefundResponse.getFundChange())) {
213.             return "该订单已经退款，请勿重复操作";
214.         }
216.         return "退款成功";
217.     }
219. }

复制代码

  需要提前与前端沟通好付出乐成后要跳转的页面
  4.5 编写配置文件

   SpringBoot 应用程序的端口号需要与内网穿透中隧道的端口号保持一致
  application.yml

1. alipay:
2.   # app-id：支付宝开放平台中的APPID
3.   app-id:
4.   # gateway-url：支付宝开放平台中的支付宝网关地址
5.   gateway-url:
6.   # private-key：在支付宝开放平台秘钥工具中生成的应用私钥
7.   private-key:
8.   # alipay-public-key：支付宝开放平台中的支付宝公钥
9.   alipay-public-key:
10.   # notify-url：支付宝通过该URL通知交易状态变化
11.   notify-url:
12.   # return-url：用户完成支付后，支付宝会重定向到该URL
13.   return-url: http://localhost:10005/alipay/return
15. server:
16.   port: 10005

复制代码

  cpolar 天生的公网所在在电脑重启之后可能会发生变化，需要更改 notify-url 属性
  5. 前端代码

本次演示使用的是由 Vue3 搭建的工程
5.1 vite.config.js

1. import {fileURLToPath, URL} from 'node:url'
3. import {defineConfig} from 'vite'
4. import vue from '@vitejs/plugin-vue'
6. // https://vitejs.dev/config/
7. export default defineConfig({
8.   plugins: [
9.     vue()
10.   ],
11.   resolve: {
12.     alias: {
13.       '@': fileURLToPath(new URL('./src', import.meta.url))
14.     }
15.   },
16.   server: {
17.     proxy: {
18.       '/api': {
19.         target: 'http://localhost:10005',
20.         changeOrigin: true,
21.         rewrite: (path) => path.replace('/api', '')
22.       }
23.     }
24.   }
25. })

复制代码

关键代码

5.2 src/utils/request.js

1. import axios from 'axios'
3. const request = axios.create({
4.   baseURL: '/api',
5.   timeout: 20000,
6.   headers: {
7.     'Content-Type': 'application/json;charset=UTF-8'
8.   }
9. })
11. request.interceptors.request.use(
13. )
15. request.interceptors.response.use(response => {
16.   if (response.data) {
17.     return response.data
18.   }
19.   return response
20. }, (error) => {
21.   // Do something with response error
22.   return Promise.reject(error)
23. })
25. export default request

复制代码

5.3 src/router/index.js

1. import {createRouter, createWebHistory} from 'vue-router'
2. import HomeView from '../views/HomeView.vue'
4. const router = createRouter({
5.   history: createWebHistory(import.meta.env.BASE_URL),
6.   routes: [
7.     {
8.       path: '/',
9.       name: 'home',
10.       component: HomeView
11.     }, {
12.       path: '/paySuccess',
13.       name: 'paySuccess',
14.       component: () => import('../views/PaySuccess.vue')
15.     }
16.   ]
17. })
19. export default router

复制代码

5.4 src/views/HomeView.vue

1. <template>
2.   <div class="payment-container">
3.     <input type="number" v-model="orderId" placeholder="订单号" class="input-field">
4.     <button class="pay-button" @click="pay">支付</button>
5.     <div ref="alipayForm" class="hidden-form"></div>
6.   </div>
7. </template>
9. <script setup>
10. import request from '@/utils/request.js'
11. import { ref } from 'vue'
13. const alipayForm = ref()
14. const orderId = ref('')
16. const pay = () => {
17.   request
18.       .get('/alipay/pay', {
19.         params: {
20.           orderId: orderId.value
21.         }
22.       })
23.       .then((response) => {
24.         let innerHtml = response.toString()
25.         innerHtml = innerHtml.substring(0, innerHtml.indexOf('<script>'))
26.         alipayForm.value.innerHTML = innerHtml
27.         window.document.forms[0].submit()
28.       })
29.       .catch((error) => {
30.         console.error('支付请求错误:', error)
31.       })
32. }
33. </script>
35. <style scoped>
36. .payment-container {
37.   display: flex;
38.   flex-direction: column;
39.   align-items: center;
40.   justify-content: center;
41.   min-height: 100vh;
42.   background-color: #f0f8ff; /* 淡蓝色背景 */
43.   font-family: Arial, sans-serif;
44. }
46. .input-field {
47.   width: 300px; /* 输入框宽度 */
48.   margin: 10px 0; /* 上下间距 */
49.   padding: 15px; /* 内边距 */
50.   border: 2px solid #c7e0ff; /* 边框颜色 */
51.   border-radius: 5px; /* 圆角 */
52.   outline: none; /* 去除默认轮廓 */
53.   font-size: 16px; /* 字体大小 */
54.   transition: border-color 0.3s; /* 平滑过渡效果 */
55. }
57. .input-field:focus {
58.   border-color: #007bff; /* 聚焦时的边框颜色 */
59. }
61. .pay-button {
62.   width: 333px; /* 按钮宽度比输入框略长 */
63.   margin: 10px 0; /* 上下间距 */
64.   padding: 15px; /* 内边距 */
65.   border: none; /* 无边框 */
66.   border-radius: 5px; /* 圆角 */
67.   background-color: #007bff; /* 按钮颜色 */
68.   color: white; /* 文字颜色 */
69.   cursor: pointer; /* 鼠标指针样式 */
70.   font-size: 16px; /* 字体大小 */
71.   transition: background-color 0.3s; /* 平滑过渡效果 */
72. }
74. .pay-button:hover {
75.   background-color: #0056b3; /* 悬停时更深的颜色 */
76. }
78. .hidden-form {
79.   display: none; /* 隐藏表单 */
80. }
81. </style>

复制代码

关键代码如下

5.5 src/views/paySuccess.vue

1. <template>
2.   <div class="success-container">
3.     <div class="success-icon">
4.       <svg width="100" height="100" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
5.         <path
6.             d="M12 2C6.48 2 2 6.48 2 12C2 17.52 6.48 22 12 22C17.52 22 22 17.52 22 12C22 6.48 17.52 2 12 2ZM12 20C7.59 20 4 16.41 4 12C4 7.59 7.59 4 12 4C16.41 4 20 7.59 20 12C20 16.41 16.41 20 12 20ZM16.59 7.58L10 14.17L7.41 11.59L6 13L10 17L18 9L16.59 7.58Z"
7.             fill="#4CAF50"/>
8.       </svg>
9.     </div>
10.     <h1>支付成功</h1>
11.     <p class="success-message">您已完成支付，感谢您的使用</p>
13.     <button class="btn" @click="returnHomePage">返回首页</button>
14.   </div>
15. </template>
17. <script setup>
18. import router from '@/router/index.js'
20. const returnHomePage = () => {
21.   router.push('/')
22. }
23. </script>
25. <style scoped>
26. .success-container {
27.   display: flex;
28.   flex-direction: column;
29.   align-items: center;
30.   justify-content: center;
31.   height: 100vh;
32.   background-color: #f4f8fa; /* 柔和的背景色调 */
33. }
35. .success-icon {
36.   margin-bottom: 20px;
37. }
39. .success-icon svg {
40.   fill: #4CAF50; /* 柔和的绿色调 */
41. }
43. h1 {
44.   font-size: 2.5rem;
45.   color: #333; /* 深色调的文字 */
46.   margin: 0;
47.   font-weight: 500;
48. }
50. .success-message {
51.   font-size: 1.25rem;
52.   color: #666; /* 稍浅的文字颜色 */
53.   text-align: center;
54.   max-width: 300px;
55.   margin-top: 10px;
56. }
58. .btn {
59.   display: inline-block;
60.   padding: 14px 40px; /* 增加按钮的宽度和内边距 */
61.   margin-top: 20px;
62.   font-size: 1rem;
63.   font-weight: 500;
64.   color: #333; /* 深色调文字，确保在淡色背景下可见 */
65.   background-image: linear-gradient(to right, #639cbc, #1c67a8); /* 更淡的渐变色 */
66.   border: none;
67.   border-radius: 25px;
68.   box-shadow: 0 2px 4px rgba(50, 50, 93, 0.1), 0 1px 2px rgba(0, 0, 0, 0.08);
69.   cursor: pointer;
70.   transition: all 0.3s ease;
71. }
73. .btn:hover {
74.   transform: translateY(-2px);
75.   box-shadow: 0 4px 6px rgba(50, 50, 93, 0.1), 0 2px 4px rgba(0, 0, 0, 0.08);
76. }
78. .btn:focus {
79.   outline: none;
80.   box-shadow: 0 0 0 3px rgba(200, 200, 200, 0.5);
81. }
82. </style>

复制代码

6. 付出宝沙箱乐成付出的整个过程

   

• 可以使用账号暗码付款，也可以扫描付款
  
• 发起使用账号暗码付款，使用扫描付出有时候会出现乐成付出后页面没有发生跳转的情况
  

  以下是乐成付出的整个过程的截图

付出暗码默认是111111

付出乐成后付出宝会返回一个流水订单号（trade_no），退款时需要用到流水订单号，可以将流水订单号生存到数据库中
7. 付出宝沙箱的退款操作

   

• 退款可以使用商户订单号（out_trade_no），也可以使用付出宝返回的流水订单号（trade_no）
  
• 可以多次执行退款操作，但是账号余额不会发生变化如果是第一次退款，AlipayTradeRefundResponse 的 fundChange 属性取值为 “Y”，如果不是第一次退款，AlipayTradeRefundResponse 的 fundChange 字段的取值为 “N”，可以根据 fundChange 字段美满业务逻辑
  

  在实际开发中，与商品有关的信息是需要从后端查出来的，为了方便测试，由前端传给后端（退款的具体代码参考本文的编写controller（设置notify-url和return-url）部门）

8. 可能遇到的问题

8.1 504 Gateway Time-out

   出现这种情况大概率是由于付出宝沙箱处于维护状态（常出现于节假日），可以过一段时间再进行实验
  

The gateway did not receive a timely response from the upstream server or application. Sorry for the inconvenience.
Please report this message and include the following information to us.
Thank you very much!
URL:http://excashier-sandbox.dl.alipaydev.com/standard/auth.htm?payOrderId=451a320ca38641729ed983e9ace73143.00Server:excashier-36.gz00z.sandbox.alipay.netDate:2024/10/05 14:38:26 Powered by Tengine
8.2 系统有点儿忙，一会儿再试试

   出现这种情况大概率是由于付出宝沙箱处于维护状态（常出现于节假日），可以过一段时间再进行实验
  

8.3 退款服务不可用（Service Currently Unavailable）

   执行退款操作时，如果付出宝沙箱返回以下信息，分析退款服务不可用，大概率是由于付出宝沙箱处于维护状态（常出现于节假日），可以过一段时间再进行实验
  

---

{“alipay_trade_refund_response”:{“msg”:“Service Currently Unavailable”,“code”:“20000”,“sub_msg”:“系统非常”,“refund_fee”:“0.00”,“sub_code”:“aop.ACQ.SYSTEM_ERROR”,“send_back_fee”:“0.00”},“sign”:“c5Ct9FwyzUNhUPPYXjM6FdCtILlIzAWwx3dPSC+do0uL2aVp0QPVjnFlkN2MDApwbeuQCoRRuAnlZMocVyP0P84cUmLKrptj2p+wfkfuJXGor0KVUH7CtttIrdTLMbMHfKaPvfBqUKLy/NwKuCwAyQP2va/KwEfBna3xlIhgTobu2EN3C1s3LRFvEK+9x08XNjomG1t2ponftQLj6dag5M/UpTTDswrZY4GB74bH9YbwN7bS8NiD4gUDn+ncTZ6sjPfnJbUKOvOSmaFAaf9WmYjznj0tjcBFqMYLIezZ8NtniUktxJHOJC6GHj88Y9eLccF2fvwrq+Oj6iBR+9eXqA==”}

8.4 退款操作遇到Read timed out错误

   执行退款操作时，如果程序抛出以下错误，是由于在与付出宝API进行通信时，读取操作超时了（可能是由于客户端与付出宝服务器之间的网络毗连不稳定或速度过慢，导致数据传输超时），可以进行有限制次数的重试
  com.alipay.api.AlipayApiException: java.net.SocketTimeoutException: Read timed out
at com.alipay.api.AbstractAlipayClient.doPost(AbstractAlipayClient.java:1015)
at com.alipay.api.AbstractAlipayClient._execute(AbstractAlipayClient.java:921)
at com.alipay.api.AbstractAlipayClient.execute(AbstractAlipayClient.java:395)
at com.alipay.api.AbstractAlipayClient.execute(AbstractAlipayClient.java:377)
at com.alipay.api.AbstractAlipayClient.execute(AbstractAlipayClient.java:372)
at com.alipay.api.AbstractAlipayClient.execute(AbstractAlipayClient.java:366)
9. 付出宝沙箱社区

社区所在：付出宝开发者社区-学习提问互动交流开放社区 (alipay.com)
在使用付出宝沙箱时，如果遇到了无法解决的问题，可以在社区中看看有没有解决办法
10. 付出宝沙箱手机端

除了用账号暗码进行付出，也可以使用手机扫描付出，现在付出宝沙箱在手机端仅提供 Android 版本
下载所在：沙箱工具 - 开放平台 (alipay.com)

11. 温馨提示

• 如果不确定本身的 notify-url 是否能够生效，可以用 PostMan 进行测试；如果确定本身的 notify-url 能够生效，但 notify-url 对应的接口没有收到来自付出宝的异步通知，大概是是由于付出宝沙箱处于维护状态
  
• 发起使用账号暗码付款，使用扫描付出有时候会出现乐成付出后页面没有发生跳转的情况
  
• 在 return-url 对应的接口中，需要提前与前端沟通好付出乐成后要跳转的页面
  
• 发起付出乐成之后将付出宝返回的流水订单号（trade_no）生存到数据库中
  
• 构建与付出宝沙箱进行通信的 request 对象时，可以使用 setBizContent 方法，也可以使用 setBizModel 方法
  

12. 完备的示例代码

完备的示例代码已经放到了 Gitee 上

• 后端：alipay-sandbox-backend
  
• 前端：alipay-sandbox-frontend
  

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。