前言
在电商项目中几乎是绕不开实现支付业务的,那么本文就以项目中接入支付宝作为第三方支付来讲一讲如何实现luban-mall电商项目中的支付流程。希望看完本文后,能给正在学习电商项目的读者带来一些的帮助!
1 阿里扫描支付演示全过程
1.1 当面支付介绍
当面付帮助商家在线下消费场景下实现快速收款,支持 条码支付 和 扫码支付 两种付款方式。商家可通过以下任一方式进行收款,提升商家收银效率,资金实时到账。
扫码支付的应用场景
用户打开支付宝中的 扫一扫 功能,扫描商家展示的二维码进行支付。该模式适用于线下实体店支付、面对面支付、自助售货机等场景。流程如下图所示:
使用说明
1.2 扫码支付demo使用
下载Demo https://opendocs.alipay.com/open/54/104506
扫码支付依赖包 https://mvnrepository.com/artifact/com.alipay.sdk/alipay-sdk-java
沙箱环境 https://opendocs.alipay.com/open/200/105311
生成公私钥工具 https://opendocs.alipay.com/open/291/introduce
公私钥设置 说明 https://opendocs.alipay.com/open/291/105971#LDsXr
沙箱app
下载地址 https://openhome.alipay.com/platform/appDaily.htm
注意:沙箱环境是一个虚拟环境,主要为了方便开发和测试人员实现接入阿里支付功能的联调,沙箱环境阿里支付宝钱包可以任意转入转出金额。只是沙箱环境App
目前只有安卓版,没有IOS
版本,这对于经常使用苹果手机的开发者有点不太方便自己测试效果。
1.2.1 下载支付演示代码包
1.2.2 引入扫码支付依赖包
<dependency>
<groupId>com.alipay.sdk</groupId>
<artifactId>alipay-sdk-java</artifactId>
<version>4.10.0.ALL</version>
</dependency>
1.2.3 导入demo的代码文件
即将下载的demo包解压后拷贝到电商项目中
1.2.4 修改支付宝配置文件
文件名 : zfbinfo.properties
#此处请填写你的PID
pid = 2088702364893848
# 此处请填写你当面付的APPID
appid = 2021000116675801
#此处请填写你的商户私钥且转PKCS8格式
private_key = xxx
#此处请填写你的商户公钥
public_key = xxx
#SHA256withRsa对应支付宝公钥
alipay_public_key = xxx
注:以上private_key
、public_key
和alipay_public_key
都是通过阿里生成公私钥工具获得,具体可查看蚂蚁技术支持 官方文档链接:如何生成及配置RSA2密钥(https://opensupport.alipay.com/support/helpcenter/207/201602469554?ant_source=antsupport)
1.2.5
appid
设置
需要前往支付宝开放平台查看,查看链接如下:
https://openhome.alipay.com/platform/appDaily.html
1.2.6
pid
设置
来源:登入支付宝开发者中心 查看账户信息
https://openhome.alipay.com/dev/workspace/account-center/main-account-manage
1.2.7 公私钥生成
利用下载的支付宝开放平台开发助手软件生成密钥即可
1.2.8 阿里支付公钥生成
alipay_public_key
来源:
1) 查看密钥
2) 生成支付宝公钥
3) 加签和验签流程
1.5 下载沙箱支付宝APP
点击沙箱应用,使用手机支付宝 App扫描二维码即可下载安装包,安装完成后使用沙箱账号登录
2 整合电商下单
2.1 新建Module
IDEA打开luban-mall
项目后选中项目,然后右键->New->Module 选择Maven,点击Next,然后在弹出的对话框中输入模块名mall-order后点击确定即可
2.2 引入Maven依赖
order-pay模块项目pom.xml文件中引入相关maven依赖
<dependencies>
<!--spring mvc-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!--mysql连接驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
</dependency>
<!-- 支付宝支付SDK -->
<dependency>
<groupId>com.alipay.sdk</groupId>
<artifactId>alipay-sdk-java</artifactId>
<version>3.3.87.ALL</version>
<exclusions>
<exclusion>
<artifactId>commons-logging</artifactId>
<groupId>commons-logging</groupId>
</exclusion>
</exclusions>
</dependency>
<!--常用工具类-->
<dependency>
<groupId>commons-lang</groupId>
<artifactId>commons-lang</artifactId>
<version>2.6</version>
</dependency>
<!--常用配置-->
<dependency>
<groupId>commons-configuration</groupId>
<artifactId>commons-configuration</artifactId>
<version>1.10</version>
<exclusions>
<exclusion>
<artifactId>commons-logging</artifactId>
<groupId>commons-logging</groupId>
</exclusion>
</exclusions>
</dependency>
<!--加密、解密工具-->
<dependency>
<groupId>commons-codec</groupId>
<artifactId>commons-codec</artifactId>
<version>1.11</version>
</dependency>
<!--谷歌二维码-->
<dependency>
<groupId>com.google.zxing</groupId>
<artifactId>core</artifactId>
<version>3.2.1</version>
</dependency>
<!--测试工具类-->
<dependency>
<groupId>org.hamcrest</groupId>
<artifactId>hamcrest-core</artifactId>
<version>1.3</version>
<scope>test</scope>
</dependency>
<!--使用google gson作为json序列化反序列化工具-->
<dependency>
<groupId>com.google.code.gson</groupId>
<artifactId>gson</artifactId>
<version>2.8.5</version>
</dependency>
<!-- luban-mall公共依赖 -->
<dependency>
<groupId>com.luban.mall</groupId>
<artifactId>mall-common</artifactId>
</dependency>
</dependencies>
2.3 导入demo包java文件
(1)将TradePaySDK
包下文件拷贝到工程下
F2FPay_Demo_Java
工程两个Java文件和配置文件拷贝到工程下Main.java
zfbinfo.properties
open_api_domain = https://openapi.alipay.com/gateway.do
mcloud_api_domain = http://mcloudmonitor.com/gateway.do
pid = 此处请填写你的PID
appid = 此处请填写你当面付的APPID
# RSA私钥、公钥和支付宝公钥
private_key = 此处请填写你的商户私钥且转PKCS8格式
public_key = 此处请填写你的商户公钥
#SHA1withRsa对应支付宝公钥
#alipay_public_key = MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDDI6d306Q8fIfCOaTXyiUeJHkrIvYISRcc73s3vF1ZT7XN8RNPwJxo8pWaJMmvyTn9N4HQ632rwCtzvzQETrNRwVxLO5jVmRGi60j8Ue1efIlzPXV9je9mkjzOmdssymZkh2QhUrCmZYI/FCEa3/cNMW0QIDAQAB
#SHA256withRsa对应支付宝公钥
alipay_public_key = MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAjrEVFMOSiNJXaRNKicQuQdsREraftDA9Tua3WNZwcpeXeh8Wrt+V9JilLqSa7N7sVqwp6hEg97Oxe6GKUmzaZRNh0cZZ88vpkn5tlgL4mH/dhSr3Ip00kvM4rHq9PwuT4k7z1DpZAf1eghK8Q5BgxL88d0X07m9X96Ijd0yMkXArzD7jg+noqfbztEKoH3kPMRJC2w4ByVdweWUT2PwrlATpZZtYLmtDvUKG/sOkNAIKEMg3Rut1oKWpjyYanzDgS7Cg3awr1KPTl9rHCazk15aNYowmYtVabKwbGVToCAGK+qQ1gT3ELhkGnf3+h53fukNqRH+wIDAQ
2.4 创建支付下单服务
2.4.1 新建下订单和查询订单状态接口
在mall-order模块项目下的com.luban.mall.service
包下新建接口TradeService
类名:com.order.service.impl.PayServiceImpl
public String genQrCode(OrderDetail orderDetail) {
//支付二维码的访问路径
String qrCodePath = null;
// (必填) 商户网站订单系统中唯一订单号,64个字符以内,只能包含字母、数字、下划线,
// 需保证商户系统端不能重复,建议通过数据库sequence生成,
String outTradeNo = "tradepay" + System.currentTimeMillis()
+ (long) (Math.random() * 10000000L);
// (必填) 订单标题,粗略描述用户的支付目的。如“xxx品牌xxx门店消费”
String subject = "xxx品牌xxx门店当面付消费";
// (必填) 订单总金额,单位为元,不能超过1亿元
// 如果同时传入了【打折金额】,【不可打折金额】,【订单总金额】三者,则必须满足如下条件:【订单总金额】=【打折金额】+【不可打折金额】
String totalAmount = orderDetail.getPayAmount().toString();
// (必填) 付款条码,用户支付宝钱包手机app点击“付款”产生的付款条码
String authCode = "用户自己的支付宝付款码"; // 条码示例,286648048691290423
// (可选,根据需要决定是否使用) 订单可打折金额,可以配合商家平台配置折扣活动,如果订单部分商品参与打折,可以将部分商品总价填写至此字段,默认全部商品可打折
// 如果该值未传入,但传入了【订单总金额】,【不可打折金额】 则该值默认为【订单总金额】- 【不可打折金额】
// String discountableAmount = "1.00"; //
// (可选) 订单不可打折金额,可以配合商家平台配置折扣活动,如果酒水不参与打折,则将对应金额填写至此字段
// 如果该值未传入,但传入了【订单总金额】,【打折金额】,则该值默认为【订单总金额】-【打折金额】
String undiscountableAmount = "0.0";
// 卖家支付宝账号ID,用于支持一个签约账号下支持打款到不同的收款账号,(打款到sellerId对应的支付宝账号)
// 如果该字段为空,则默认为与支付宝签约的商户的PID,也就是appid对应的PID
String sellerId = "";
// 订单描述,可以对交易或商品进行一个详细地描述,比如填写"购买商品3件共20.00元"
String body = String.format("购买商品%s件共%s元",orderDetail.getItemList().size(),orderDetail.getPayAmount());
// 商户操作员编号,添加此参数可以为商户操作员做销售统计
String operatorId = "bole";
// (必填) 商户门店编号,通过门店号和商家后台可以配置精准到门店的折扣信息,详询支付宝技术支持
String storeId = "bole_store_id";
// 业务扩展参数,目前可添加由支付宝分配的系统商编号(通过setSysServiceProviderId方法),详情请咨询支付宝技术支持
String providerId = "2088100200300400500";
ExtendParams extendParams = new ExtendParams();
extendParams.setSysServiceProviderId(providerId);
// 支付超时,线下扫码交易定义为5分钟
String timeoutExpress = "5m";
// 商品明细列表,需填写购买商品详细信息,
List<GoodsDetail> goodsDetailList = new ArrayList<GoodsDetail>();
// 创建一个商品信息,参数含义分别为商品id(使用国标)、名称、单价(单位为分)、数量,如果需要添加商品类别,详见GoodsDetail
//GoodsDetail goods1 = GoodsDetail.newInstance("goods_id001", "xxx面包", 1000, 1);
// 创建好一个商品后添加至商品明细列表
//goodsDetailList.add(goods1);
// 继续创建并添加第一条商品信息,用户购买的产品为“黑人牙刷”,单价为5.00元,购买了两件
// GoodsDetail goods2 = GoodsDetail.newInstance("goods_id002", "xxx牙刷", 500, 2);
// goodsDetailList.add(goods2);
if(orderDetail!=null){
orderDetail.getItemList().forEach(o->{
GoodsDetail good = GoodsDetail.newInstance(o.getOrderSn(),o.getProductName(),o.getProductPrice().multiply(new BigDecimal(100)).longValue(),o.getProductQuantity());
goodsDetailList.add(good);
});
}
String appAuthToken = "应用授权令牌";//根据真实值填写
// 创建条码支付请求builder,设置请求参数
AlipayTradePrecreateRequestBuilder builder = new AlipayTradePrecreateRequestBuilder()
.setSubject(subject).setTotalAmount(totalAmount).setOutTradeNo(outTradeNo)
.setUndiscountableAmount(undiscountableAmount).setSellerId(sellerId).setBody(body)
.setOperatorId(operatorId).setStoreId(storeId).setExtendParams(extendParams)
.setTimeoutExpress(timeoutExpress)
// .setNotifyUrl("http://www.test-notify-url.com")//支付宝服务器主动通知商户服务器里指定的页面http路径,根据需要设置
.setGoodsDetailList(goodsDetailList);
// 调用tradePay方法获取当面付应答
AlipayF2FPrecreateResult result = tradeService.tradePrecreate(builder);
switch (result.getTradeStatus()) {
case SUCCESS:
log.info("支付宝支付成功!");
AlipayTradePrecreateResponse response= result.getResponse();
print(response);
String qrPath=String.format(payConfig.getAlipayPath()+"/qr-%s.png",response.getOutTradeNo());
String fullQrPath=payConfig.getQrBasePath()+qrPath;
log.info("本地二维码生成:"+fullQrPath);
ZxingUtils.getQRCodeImge(response.getQrCode(), 256, fullQrPath);
qrCodePath=payConfig.getHttpResourcePath()+qrPath;
break;
case FAILED:
log.error("支付宝支付失败!!!");
break;
case UNKNOWN:
log.error("系统异常,订单状态未知!!!");
break;
default:
log.error("不支持的交易状态,交易返回异常!!!");
break;
}
2.5 映射二维码本地路径到网络
这一功能需要在实现WebMvcConfigurer
类的配置类中实现
新建配置类ResourceConfig
@Configuration
publicclass ResourceConfig implements WebMvcConfigurer {
@Autowired
private TradePayProp tradePayProp;
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
String os = System.getProperty("os.name");
if(os.toLowerCase().startsWith("win")){ //windows系统
/** 支付码图片QrCode图片存储路径 */
registry.addResourceHandler(tradePayProp.getHttpBasePath()
+"/**")
.addResourceLocations("file:" + tradePayProp.getStorePath() + "/");
}else{ //linux或者mac
registry.addResourceHandler("/static/resources/**")
.addResourceLocations("file:/usr/local/resources/"); //静态资源
//.addResourceLocations("classpath:/META-INF/resources/"); //swagger2页面
}
}
}
2.6 创建下单Controller
@PostMapping("/genQrCode")
public CommonResult genQrCode(@RequestBody OrderDetail orderDetail) throws BusinessException {
String path = payService.genQrCode(orderDetail);
if(StringUtils.isNotEmpty(path)){
return CommonResult.success(path);
}
return CommonResult.failed();
}
3 测试下单生成二维码
3.1 发起下单支付请求
启动order-pay模块项目服务后,在postman中发起下单支付请求
3.2 返回支付二维码
读者如对本位有疑问,可在下方留言区留言,作者看到后会及时回复答疑
4 参考链接
https://www.yuque.com/books/share/9f4576fb-9aa9-4965-abf3-b3a36433faa6/gs5tft
本文gitee地址: https://gitee.com/heshengfu1211/luban-mall/tree/master/order-pay
5 推荐阅读
[1] 强烈推荐一个技术栈丰富的微电商项目luban-mall
[2] 捋一捋luban-mall电商项目商品中心与订单中心业务功能
---END---