聚合支付
第一章 支付宝
文章目录
前言
公司这两天要对接PC端支付宝的支付接口，对于pc端网站应用来说支付宝支付接口有两种，一是：统一下单支付接口https://opendocs.alipay.com/apis/api_1/alipay.trade.page.pay；二是即时到账支付接口https://opendocs.alipay.com/open/62/104743，对接过程中踩到不少坑，谨以此文章作为过程记录，希望可以给遇到相同问题的朋友一些参考。
提示：以下是本篇文章正文内容，下面案例可供参考
一、开发前准备
1.1 获得沙箱账号
支付宝对接相对于其他支付平台来说是比较简单的，因为他提供了一个沙箱环境，我们可以使用沙箱环境来模拟具体的支付、回调业务。
注册地址：https://open.alipay.com，用你的支付宝账号扫码登录，完善个人信息，选择服务类型（我选的是自研）。
1.2 选择沙箱环境
进入沙箱环境配置商户参数（最重要的是公私钥需要保存下来，程序中会用到）
1.3 配置商户参数
在沙箱环境的控制台上配置商户参数：这里选择公钥模式，加解密方式有两种RSA和RSA2，可以选择系统默认密钥，也可以自定义密钥，自定义公私钥生成方法具体可参考https://opendocs.alipay.com/common/02kipl。
1.4 支付接入文档
下面以第一种支付方式——统一下单支付接口为例进行说明，接口文档可参考https://opendocs.alipay.com/apis/api_1/alipay.trade.page.pay。
二、java实现过程
1.pom中引入支付宝jar包
代码如下（示例）：
<dependency>
<groupId>com.alipay.sdk</groupId>
<artifactId>alipay-sdk-java</artifactId>
<version>3.1.0</version>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>1.2.41</version>
</dependency>
2.支付相关配置参数
代码如下（示例）：
public class AlipayConfig {
//这里用natapp内外网穿透，主要用于支付回调（用外网服务器更好）
public static final String natUrl = "http://xiaotiancai.natapp1.cc";
// 应用ID,您的APPID，收款账号既是您的APPID对应支付宝账号
public static String app_id = "201......";
// 商户私钥，您的PKCS8格式RSA2私钥，教程查看获取方式（必须配置）
public static String merchant_private_key = "MIIEvAIBADANBgkqhkiG9w0BAQEFAASCBKYwggSiAgEAA......";
// 支付宝公钥,查看地址：https://openhome.alipay.com/platform/keyManage.html 对应APPID下的支付宝公钥。
public static String alipay_public_key = "MIIBIjANBgkqhkiG9w0BAQEFAAO..........." ;
// 服务器异步通知页面路径 需http://格式的完整路径，不能加?id=123这类自定义参数，必须外网可以正常访问
public static String notify_url = natUrl + "/alipay/alipayNotifyNotice";
// 页面跳转同步通知页面路径 需http://格式的完整路径，不能加?id=123这类自定义参数，必须外网可以正常访问
public static String return_url = natUrl + "/alipay/alipayReturnNotice";
// 签名方式
public static String sign_type = "RSA2";
// 字符编码格式
public static String charset = "utf-8";
// 支付宝网关
//注意：沙箱测试环境，正式环境为：https://openapi.alipay.com/gateway.do
public static String gatewayUrl = "https://openapi.alipaydev.com/gateway.do";
}
3.支付实现
代码示例：
@PostMapping("goAlipay")
@ResponseBody
public String goAlipay(HttpServletRequest request, HttpServletRequest response) throws Exception {
//获得初始化的AlipayClient
AlipayClient alipayClient = new DefaultAlipayClient(AlipayConfig.gatewayUrl, AlipayConfig.app_id, AlipayConfig.merchant_private_key, "json", AlipayConfig.charset, AlipayConfig.alipay_public_key, AlipayConfig.sign_type);
//设置请求参数
AlipayTradePagePayRequest alipayRequest = new AlipayTradePagePayRequest();
alipayRequest.setReturnUrl(AlipayConfig.return_url);
alipayRequest.setNotifyUrl(AlipayConfig.notify_url);
SimpleDateFormat sdf = new SimpleDateFormat("yyMMddHHmmssSSS");
//商户订单号，商户网站订单系统中唯一订单号，必填（可以用一些重要的数加上时间戳组装，回调时可通过订单号截取使用）
String out_trade_no = sdf.format(new Date());
//付款金额，必填(单位为元，精确到小数点后两位)
String total_amount = "6999.0";
//订单名称，必填
String subject = "三星";
//商品描述，可空
String body = "用户订购商品个数：1" ;
String timeout_express = "10m";
//例子去官方api找
alipayRequest.setBizContent("{\"out_trade_no\":\"" + out_trade_no + "\","
+ "\"total_amount\":\"" + total_amount + "\","
+ "\"subject\":\"" + subject + "\","
+ "\"body\":\"" + body + "\","
+ "\"timeout_express\":\"" + timeout_express + "\","
+ "\"product_code\":\"FAST_INSTANT_TRADE_PAY\"}");
//请求
String result = alipayClient.pageExecute(alipayRequest).getBody();
System.out.println(result);
return result;
}
返回的result内容（form表单格式）如下：
<form name="punchout_form" method="post" action="https://openapi.alipaydev.com/gateway.do?charset=utf-8&method=alipay.trade.page.pay&sign=pKd9AsZltXXcsj0AENmGi0CnlCdclQlt%2BXEhFDo5zFGa64%2FE0D70hFdVgb9Ud%2FMQpdhnY6uAk0jeCXUk%2BbwsRhRLyuxilRINa07nU3U1QnS1t0lchnlHpyWtoAmtrQsahrfd0XRG7cB%2BiXfHDH462yH1jTyNK4tUb0dgaq9R1AVEwWlEnqn7cMaetiYLpQV09%2BrwiAqACYOorD0imu1ADBFyBqRea%2BG4hVO0ucGKfSeffwzi3XQIyX%2BStwQNBDiAfGL2069%2BTDCqWtcTlSr2GYHBKlDRvnhoHNyHijAOs%2FOVqEFR5ge1kfIfCSEnl0OhCeq5BylP8PN1SHShjpmeSA%3D%3D&return_url=http%3A%2F%2Fxiaotiancai.natapp1.cc%2Falipay%2FalipayReturnNotice¬ify_url=http%3A%2F%2Fxiaotiancai.natapp1.cc%2Falipay%2FalipayNotifyNotice&version=1.0&app_id=2016092700605500&sign_type=RSA2×tamp=2022-04-20+10%3A22%3A09&alipay_sdk=alipay-sdk-java-3.1.0&format=json">
<input type="hidden" name="biz_content" value="{"out_trade_no":"220420102209609","total_amount":"6999.0","subject":"三星","body":"用户订购商品个数：1","timeout_express":"10m","product_code":"FAST_INSTANT_TRADE_PAY"}">
<input type="submit" value="立即支付" style="display:none" >
</form>
<script>document.forms[0].submit();</script>
支付页面：
4支付结果查询
代码示例：
@PostMapping("queryAlipay")
@ResponseBody
public String queryAlipay(String orderNo) throws Exception{
AlipayClient alipayClient = new DefaultAlipayClient(AlipayConfig.gatewayUrl,
AlipayConfig.app_id,
AlipayConfig.merchant_private_key,
"json",
"utf-8",
AlipayConfig.alipay_public_key,
"RSA2"
);
AlipayTradeQueryRequest tradeQueryRequest = new AlipayTradeQueryRequest();
tradeQueryRequest.setBizContent("{" +
"\"out_trade_no\":\"" + orderNo + "\"" +
" }");
//记录订单跳转时间
AlipayTradeQueryResponse tradeQueryResponse = alipayClient.execute(tradeQueryRequest);
if ("10000".equals(tradeQueryResponse.getCode())) {
if ("TRADE_SUCCESS".equals(tradeQueryResponse.getTradeStatus()) || "TRADE_FINISHED".equals(tradeQueryResponse.getTradeStatus())) {
/*
* 支付成功
* 业务规则实现
*/
} else if ("TRADE_CLOSED".equals(tradeQueryResponse.getTradeStatus())) {
/*
* 支付失败
* 订单关闭需要重新生成订单并进行支付
*/
}else {
/*
* 支付失败
*/
}
}
return "alipayQuery";
}
5支付结果同步通知
代码示例：
@RequestMapping("alipayReturnNotice")
public String alipayReturnNotice(HttpServletRequest request, HttpServletResponse response, Map map) throws Exception {
//获取支付宝GET过来反馈信息
Map<String, String> params = new HashMap<String, String>();
Map<String, String[]> requestParams = request.getParameterMap();
for (Iterator<String> iter = requestParams.keySet().iterator(); iter.hasNext(); ) {
String name = (String) iter.next();
String[] values = (String[]) requestParams.get(name);
String valueStr = "";
for (int i = 0; i < values.length; i++) {
valueStr = (i == values.length - 1) ? valueStr + values[i]
: valueStr + values[i] + ",";
}
//乱码解决，这段代码在出现乱码时使用
//valueStr = new String(valueStr.getBytes("ISO-8859-1"), "utf-8");
params.put(name, valueStr);
}
//调用SDK验证签名
boolean signVerified = AlipaySignature.rsaCheckV1(params, AlipayConfig.alipay_public_key, AlipayConfig.charset, AlipayConfig.sign_type);
if (signVerified) {
//商户订单号
String out_trade_no = params.get("out_trade_no");
//支付宝交易号
String trade_no = params.get("trade_no");
//付款金额
String total_amount = params.get("total_amount");
//交易状态
String trade_status = params.get("trade_status");
if (trade_status.equals("TRADE_FINISHED") || trade_status.equals("TRADE_SUCCESS")){
/*
* 支付成功
* 业务规则实现
*/
//直接返回支付成功页面
return "paySuccess";
}else {
/*
* 支付失败
*/
}
} else {
/*
* 支付失败
*/
}
//直接返回支付失败页面
return "payFail";
}
6支付结果异步通知
代码示例：
@RequestMapping(value = "/alipayNotifyNotice")
public void alipayNotifyNotice(HttpServletRequest request, HttpServletResponse response) throws Exception {
//获取支付宝POST过来反馈信息
Map<String, String> params = new HashMap<String, String>();
Map<String, String[]> requestParams = request.getParameterMap();
for (Iterator<String> iter = requestParams.keySet().iterator(); iter.hasNext(); ) {
String name = (String) iter.next();
String[] values = (String[]) requestParams.get(name);
String valueStr = "";
for (int i = 0; i < values.length; i++) {
valueStr = (i == values.length - 1) ? valueStr + values[i]
: valueStr + values[i] + ",";
}
//乱码解决，这段代码在出现乱码时使用
//valueStr = new String(valueStr.getBytes("ISO-8859-1"), "utf-8");
params.put(name, valueStr);
}
//调用SDK验证签名
boolean signVerified = AlipaySignature.rsaCheckV1(params, AlipayConfig.alipay_public_key, AlipayConfig.charset, AlipayConfig.sign_type);
if (signVerified) {//验证成功
//商户订单号
String out_trade_no = params.get("out_trade_no");
//支付宝交易号
String trade_no = params.get("trade_no");
//付款金额
String total_amount = params.get("total_amount");
//交易状态
String total_amount = params.get("trade_status");
if (trade_status.equals("TRADE_FINISHED") || trade_status.equals("TRADE_SUCCESS")) {
/*
* 支付成功
* 业务规则实现
*/
//回复支付公司
try {
response.getWriter().print("SUCCESS");
} catch (IOException e) {
e.printStackTrace();
}
}
} else {//验证失败
/*
* 支付失败
*/
}
}
总结
总体来说支付宝支付接口还是比较容易实现的，只要引入相关jar包，支付接口相关方法都已被封装，只需调用SDK方法就比较容易对接支付宝接口。与其他支付平台不同的是，发起支付请求后，返回的是form表单数据，对于vue页面来说需要使用
document.querySelector('body').innerHTML = "form表单数据";
const div = document.createElement('div') // 创建div
div.innerHTML = this.data // 将返回的form 放入div
document.body.appendChild(div)
document.forms[0].submit()
进行组装提交。
扫一扫
2703
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
