沙箱环境是支付宝开放平台为开发者提供的安全低门槛的测试环境,开发者在沙箱环境中调用接口无需具备所需的商业资质,无需绑定和开通产品,同时不会对生产环境中的数据造成任何影响。合理使用沙箱环境,可以让研发流程与商业流程并行,降低联调资损风险,加速项目的交付。更为详细的说明可以看官方文档:小程序文档 - 支付宝文档中心
登录支付宝开放平台,支付宝开放平台,找到开发接入入驻为开发者。
进入到开发者的控制台,找到最下方的开发者工具推荐 ,点击沙箱。
创建沙箱应用后,需要拿到3个参数,appId,应用私钥,支付宝公钥,用于对接支付接口使用。
在沙箱账号中,可以看到买家和商家的账号信息以及账号余额。当支付时填写买家对应信息,支付成功会看到买家余额减少,卖余额增加。
支付的整体逻辑是,引入sdk依赖,配置对应的支付参数,调用支付接口支付,等待支付成功后执行回调接口逻辑。 如果希望看到详细说明,也可参看官方文档:小程序文档 - 支付宝文档中心,下面主要是简化业务步骤,记录核心关键步骤。
<!-- 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>
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 {
// 应用Id
private String appId;
// 应用私有
private String appPrivateKey;
// 支付宝公钥
private String publiceKey;
// 回调接口路径
private String notifyUrl;
@PostConstruct
public 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";
}
}
支付完成后,支付宝需要回调我们的接口,将支付成功的信息给我们。因此,需要将回调接口配置到外网环境,这里使用花生壳内网工具实现。
下载地址:花生壳客户端官方下载 - 贝锐花生壳官网
双击exe安装包,一直下一步即可安装完成。 安装成功后新增映射,配置对应ip和端口号
传入对应参数,访问pay接口即跳转到支付界面
输入沙箱环境的买家账号和密码支付
支付成功后,支付宝会回调我们提供好的接口路径
查看买家和商家余额