SpringBoot整合银联支付
SpringBoot整合银联支付
1.首先在银联开发者平台注册银联账号:https://open.unionpay.com/tjweb/index
2.在业务合作点击在线网关支付
3.下载官方SDK&Demo
4.解压开发包(密码:我已阅读上述声明,充分知晓风险)打开Java Version SDK (通用版)
5.在src文件中找到acp_sdk.properties文件复制到工程resources下
6.在项目pom.xml文件中添加如下依赖
<!-- 网银支付 -->
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>2.6</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-lang3</artifactId>
<version>3.8</version>
</dependency>
<dependency>
<groupId>commons-codec</groupId>
<artifactId>commons-codec</artifactId>
</dependency>
<dependency>
<groupId>org.bouncycastle</groupId>
<artifactId>bcprov-jdk15on</artifactId>
<version>1.59</version>
</dependency>
7.把官方Demo里面的sdk文件夹里面的全部复制到自己的工程中来还要把demo文件夹里面的DemoBase类也要复制进来(有报错的自己导包即可)
8.在官方网站在线网关支付中点击我要测试进入商户入网测试中心,点击测试参数下载测试证书5.1.0(四个证书全部都要下载)
9.在自己电脑的D盘中创建文件certs把下载的证书复制进去(有压缩包解压出来)
这里为什么要在自己的电脑的D盘中创建这个文件呢?因为在官方的配置文件中,明确的标明了要在这个盘符中找证书,如果不想在D盘也可以自己更改,更改的位置就在acp_sdk.properties这个文件中
11.现在我们要在工程中读取这个配置文件,只需要调用SDKConfig类中的loadPropertiesFromSrc()方法并加入到spring容器里面(具体代码如下)
package com.yinlian.constants;
import com.yinlian.sdk.SDKConfig;
import org.springframework.boot.ApplicationArguments;
import org.springframework.boot.ApplicationRunner;
import org.springframework.stereotype.Component;
/**
* @author 鑫
* @Date 2021/3/27 0027 16:48
*/
@Component
public class InitPay implements ApplicationRunner {
@Override
public void run(ApplicationArguments args) throws Exception {
SDKConfig.getConfig().loadPropertiesFromSrc();
}
}
12.编写service层
package com.yinlian.service;
/**
* @author 鑫
* @Date 2021/3/27 0027 16:58
*/
public interface PayService {
String pay();
}
13.现在写业务层,详情可以参考官方Form_6_2_FrontConsume类(我已经给你们整理了,如其他业务需求,可以在此基础上添加你的业务需求)
package com.yinlian.service.impl;
import com.yinlian.sdk.AcpService;
import com.yinlian.sdk.DemoBase;
import com.yinlian.sdk.SDKConfig;
import com.yinlian.service.PayService;
import org.springframework.stereotype.Service;
import java.util.HashMap;
import java.util.Map;
import java.util.UUID;
/**
* @author 鑫
* @Date 2021/3/27 0027 16:58
*/
@Service
public class PayServiceImpl implements PayService {
@Override
public String pay() {
Map<String, String> requestData = new HashMap<String, String>();
/***银联全渠道系统,产品参数,除了encoding自行选择外其他不需修改***/
requestData.put("version", DemoBase.version); //版本号,全渠道默认值
requestData.put("encoding", DemoBase.encoding); //字符集编码,可以使用UTF-8,GBK两种方式
requestData.put("signMethod", SDKConfig.getConfig().getSignMethod()); //签名方法
requestData.put("txnType", "01"); //交易类型 ,01:消费
requestData.put("txnSubType", "01"); //交易子类型, 01:自助消费
requestData.put("bizType", "000201"); //业务类型,B2C网关支付,手机wap支付
requestData.put("channelType", "07"); //渠道类型,这个字段区分B2C网关支付和手机wap支付;07:PC,平板 08:手机
/***商户接入参数***/
requestData.put("merId", "777290058190039"); //商户号码,请改成自己申请的正式商户号或者open上注册得来的777测试商户号
requestData.put("accessType", "0"); //接入类型,0:直连商户
requestData.put("orderId", getUUID()); //商户订单号,8-40位数字字母,不能含“-”或“_”,可以自行定制规则
requestData.put("txnTime", DemoBase.getCurrentTime()); //订单发送时间,取系统时间,格式为yyyyMMddHHmmss,必须取当前时间,否则会报txnTime无效
requestData.put("currencyCode", "156"); //交易币种(境内商户一般是156 人民币)
requestData.put("txnAmt", "10000"); //交易金额,单位分,不要带小数点
requestData.put("riskRateInfo", "{commodityName=测试商品名称}");
//前台通知地址 (需设置为外网能访问 http https均可),支付成功后的页面 点击“返回商户”按钮的时候将异步通知报文post到该地址
//如果想要实现过几秒中自动跳转回商户页面权限,需联系银联业务申请开通自动返回商户权限
//异步通知参数详见open.unionpay.com帮助中心 下载 产品接口规范 网关支付产品接口规范 消费交易 商户通知
requestData.put("frontUrl", DemoBase.frontUrl);
//后台通知地址(需设置为【外网】能访问 http https均可),支付成功后银联会自动将异步通知报文post到商户上送的该地址,失败的交易银联不会发送后台通知
//后台通知参数详见open.unionpay.com帮助中心 下载 产品接口规范 网关支付产品接口规范 消费交易 商户通知
//注意:1.需设置为外网能访问,否则收不到通知 2.http https均可 3.收单后台通知后需要10秒内返回http200或302状态码
// 4.如果银联通知服务器发送通知后10秒内未收到返回状态码或者应答码非http200,那么银联会间隔一段时间再次发送。总共发送5次,每次的间隔时间为0,1,2,4分钟。
// 5.后台通知地址如果上送了带有?的参数,例如:http://abc/web?a=b&c=d 在后台通知处理程序验证签名之前需要编写逻辑将这些字段去掉再验签,否则将会验签失败
requestData.put("backUrl", DemoBase.backUrl);
/**请求参数设置完毕,以下对请求参数进行签名并生成html表单,将表单写入浏览器跳转打开银联页面**/
Map<String, String> submitFromData = AcpService.sign(requestData,DemoBase.encoding); //报文中certId,signature的值是在signData方法中获取并自动赋值的,只要证书配置正确即可。
String requestFrontUrl = SDKConfig.getConfig().getFrontRequestUrl(); //获取请求银联的前台地址:对应属性文件acp_sdk.properties文件中的acpsdk.frontTransUrl
String html = AcpService.createAutoFormHtml(requestFrontUrl, submitFromData,DemoBase.encoding); //生成自动跳转的Html表单
return html;
}
public static String getUUID(){
//随机生成一位整数
int random = (int) (Math.random()*9+1);
String valueOf = String.valueOf(random);
//生成uuid的hashCode值
int hashCode = UUID.randomUUID().toString().hashCode();
//可能为负数
if(hashCode<0){
hashCode = -hashCode;
}
String value = valueOf + String.format("%015d", hashCode);
System.out.println(value);
return value;
}
}
14.编写controller层,启动项目
package com.yinlian.controller;
import com.yinlian.service.PayService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
/**
* @author 鑫
* @Date 2021/3/27 0027 16:56
*/
@RestController
public class PayController {
@Autowired
private PayService payService;
@RequestMapping("/pay")
public String pay(){
String pay = payService.pay();
return pay;
}
}
注意:这里需要使用到外网才可以,所以小编在这里使用了内网穿透:https://www.ngrok.cc/(具体教程官网里面有)
注意:如果启动报权限不足的错误可能是因为你的测试环境没有启动在产品列表开启测试
注意这里卡号在你的商户入网测试中心的测试参数里面有,短信验证码什么的参数都有自己去复制即可
这里支付完成之后返回商户可以是自己定义的页面,只需要在配置文件中加入自己要跳转的页面即可(必须外网可以访问才行,要不然不能跳转到自己定义的页面)