一、支付宝沙箱环境介绍
沙箱环境是支付宝开放平台为开发者提供的安全低门槛的测试环境,开发者在沙箱环境中调用接口无需具备所需的商业资质,无需绑定和开通产品,同时不会对生产环境中的数据造成任何影响。合理使用沙箱环境,可以让研发流程与商业流程并行,降低联调资损风险,加速项目的交付。更为详细的说明可以看官方文档:小程序文档 - 支付宝文档中心
二、沙箱环境准备
2.1 注册入驻支付宝开放平台
登录支付宝开放平台,支付宝开放平台,找到开发接入入驻为开发者。
2.2 配置沙箱环境
进入到开发者的控制台,找到最下方的开发者工具推荐 ,点击沙箱。
2.3 创建沙箱应用
- 获取支付参数信息
创建沙箱应用后,需要拿到3个参数,appId,应用私钥,支付宝公钥,用于对接支付接口使用。
- 买家和商家账户信息
在沙箱账号中,可以看到买家和商家的账号信息以及账号余额。当支付时填写买家对应信息,支付成功会看到买家余额减少,卖余额增加。
三、Java实现支付宝支付
支付的整体逻辑是,引入sdk依赖,配置对应的支付参数,调用支付接口支付,等待支付成功后执行回调接口逻辑。 如果希望看到详细说明,也可参看官方文档:小程序文档 - 支付宝文档中心,下面主要是简化业务步骤,记录核心关键步骤。
3.1 引入SDK的Maven依赖
<!-- https://mvnrepository.com/artifact/com.alipay.sdk/alipay-easysdk -->
<dependency><groupId>com.alipay.sdk</groupId><artifactId>alipay-easysdk</artifactId><version>2.2.2</version>
</dependency>
3.2 配置支付参数
3.3 编写支付属性配置类
import com.alipay.easysdk.factory.Factory;
import com.alipay.easysdk.kernel.Config;
import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;import javax.annotation.PostConstruct;@Component
@ConfigurationProperties(prefix = "alipay")
@Data
public class AlipayConfig {// 应用Idprivate String appId;// 应用私有 private String appPrivateKey;// 支付宝公钥 private String publiceKey;// 回调接口路径 private String notifyUrl;@PostConstructpublic void init(){Config config = new Config();// 基础配置config.protocol = "https";config.gatewayHost = "openapi-sandbox.dl.alipaydev.com";// 新版沙箱网关地址config.signType = "RSA2";// 业务配置config.appId = this.appId;config.merchantPrivateKey = this.appPrivateKey;config.alipayPublicKey = this.publiceKey;config.notifyUrl = this.notifyUrl;// 将配置信息, 添加到相应的工厂类Factory.setOptions(config);System.out.println("支付宝初始化配置完成");}
}
3.4 编写支付接口和支付回调接口
import com.alipay.easysdk.factory.Factory;
import com.alipay.easysdk.payment.page.models.AlipayTradePagePayResponse;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;import javax.servlet.http.HttpServletRequest;
import java.util.HashMap;
import java.util.Map;@RestController
public class TestController {/*** 订单支付接口, 核心是调用支付宝的 Factory.Payment.Page().pay() 方法* @param subject 支付对象信息* @param outTradeNo 订单号* @param totalAmount 订单金额* @return*/@GetMapping("/pay")public String pay(String subject, String outTradeNo, String totalAmount) {AlipayTradePagePayResponse response;try {response = Factory.Payment.Page().pay(subject, outTradeNo, totalAmount, "");} catch (Exception e) {throw new RuntimeException(e);}return response.getBody();}/*** 支付回调接口,如果支付成功,支付宝将会请求此接口,将成功信息返回* @param request* @return* @throws Exception*/@PostMapping("/notify")public String notify(HttpServletRequest request) throws Exception {String tradeStatus = request.getParameter("trade_status");if (tradeStatus.trim().equals("TRADE_SUCCESS")) {Map<String, String> param = new HashMap<>();Map<String, String[]> parameterMap = request.getParameterMap();for (String name : parameterMap.keySet()) {param.put(name, request.getParameter(name));}// 验证请求的有效性if (Factory.Payment.Common().verifyNotify(param)) {System.out.println("通过支付宝的验证");String orderIdStr = param.get("out_trade_no");System.out.println("orderIdStr = " + orderIdStr);}else {System.out.println("支付验证不通过");}}return "success";}
}
四、测试
4.1 下载内网穿透工具
支付完成后,支付宝需要回调我们的接口,将支付成功的信息给我们。因此,需要将回调接口配置到外网环境,这里使用花生壳内网工具实现。
下载地址:花生壳客户端官方下载 - 贝锐花生壳官网
双击exe安装包,一直下一步即可安装完成。 安装成功后新增映射,配置对应ip和端口号
4.2 访问测试
传入对应参数,访问pay接口即跳转到支付界面
输入沙箱环境的买家账号和密码支付
支付成功后,支付宝会回调我们提供好的接口路径
查看买家和商家余额