目录
1.开发准备
2.配置环境
3.支付接口
4.初步验证
5.接口回调
6.内网穿透
首先用支付宝扫码登录支付宝开发平台
登录 - 支付宝
选择开发工具沙箱
启用公钥模式,设置网关地址,地址复制粘贴上面的支付宝网关地址。
支付宝 - 网上支付 安全快速!
在pom.xml进行依赖配置。
com.alipay.sdk
alipay-easysdk
2.2.0
在application.yml中进行配置,注:配置时冒号后面空一格。
alipay:
appId:
appPrivateKey:
alipayPublicKey:
notifyUrl:
配置参数前三个在控制台沙箱应用,notifyUrl后面配置。
然后点击文档>网页&移动应用>开发工具>开发工具>开发工具包(SDK)下载>服务端SDK> Java> Easy版
进行初始化参数配置,代码在示例代码中能找到。
import com.alipay.easysdk.factory.Factory;
import com.alipay.easysdk.factory.Factory.Payment;
import com.alipay.easysdk.kernel.Config;
import com.alipay.easysdk.kernel.util.ResponseChecker;
import com.alipay.easysdk.payment.facetoface.models.AlipayTradePrecreateResponse;
public class Main {
public static void main(String[] args) throws Exception {
// 1. 设置参数(全局只需设置一次)
Factory.setOptions(getOptions());
try {
// 2. 发起API调用(以创建当面付收款二维码为例)
AlipayTradePrecreateResponse response = Payment.FaceToFace()
.preCreate("Apple iPhone11 128G", "2234567890", "5799.00");
// 3. 处理响应或异常
if (ResponseChecker.success(response)) {
System.out.println("调用成功");
} else {
System.err.println("调用失败,原因:" + response.msg + "," + response.subMsg);
}
} catch (Exception e) {
System.err.println("调用遭遇异常,原因:" + e.getMessage());
throw new RuntimeException(e.getMessage(), e);
}
}
private static Config getOptions() {
Config config = new Config();
config.protocol = "https";
config.gatewayHost = "openapi.alipay.com";
config.signType = "RSA2";
config.appId = "<-- 请填写您的AppId,例如:2019091767145019 -->";
// 为避免私钥随源码泄露,推荐从文件中读取私钥字符串而不是写入源码中
config.merchantPrivateKey = "<-- 请填写您的应用私钥,例如:MIIEvQIBADANB ... ... -->";
//注:证书文件路径支持设置为文件系统中的路径或CLASS_PATH中的路径,优先从文件系统中加载,加载失败后会继续尝试从CLASS_PATH中加载
config.merchantCertPath = "<-- 请填写您的应用公钥证书文件路径,例如:/foo/appCertPublicKey_2019051064521003.crt -->";
config.alipayCertPath = "<-- 请填写您的支付宝公钥证书文件路径,例如:/foo/alipayCertPublicKey_RSA2.crt -->";
config.alipayRootCertPath = "<-- 请填写您的支付宝根证书文件路径,例如:/foo/alipayRootCert.crt -->";
//注:如果采用非证书模式,则无需赋值上面的三个证书路径,改为赋值如下的支付宝公钥字符串即可
// config.alipayPublicKey = "<-- 请填写您的支付宝公钥,例如:MIIBIjANBg... -->";
//可设置异步通知接收服务地址(可选)
config.notifyUrl = "<-- 请填写您的支付类接口异步通知接收服务地址,例如:https://www.test.com/callback -->";
//可设置AES密钥,调用AES加解密相关接口时需要(可选)
config.encryptKey = "<-- 请填写您的AES密钥,例如:aa4BtZ4tspm2wnXLb1ThQA== -->";
return config;
}
}
官方示例代码
Factory.Payment.FaceToFace()
// 调用agent扩展方法,设置app_auth_token,完成第三方代调用
.agent("ca34ea491e7146cc87d25fca24c4cD11")
.preCreate("Apple iPhone11 128G", "2234567890", "5799.00");
如上所示,第三方调用需要三个数据,依次为,交易名称、支付宝交易凭证号、交易金额。
每次交易凭证号不能相同。
由以上信息,创建支付接口。
新建一个 AliPayController.java
import com.alipay.easysdk.factory.Factory;
import com.alipay.easysdk.payment.page.models.AlipayTradePagePayResponse;
import com.example.springboot.controller.dto.AliPay;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import java.net.URLEncoder;
@RestController
@RequestMapping("/alipay")
public class AliPayController {
@GetMapping("/pay") // &subject=xxx&traceNo=xxx&totalAmount=xxx
public String pay(AliPay aliPay) {
AlipayTradePagePayResponse response;
try {
// 发起API调用(以创建当面付收款二维码为例)
response = Factory.Payment.Page()
.pay(URLEncoder.encode(aliPay.getSubject(), "UTF-8"), aliPay.getTraceNo(), aliPay.getTotalAmount(), "");
} catch (Exception e) {
System.err.println("调用遭遇异常,原因:" + e.getMessage());
throw new RuntimeException(e.getMessage(), e);
}
return response.getBody();
}
}
创建实体类 Alipay.java
import lombok.Data;
@Data
public class AliPay {
//交易名称
private String subject;
//支付宝交易凭证号
private String traceNo;
//交易金额
private String totalAmount;
}
然后在拦截器加上忽略接口alipay的配置。
URL:http://localhost:8080/alipay/pay?subject=xxx&traceNo=xxx&totalAmount=100
然后可以选择买家沙箱账号密码登录支付,或者下载沙箱版支付宝APP账号密码登录扫码支付。
想要接收支付宝开发平台传回来的反馈,需要接口回调。
//判断支付宝付款交易是否成功。true,false.
request.getParameter("trade_status").equals("TRADE_SUCCESS")
Map parameters = new HashMap<>();
parameters.put("charset", "UTF-8");
parameters.put("sign", "GM0CbuqaEivqgb......");
parameters.put("app_id", "2018091261392200");
parameters.put("sign_type", "RSA2");
parameters.put("isv_ticket", "");
parameters.put("timestamp", "2020-03-25 16:27:08");
//... ... 接收到的所有参数放入一个Map中
Factory.Payment.Common().verifyNotify(parameters);
在 AliPayController.java加如下代码。在其中可对反馈数据进行处理。对前台进行反馈。
@PostMapping("/notify") // 注意这里必须是POST接口
public String payNotify(HttpServletRequest request) throws Exception {
if (request.getParameter("trade_status").equals("TRADE_SUCCESS")) {
Map params = new HashMap<>();
Map requestParams = request.getParameterMap();
for (String name : requestParams.keySet()) {
params.put(name, request.getParameter(name));
}
String tradeNo = params.get("out_trade_no");
String gmtPayment = params.get("gmt_payment");
String alipayTradeNo = params.get("trade_no");
// 支付宝验签
if (Factory.Payment.Common().verifyNotify(params)) {
// 验签通过
System.out.println("交易名称: " + params.get("subject"));
System.out.println("交易状态: " + params.get("trade_status"));
System.out.println("支付宝交易凭证号: " + params.get("trade_no"));
System.out.println("商户订单号: " + params.get("out_trade_no"));
System.out.println("交易金额: " + params.get("total_amount"));
System.out.println("买家在支付宝唯一id: " + params.get("buyer_id"));
System.out.println("买家付款时间: " + params.get("gmt_payment"));
System.out.println("买家付款金额: " + params.get("buyer_pay_amount"));
}
}
return "******";
}
然后因为本地localhost,支付宝开发平台没法传输反馈数据过来。
需要进行内网穿透。
选择需要版本自行下载。
登录注册过后,购买免费隧道,配置自己端口号,免费购买。
点击复制authtoken号。
创建authtoken启动项。
然后打开下载的Natapp软件文件夹,创建文本把下面代码加上先前复制的authtoken号,然后把文件后缀改成bat。
natapp.exe -authtoken=
点击start.bat文件启动。有如下显示证明启动成功。
更改 application.yml 里的配置:
然后就可以进行功能测试了。