springboot银联支付（在线网关支付）

springboot 银联支付&＃xff08;在线网关支付&＃xff09;

应用&＃xff1a;跳转到银行支付页面&＃xff0c;输入银行卡号、姓名、身份证号、短信验证码完成支付

官方网站&＃xff1a;https://open.unionpay.com/tjweb/acproduct/APIList?apiservId&＃61;448&acpAPIId&＃61;275&bussType&＃61;0#nav05

******************************

示例

********************

配置文件

acp_sdk.properties

##############SDK配置文件&＃xff08;证书方式签名&＃xff09;################
# 说明&＃xff1a;
# 1. 使用时请将此文件复制到src文件夹下替换原来的acp_sdk.properties。
# 2. 具体配置项请根据注释修改。
#
##########################################################################入网测试环境交易发送地址&＃xff08;线上测试需要使用生产环境交易请求地址&＃xff09;###############################交易请求地址
acpsdk.frontTransUrl&＃61;https://gateway.test.95516.com/gateway/api/frontTransReq.do
acpsdk.backTransUrl&＃61;https://gateway.test.95516.com/gateway/api/backTransReq.do
acpsdk.singleQueryUrl&＃61;https://gateway.test.95516.com/gateway/api/queryTrans.do
acpsdk.batchTransUrl&＃61;https://gateway.test.95516.com/gateway/api/batchTrans.do
acpsdk.fileTransUrl&＃61;https://filedownload.test.95516.com/
acpsdk.appTransUrl&＃61;https://gateway.test.95516.com/gateway/api/appTransReq.do
acpsdk.cardTransUrl&＃61;https://gateway.test.95516.com/gateway/api/cardTransReq.do#以下缴费产品使用&＃xff0c;其余产品用不到
acpsdk.jfFrontTransUrl&＃61;https://gateway.test.95516.com/jiaofei/api/frontTransReq.do
acpsdk.jfBackTransUrl&＃61;https://gateway.test.95516.com/jiaofei/api/backTransReq.do
acpsdk.jfSingleQueryUrl&＃61;https://gateway.test.95516.com/jiaofei/api/queryTrans.do
acpsdk.jfCardTransUrl&＃61;https://gateway.test.95516.com/jiaofei/api/cardTransReq.do
acpsdk.jfAppTransUrl&＃61;https://gateway.test.95516.com/jiaofei/api/appTransReq.do######################################################################### 报文版本号&＃xff0c;固定5.1.0&＃xff0c;请勿改动
acpsdk.version&＃61;5.1.0# 签名方式&＃xff0c;证书方式固定01&＃xff0c;请勿改动
acpsdk.signMethod&＃61;01# 是否验证验签证书的CN&＃xff0c;测试环境请设置false&＃xff0c;生产环境请设置true。非false的值默认都当true处理。
acpsdk.ifValidateCNName&＃61;false# 是否验证https证书&＃xff0c;测试环境请设置false&＃xff0c;生产环境建议优先尝试true&＃xff0c;不行再false。非true的值默认都当false处理。
acpsdk.ifValidateRemoteCert&＃61;false#后台通知地址&＃xff0c;填写接收银联后台通知的地址&＃xff0c;必须外网能访问
acpsdk.backUrl&＃61;http://98vj52.natappfree.cc/notify#前台通知地址&＃xff0c;填写银联前台通知的地址&＃xff0c;必须外网能访问
acpsdk.frontUrl&＃61;http://98vj52.natappfree.cc/return#########################入网测试环境签名证书配置 ################################
# 多证书的情况证书路径为代码指定&＃xff0c;可不对此块做配置。
# 签名证书路径&＃xff0c;必须使用绝对路径&＃xff0c;如果不想使用绝对路径&＃xff0c;可以自行实现相对路径获取证书的方法&＃xff1b;测试证书所有商户共用开发包中的测试签名证书&＃xff0c;生产环境请从cfca下载得到。
# windows样例&＃xff1a;
acpsdk.signCert.path&＃61;D:/certs/acp_test_sign.pfx
# linux样例&＃xff08;注意&＃xff1a;在linux下读取证书需要保证证书有被应用读的权限&＃xff09;&＃xff08;后续其他路径配置也同此条说明&＃xff09;
#acpsdk.signCert.path&＃61;/SERVICE01/usr/ac_frnas/conf/ACPtest/acp700000000000001.pfx# 签名证书密码&＃xff0c;测试环境固定000000&＃xff0c;生产环境请修改为从cfca下载的正式证书的密码&＃xff0c;正式环境证书密码位数需小于等于6位&＃xff0c;否则上传到商户服务网站会失败
acpsdk.signCert.pwd&＃61;000000
# 签名证书类型&＃xff0c;固定不需要修改
acpsdk.signCert.type&＃61;PKCS12##########################加密证书配置################################
# 敏感信息加密证书路径(商户号开通了商户对敏感信息加密的权限&＃xff0c;需要对 卡号accNo&＃xff0c;pin和phoneNo&＃xff0c;cvn2&＃xff0c;expired加密&＃xff08;如果这些上送的话&＃xff09;&＃xff0c;对敏感信息加密使用)
acpsdk.encryptCert.path&＃61;D:/certs/acp_test_enc.cer##########################验签证书配置################################
# 验签中级证书路径(银联提供)
acpsdk.middleCert.path&＃61;D:/certs/acp_test_middle.cer
# 验签根证书路径(银联提供)
acpsdk.rootCert.path&＃61;D:/certs/acp_test_root.cer
acpsdk.validateCert.dir&＃61;D:/certs/

********************

config 层

UnionpayConfig&＃xff1a;加载配置属性&＃xff0c;初始化SDKConfig

&＃64;Configuration
public class UnionpayConfig implements ApplicationRunner {&＃64;Overridepublic void run(ApplicationArguments args) {SDKConfig.getConfig().loadPropertiesFromSrc();}
}


********************

service 层

UnionpayService

public interface UnionpayService {String pay(String orderId,String txnAmt); //支付接口
}


********************

serviceImpl 层

UnionpayServiceImpl

&＃64;Service
public class UnionpayServiceImpl implements UnionpayService {&＃64;Overridepublic String pay(String orderId, String txnAmt) {Map requestData &＃61; new HashMap<>();/***银联全渠道系统&＃xff0c;产品参数&＃xff0c;除了encoding自行选择外其他不需修改***/requestData.put("version", SDKConstants.VERSION_5_1_0); //版本号&＃xff0c;全渠道默认值requestData.put("encoding", SDKConstants.UTF_8_ENCODING); //字符集编码&＃xff0c;可以使用UTF-8,GBK两种方式requestData.put("signMethod", SDKConfig.getConfig().getSignMethod()); //签名方法requestData.put("txnType", "01"); //交易类型 &＃xff0c;01&＃xff1a;消费requestData.put("txnSubType", "01"); //交易子类型&＃xff0c; 01&＃xff1a;自助消费requestData.put("bizType", "000201"); //业务类型&＃xff0c;B2C网关支付&＃xff0c;手机wap支付requestData.put("channelType", "07"); //渠道类型&＃xff0c;这个字段区分B2C网关支付和手机wap支付&＃xff1b;07&＃xff1a;PC,平板 08&＃xff1a;手机/***商户接入参数***/requestData.put("merId", "777***"); //商户号码&＃xff0c;请改成自己申请的正式商户号或者open上注册得来的777测试商户号requestData.put("accessType", "0"); //接入类型&＃xff0c;0&＃xff1a;直连商户requestData.put("orderId",orderId); //商户订单号&＃xff0c;8-40位数字字母&＃xff0c;不能含“-”或“_”&＃xff0c;可以自行定制规则requestData.put("txnTime", DemoBase.getCurrentTime()); //订单发送时间&＃xff0c;取系统时间&＃xff0c;格式为YYYYMMDDhhmmss&＃xff0c;必须取当前时间&＃xff0c;否则会报txnTime无效requestData.put("currencyCode", "156"); //交易币种&＃xff08;境内商户一般是156 人民币&＃xff09;requestData.put("txnAmt", txnAmt); //交易金额&＃xff0c;单位分&＃xff0c;不要带小数点requestData.put("accType","01"); //账号类型String accNo&＃61;AcpService.encryptData("6216261000000000018",SDKConstants.UTF_8_ENCODING);requestData.put("accNo",accNo);requestData.put("encryptCertId",AcpService.getEncryptCertId()); //加密证书的certId&＃xff0c;配置在acp_sdk.properties文件 acpsdk.encryptCert.path属性下//前台通知地址 &＃xff08;需设置为外网能访问 http https均可&＃xff09;&＃xff0c;支付成功后的页面 点击“返回商户”按钮的时候将异步通知报文post到该地址//如果想要实现过几秒中自动跳转回商户页面权限&＃xff0c;需联系银联业务申请开通自动返回商户权限//异步通知参数详见open.unionpay.com帮助中心 下载 产品接口规范 网关支付产品接口规范 消费交易 商户通知requestData.put("frontUrl", DemoBase.frontUrl);//后台通知地址&＃xff08;需设置为【外网】能访问 http https均可&＃xff09;&＃xff0c;支付成功后银联会自动将异步通知报文post到商户上送的该地址&＃xff0c;失败的交易银联不会发送后台通知//后台通知参数详见open.unionpay.com帮助中心 下载 产品接口规范 网关支付产品接口规范 消费交易 商户通知//注意:1.需设置为外网能访问&＃xff0c;否则收不到通知 2.http https均可 3.收单后台通知后需要10秒内返回http200或302状态码// 4.如果银联通知服务器发送通知后10秒内未收到返回状态码或者应答码非http200&＃xff0c;那么银联会间隔一段时间再次发送。总共发送5次&＃xff0c;每次的间隔时间为0,1,2,4分钟。// 5.后台通知地址如果上送了带有&＃xff1f;的参数&＃xff0c;例如&＃xff1a;http://abc/web?a&＃61;b&c&＃61;d 在后台通知处理程序验证签名之前需要编写逻辑将这些字段去掉再验签&＃xff0c;否则将会验签失败requestData.put("backUrl", DemoBase.backUrl);// 报文中特殊用法请查看 PCwap网关跳转支付特殊用法.txt/**请求参数设置完毕&＃xff0c;以下对请求参数进行签名并生成html表单&＃xff0c;将表单写入浏览器跳转打开银联页面**///报文中certId,signature的值是在signData方法中获取并自动赋值的&＃xff0c;只要证书配置正确即可。Map submitFromData &＃61; AcpService.sign(requestData, SDKConstants.UTF_8_ENCODING);//获取请求银联的前台地址&＃xff1a;对应属性文件acp_sdk.properties文件中的acpsdk.frontTransUrlString requestFrontUrl &＃61; SDKConfig.getConfig().getFrontRequestUrl();//生成自动跳转的Html表单return AcpService.createAutoFormHtml(requestFrontUrl, submitFromData,SDKConstants.UTF_8_ENCODING);}}

********************

controller 层

UnionpayController

&＃64;RestController
public class UnionpayController {&＃64;Resourceprivate UnionpayService unionpayService;&＃64;RequestMapping("/pay")public void pay(HttpServletResponse response) throws Exception{response.setHeader("content-type", "text/html;charset&＃61;UTF-8");response.getWriter().write(unionpayService.pay(DemoBase.getOrderId(),"20000"));}&＃64;RequestMapping("/return")public String fun(HttpServletRequest request){Map result&＃61;new HashMap<>();System.out.println("&＃61;&＃61;&＃61;&＃61;&＃61;&＃61; 前台通知 &＃61;&＃61;&＃61;&＃61;&＃61;&＃61;");Enumeration names&＃61;request.getParameterNames();if (names!&＃61;null){while (names.hasMoreElements()){String name&＃61;names.nextElement();String value&＃61;request.getParameter(name);result.put(name,value);System.out.println(name&＃43;" &＃61;&＃61;> "&＃43;value);if (result.get(name)&＃61;&＃61;null||"".equals(result.get(name))){result.remove(name);}}}if (AcpService.validate(result, SDKConstants.UTF_8_ENCODING)){ //前台参数验签return "success";}else {return "验签失败";}}&＃64;RequestMapping("/notify")public void hello2(HttpServletRequest request,HttpServletResponse response) throws Exception{Map result&＃61;new HashMap<>();System.out.println("&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61; 后台通知 &＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;");Enumeration names&＃61;request.getParameterNames();if (names!&＃61;null){while (names.hasMoreElements()){String name&＃61;names.nextElement();String value&＃61;request.getParameter(name);result.put(name,value);System.out.println(name&＃43;" &＃61;&＃61;> "&＃43;value);if (result.get(name)&＃61;&＃61;null||"".equals(result.get(name))){result.remove(name);}}}if (AcpService.validate(result, SDKConstants.UTF_8_ENCODING)){System.out.println("后台验签成功");}else {System.out.println("后台验签失败");}response.getWriter().print("ok");}
}


******************************

使用测试

localhost:8080/pay

说明&＃xff1a;姓名全渠道、身份证输入测试中心提供的身份证、短信验证码111111