移动App后台Java开发银联支付后台接口

时间:2022-11-07 22:09:51

由于公司App开发的支付需求,需要后台用Java来完成银联支付接入接口。

首先你要先进入银联开发登录地址open.unionpay.com


找到手机控件支付模块,完成相应的入网步骤

移动App后台Java开发银联支付后台接口


准备工作做完之后银联会对你发放相应的技术文档

移动App后台Java开发银联支付后台接口

这里由于银联所给的证书信息只有14天,所以要尽快下载,并且只能下载一次。
移动App后台Java开发银联支付后台接口

下载手机控件Demo就可以开始了,这里面IOS版本的和安卓版本的任意一个都可以,都有我们需要的后台开发样例
移动App后台Java开发银联支付后台接口

将下载下来的Demo仔细阅读开发联调步骤向导中的
三、后台开发步骤
1. 打开后台开发包,找到对应语言\示例代码文件夹,看下readme.txt,按步骤部署、修改配置文件等。
2. 其中Form_6_2_AppConsume的接口可获取tn,请跟客户端开发确定一下后台和app间传递tn的方式,最简单的方法就是直接在页面打印tn,不过部分语言直接仅打印tn的时候会带换行符,建议手机开发在收到tn的时候trim一下。
3. 后续参考readme完成。
(此时已经有了大体思路知道该怎么做了,就是通过下面的类得到 tn 返还给Android或者IOS前台人员,剩下的就是他们根据相应下载的控件来调取银联支付接口的事情了,是不是so easy)

移动App后台Java开发银联支付后台接口

我们首先先来运行一下Demo,在脑海中首先形成一个流程的概念
工程运行之后访问http://localhost:8080/ACPSample_AppServer/
输入钱数,点击消费。

移动App后台Java开发银联支付后台接口

会返回给我们一个报文,这里面有你的请求信息以及应答信息
在这里我们可以清楚的看到有个神奇的tn
这就是他们要的

移动App后台Java开发银联支付后台接口

找到Demo中的这个类,不得不说银联很是牛逼,方便大家接入直接用servlet来写

移动App后台Java开发银联支付后台接口

这里需要注意的一点是他在加载servlet容器时注释的SDKConfig加载配置文件的代码

@Override
public void init(ServletConfig config) throws ServletException {
/**
* 请求银联接入地址,获取证书文件,证书路径等相关参数初始化到SDKConfig类中
* 在java main 方式运行时必须每次都执行加载
* 如果是在web应用开发里,这个方法可使用监听的方式写入缓存,无须在这出现
*/

//这里已经将加载属性文件的方法挪到了web/AutoLoadServlet.java中
//SDKConfig.getConfig().loadPropertiesFromSrc(); //从classpath加载acp_sdk.properties文件
super.init();
}

由于他在web.xml中配置了autoLoadServlet在项目一起动的时候就运行此servlet,会自动执行被挪到web/AutoLoadServlet.java中的加载配置文件信息,所以在自己使用调用的时候不要忘记加载配置文件相关信息。

<servlet>
<servlet-name>autoLoadServlet</servlet-name>
<servlet-class>web.AutoLoadServlet</servlet-class>
<load-on-startup>0</load-on-startup>
</servlet>

下面就可以进行接入了,首先现将Demo中给的银联接入所需要的工具类导入自己的工程,否则复制下面的代码会报错。
移动App后台Java开发银联支付后台接口

在你需要接入支付的业务处理层中加入如下代码。通过此段程序就可以将tn返给前台,这里我用的是json格式返回的。大家可以采用别种方式。

//加载配置文件
SDKConfig.getConfig().loadPropertiesFromSrc();// 从classpath加载acp_sdk.properties文件
//银联接入 要传入的参数
String referenceNumber = orderInfo.getOrder_number();//这里的订单id是根据自己的业务需求需要自行设置的
// 一分钱
String amount = "1";

Map<String, String> contentData = new HashMap<String, String>();

/***银联全渠道系统,产品参数,除了encoding自行选择外其他不需修改***/
contentData.put("version", DemoBase.version); //版本号 全渠道默认值
contentData.put("encoding", DemoBase.encoding); //字符集编码 可以使用UTF-8,GBK两种方式
contentData.put("signMethod", SDKConfig.getConfig().getSignMethod()); //签名方法
contentData.put("txnType", "01"); //交易类型 01:消费
contentData.put("txnSubType", "01"); //交易子类 01:消费
contentData.put("bizType", "000201"); //填写000201
contentData.put("channelType", "08"); //渠道类型 08手机

/***商户接入参数***/
contentData.put("merId", "************"); //商户号码,请改成自己申请的商户号或者open上注册得来的777商户号测试
contentData.put("accessType", "0"); //接入类型,商户接入填0 ,不需修改(0:直连商户, 1: 收单机构 2:平台商户)
contentData.put("orderId", referenceNumber); //商户订单号,8-40位数字字母,不能含“-”或“_”,可以自行定制规则
contentData.put("txnTime", new SimpleDateFormat("yyyyMMddHHmmss").format(new Date())); //订单发送时间,取系统时间,格式为YYYYMMDDhhmmss,必须取当前时间,否则会报txnTime无效
contentData.put("accType", "01"); //账号类型 01:银行卡02:存折03:IC卡帐号类型(卡介质)
contentData.put("txnAmt", amount); //交易金额 单位为分,不能带小数点
contentData.put("currencyCode", "156"); //境内商户固定 156 人民币

// 请求方保留域,
// 透传字段,查询、通知、对账文件中均会原样出现,如有需要请启用并修改自己希望透传的数据。
// 出现部分特殊字符时可能影响解析,请按下面建议的方式填写:
// 1. 如果能确定内容不会出现&={}[]"'等符号时,可以直接填写数据,建议的方法如下。
//contentData.put("reqReserved", "透传信息1|透传信息2|透传信息3");
// 2. 内容可能出现&={}[]"'符号时:
// 1) 如果需要对账文件里能显示,可将字符替换成全角&={}【】“‘字符(自己写代码,此处不演示);
// 2) 如果对账文件没有显示要求,可做一下base64(如下)。
// 注意控制数据长度,实际传输的数据长度不能超过1024位。
// 查询、通知等接口解析时使用new String(Base64.decodeBase64(reqReserved), DemoBase.encoding);解base64后再对数据做后续解析。
//contentData.put("reqReserved", Base64.encodeBase64String("任意格式的信息都可以".toString().getBytes(DemoBase.encoding)));

//后台通知地址(需设置为外网能访问 http https均可),支付成功后银联会自动将异步通知报文post到商户上送的该地址,【支付失败的交易银联不会发送后台通知】
//后台通知参数详见open.unionpay.com帮助中心 下载 产品接口规范 网关支付产品接口规范 消费交易 商户通知
//注意:1.需设置为外网能访问,否则收不到通知 2.http https均可 3.收单后台通知后需要10秒内返回http200或302状态码
// 4.如果银联通知服务器发送通知后10秒内未收到返回状态码或者应答码非http200或302,那么银联会间隔一段时间再次发送。总共发送5次,银联后续间隔1、2、4、5 分钟后会再次通知。
// 5.后台通知地址如果上送了带有?的参数,例如:http://abc/web?a=b&c=d 在后台通知处理程序验证签名之前需要编写逻辑将这些字段去掉再验签,否则将会验签失败
contentData.put("backUrl", DemoBase.backUrl);

/**对请求参数进行签名并发送http post请求,接收同步应答报文**/
Map<String, String> reqData = AcpService.sign(contentData,DemoBase.encoding); //报文中certId,signature的值是在signData方法中获取并自动赋值的,只要证书配置正确即可。
String requestAppUrl = SDKConfig.getConfig().getAppRequestUrl(); //交易请求url从配置文件读取对应属性文件acp_sdk.properties中的 acpsdk.backTransUrl
Map<String, String> rspData = AcpService.post(reqData,requestAppUrl,DemoBase.encoding); //发送请求报文并接受同步应答(默认连接超时时间30秒,读取返回结果超时时间30秒);这里调用signData之后,调用submitUrl之前不能对submitFromData中的键值对做任何修改,如果修改会导致验签不通过

/**对应答码的处理,请根据您的业务逻辑来编写程序,以下应答码处理逻辑仅供参考------------->**/
//应答码规范参考open.unionpay.com帮助中心 下载 产品接口规范 《平台接入接口规范-第5部分-附录》
if(!rspData.isEmpty()){
if(AcpService.validate(rspData, DemoBase.encoding)){
LogUtil.writeLog("验证签名成功");
String respCode = rspData.get("respCode") ;
if(("00").equals(respCode)){
//成功,获取tn号
String tn = rspData.get("tn");
System.out.println("=================================================================");
System.out.println(tn);
System.out.println("=================================================================");
Map<String,Object> Tn = new HashMap<String,Object>();
Tn.put("tn", tn);
bean.setContent(Tn);//这里是我自己引入的工具类用来返回json格式数据
//根据不同的需求大家可能要给前台返回的格式不同,这里我采用了json
//TODO
}else{
//其他应答码为失败请排查原因或做失败处理
//TODO
}
}else{
LogUtil.writeErrorLog("验证签名失败");
//TODO 检查验证签名失败的原因
}
}else{
//未返回正确的http状态
LogUtil.writeErrorLog("未获取到返回报文或返回http状态码非200");
}

配置文件需要放在工程的src下,如果是maven项目放到src/main/resources下就可以。这里要仔细阅读配置文件了,再将tn返还给前台的时候,同时已经把回调地址同样发给了银联,这里的后台通知地址,填写后台接收银联后台通知的地址,必须外网能访问。
* * * 这里还需要将配置文件中所需要的证书文件按照指定位置放好,如果你的服务器是linux系统的,配置文件中也给你举好了例子。建议最开始先放测试环境的证书,都调试完毕了再更换正式生产的证书也不迟。

##############SDK配置文件(证书方式签名)################
# 说明:
# 1. 使用时请删除后缀的“.证书”,并将此文件复制到src文件夹下替换原来的acp_sdk.properties。
# 2. 具体配置项请根据注释修改。
#
################################################

##########################入网测试环境交易发送地址(线上测试需要使用生产环境交易请求地址)#############################

##交易请求地址
acpsdk.frontTransUrl=https://gateway.test.95516.com/gateway/api/frontTransReq.do
acpsdk.backTransUrl=https://gateway.test.95516.com/gateway/api/backTransReq.do
acpsdk.singleQueryUrl=https://gateway.test.95516.com/gateway/api/queryTrans.do
acpsdk.batchTransUrl=https://gateway.test.95516.com/gateway/api/batchTrans.do
acpsdk.fileTransUrl=https://filedownload.test.95516.com/
acpsdk.appTransUrl=https://gateway.test.95516.com/gateway/api/appTransReq.do
acpsdk.cardTransUrl=https://gateway.test.95516.com/gateway/api/cardTransReq.do

#以下缴费产品使用,其余产品用不到
acpsdk.jfFrontTransUrl=https://gateway.test.95516.com/jiaofei/api/frontTransReq.do
acpsdk.jfBackTransUrl=https://gateway.test.95516.com/jiaofei/api/backTransReq.do
acpsdk.jfSingleQueryUrl=https://gateway.test.95516.com/jiaofei/api/queryTrans.do
acpsdk.jfCardTransUrl=https://gateway.test.95516.com/jiaofei/api/cardTransReq.do
acpsdk.jfAppTransUrl=https://gateway.test.95516.com/jiaofei/api/appTransReq.do

########################################################################

# 报文版本号,固定5.1.0,请勿改动
acpsdk.version=5.1.0

# 签名方式,证书方式固定01,请勿改动
acpsdk.signMethod=01

# 是否验证验签证书的CN,测试环境请设置false,生产环境请设置true。非false的值默认都当true处理。
acpsdk.ifValidateCNName=false

# 是否验证https证书,测试环境请设置false,生产环境建议优先尝试true,不行再false。非true的值默认都当false处理。
acpsdk.ifValidateRemoteCert=false

#前台通知地址,填写后台接收银联前台通知的地址
acpsdk.backUrl=http://222.222.222.222:8080/ACPSample_AppServer/backRcvResponse

#后台通知地址,填写后台接收银联后台通知的地址,必须外网能访问
acpsdk.frontUrl=http://localhost:8080/ACPSample_AppServer/frontRcvResponse

#########################入网测试环境签名证书配置 ################################
# 多证书的情况证书路径为代码指定,可不对此块做配置。
# 签名证书路径,必须使用绝对路径,如果不想使用绝对路径,可以自行实现相对路径获取证书的方法;测试证书所有商户共用开发包中的测试签名证书,生产环境请从cfca下载得到。
# windows样例:
acpsdk.signCert.path=D:/certs/acp_test_sign.pfx
# linux样例(注意:在linux下读取证书需要保证证书有被应用读的权限)(后续其他路径配置也同此条说明)
#acpsdk.signCert.path=/SERVICE01/usr/ac_frnas/conf/ACPtest/acp700000000000001.pfx

# 签名证书密码,测试环境固定000000,生产环境请修改为从cfca下载的正式证书的密码,正式环境证书密码位数需小于等于6位,否则上传到商户服务网站会失败
acpsdk.signCert.pwd=000000
# 签名证书类型,固定不需要修改
acpsdk.signCert.type=PKCS12

##########################加密证书配置################################
# 敏感信息加密证书路径(商户号开通了商户对敏感信息加密的权限,需要对 卡号accNo,pin和phoneNo,cvn2,expired加密(如果这些上送的话),对敏感信息加密使用)
acpsdk.encryptCert.path=d:/certs/acp_test_enc.cer

##########################验签证书配置################################
# 验签中级证书路径(银联提供)
acpsdk.middleCert.path=D:/certs/acp_test_middle.cer
# 验签根证书路径(银联提供)
acpsdk.rootCert.path=D:/certs/acp_test_root.cer

前台交易支付成功后会找寻到你的回调地址,我们需要写一个回调来接收。
【注:为了安全验签成功才应该写商户的成功处理逻辑】交易成功,更新商户订单状态

LogUtil.writeLog("BackRcvResponse接收后台通知开始");

String encoding = req.getParameter(SDKConstants.param_encoding);
// 获取银联通知服务器发送的后台通知参数
Map<String, String> reqParam = getAllRequestParam(req);

LogUtil.printRequestLog(reqParam);

Map<String, String> valideData = null;
if (null != reqParam && !reqParam.isEmpty()) {
Iterator<Entry<String, String>> it = reqParam.entrySet().iterator();
valideData = new HashMap<String, String>(reqParam.size());
while (it.hasNext()) {
Entry<String, String> e = it.next();
String key = (String) e.getKey();
String value = (String) e.getValue();

valideData.put(key, value);
}
}

//重要!验证签名前不要修改reqParam中的键值对的内容,否则会验签不过
if (!AcpService.validate(valideData, encoding)) {
LogUtil.writeLog("验证签名结果[失败].");
//验签失败,需解决验签问题

} else {
LogUtil.writeLog("验证签名结果[成功].");
//【注:为了安全验签成功才应该写商户的成功处理逻辑】交易成功,更新商户订单状态
//这里写回调成功之后的业务处理
String orderId =valideData.get("orderId"); //获取后台通知的数据,其他字段也可用类似方式获取
//具体的字段可以从运行Demo请求交易返回的报文中得到
String respCode = valideData.get("respCode");
//判断respCode=00、A6后,对涉及资金类的交易,请再发起查询接口查询,确定交易成功后更新数据库。
}
LogUtil.writeLog("BackRcvResponse接收后台通知结束");
/**
* 获取请求参数中所有的信息
*
* @param request
* @return
*/

public static Map<String, String> getAllRequestParam(final HttpServletRequest request) {
Map<String, String> res = new HashMap<String, String>();
Enumeration<?> temp = request.getParameterNames();
if (null != temp) {
while (temp.hasMoreElements()) {
String en = (String) temp.nextElement();
String value = request.getParameter(en);
res.put(en, value);
//在报文上送时,如果字段的值为空,则不上送<下面的处理为在获取所有参数数据时,判断若值为空,则删除这个字段>
//System.out.println("ServletUtil类247行 temp数据的键=="+en+" 值==="+value);
if (null == res.get(en) || "".equals(res.get(en))) {
res.remove(en);
}
}
}
return res;
}

到这里基本上就调起交易,并且回调差不多完事了。剩下的就是测试如果能交易成功就要换成生产环境了。
生产环境所需要的证书还请仔细观看
移动App后台Java开发银联支付后台接口