银联支付java接入避坑指南[亲测有效]-chinapay是第三方支付

银联支付（chinapay）java接入避坑指南[亲测有效]银联无卡支付java接入避坑指南，从代码实现上进行总结说明。

一、背景

银联支付能给满足绝大部分银行支付渠道，所以接入银联无卡支付，是很多系统应用需要做的事情。银联支付的类型分很多种，网关支付（带token请求实现，下次有空再分享）、无卡支付（带证书请求实现，本次讲的就是这个）分商户和机构入网，具体请去这里查看中国银联开放平台

二、效果

本次讲解实现的银联无卡支付，实现的效果图即提交订单后进入支付页面的效果图如下

三、开发前准备

当你需要接入银联无卡支付的时候，肯定是经过了需求调研，所以会有对接人给你们申请，所以会给你们发邮件，提供相应开发所需的文件，如下

1、开发文档ChinaPay_新一代_商户接入手册_20210412.pdf

2、证书cp.cer

3、私钥xxxxxxxx.pfx和密码

4、插件包，里面提供了Java、.net、C和PHP的插件包，java的就是chinapaysecure1_5.jar

5、测试账号，请从如下地址获取FAQ列表- 中国银联开放平台

6、让银联方配置测试ip白名单，如果自己本地开发，出口ip需要固定，查询自己的出口ip地址如下用户检测分析工具

注意：如果需要代码参考，可以让银联方提供demo进行参考。这个demo因为是很久之前的，是jsp实现的eclipse项目，所以需要跑起来这个项目需要提前准备好eclipse和tomcat，当然了你会用idea跑eclipse也行。但是有时候稍微不注意，idea跑起来就会有莫名其妙的问题。这种问题经历过的都懂，就不说了。这里要特意说明一点就是，如果想要自己折腾获取xxx.pfx私钥的话，得配置好ip白名单后，登陆他们提供的商户服务管理系统https://newpayment-test.chinapay.com/BIZSS/admin/loginpage.htm后台去申请测试的私钥，即交易证书，这个系统最好用ie去登陆，否则你会因为各种莫名其妙的原因导致下载失败。

四、B2C、B2B、无卡支付交易流程（文档里面有）

五、代码

看到到这里了，证明前面的你已经准备好了，下面就开始看代码层面了，这里先给你们截几张demo的图给你们看看

1、跑完demo就会跳转到这个页面。

2、点击B2C会跳转到组交易报文页面，这里需要填写你的商户号和支付机构号700000000000017（pdf文档里面有）

3、这是组装好的交易报文

4、提交订单后

好了，看完demo的截图，就到我们自己动手，引用到springboot项目中了。

1、新建springboot项目或者直接用你的工作项目，将上面提前准备的xxx.cer、xxx.pfx证书放到项目中指定位置，如在resources下面新建一个文件夹放置这两个证书，在新建一个security.properties放到resources下，后续下单等操作需要签名的时候要获取到这些证书。security.properties的内容如下图。

这里的路径自己定义就好了，security.properties就是为了获取到证书，所以xxx.cer、xxx.pfx证书的路径写在了security.properties文件中。其实这个security.properties文件也可以不放在项目中，可以放在服务器上面，然后需要换证书的时候，直接换服务器文件上的security.properties就好了，不用重启项目，这样就可以做到动态切换证书了。

2、导入chinapaysecure1_5.jar

idea可以用命令导入，如下图

命令如下：

install:install-file
-Dfile=E:\study\chinapaysecure1_5.jar
-DgroupId=com.chinapay.secure
-DartifactId=chinapay-sdk
-Dversion=1.5.0
-Dpackaging=jar

pom 文件引入：

<dependency>
<groupId>com.chinapay.sdk</groupId>
<artifactId>chinapay-sdk</artifactId>
<version>1.5.0</version>
</dependency>

这里需要注意一点就是，如果你的maven仓库是私服的话，上传了这个jar后，如果是下不下来的活，就要检查已经仓库的更新策略了，具体请看这里，添加这个就好了<updatePolicy>always</updatePolicy>https://blog.csdn.net/frank1998819/article/details/84813840

3、好了，废话了那么多，开始放下单支付代码

3.1、交易证书、验签证书初始化（因为我这里的正式是放到服务器上面的，所以需要通过url获取）

String securityUrl = upLoadPath + Constant.CHINA_PAY_SECURITY + chinaPayParameters.getMerchantId() + ".properties";secssUtil = new SecssUtil();File file = new File(securityUrl);boolean bool = secssUtil.init(file.getPath());if (bool) {    log.info("ChinaPay交易证书、验签证书初始化成功！");} else {    log.error("ChinaPay交易证书、验签证书初始化失败："+secssUtil.getErrCode() + "=" + secssUtil.getErrMsg());}

是否还在为Ide开发工具频繁失效而烦恼，来吧关注以下公众号获取最新激活方式。亲测可用！

为防止网络爬虫，请关注公众号回复”口令”

激活idea 激活CLion DataGrip DataSpell dotCover dotMemory dotTrace GoLand PhpStorm PyCharm ReSharper ReShaC++ Rider RubyMine WebStorm 全家桶 解锁下载刷新

【正版授权，激活自己账号】：Jetbrains全家桶Ide使用，1年售后保障，每天仅需1毛

【官方授权 正版激活】：官方授权 正版激活 自己使用，支持Jetbrains家族下所有IDE…

3.2、构建请求报文及签名

Map<String, Object> paramMap = new TreeMap<>();paramMap.put("Version", "20140728");paramMap.put("AccessType","0"); //接入类型  0：商户身份接入（默认）1：机构身份接入paramMap.put("MerId", "123456"); // 商户号paramMap.put("MerOrderNo", "abc123465"); // 商户订单号(由字母和数字组成，不要包含下划线)paramMap.put("TranDate", "20220723"); // YYYYMMDDparamMap.put("TranTime", "103300"); // HHMMSSparamMap.put("OrderAmt", "1"); // 单位：分paramMap.put("TranType", "0001");//交易类型，固定值paramMap.put("BusiType", "0001");//业务类型，固定值paramMap.put("BankInstNo", "700000000000017"); // 支付机构号-银联在线支付(这个参数必填，如果是无卡支付前端请求，否则会失败)paramMap.put("CommodityMsg", "芒果");paramMap.put("RemoteAddr", ipAddr); // ip地址paramMap.put("CurryNo", "CNY");paramMap.put("MerBgUrl", ""); // 后台通知地址paramMap.put("MerPageUrl", ""); // 前端跳转地址

//签名secssUtil.sign(paramMap);if (!SecssConstants.SUCCESS.equals(secssUtil.getErrCode())) {    return PayUtil.errorMessage("500", "500", secssUtil.getErrMsg());}String signature = secssUtil.getSign();paramMap.put("Signature", signature);

3.3、构建from表单System.out.println("####################请求总参数####################");System.out.println(paramMap);//必须构建成【自动提交form表单】html，返回商城前端自动跳转到网银支付页面String buildRequest = MerchantApiUtil.buildRequest(paramMap,frontPayUrl, "post", "确定");System.out.println("####################构建的表单####################");System.out.println(buildRequest);request.setAttribute("result",buildRequest);

3.4、构建from表单代码

public static String buildRequest(Map<String, Object> sParaTemp, String action, String strMethod, String strButtonName) {    //待请求参数数组    List<String> keys = new ArrayList<String>(sParaTemp.keySet());    StringBuffer sbHtml = new StringBuffer();    sbHtml.append("<form id=\"rppaysubmit\" name=\"rppaysubmit\" action=\"" + action + "\" method=\"" + strMethod            + "\">");    for (int i = 0; i < keys.size(); i++) {        String name = (String) keys.get(i);        Object object = sParaTemp.get(name);        String value = "";        if (object != null) {            value = String.valueOf(sParaTemp.get(name));        }        sbHtml.append("<input type=\"hidden\" name=\"" + name + "\" value=\"" + value + "\"/>");    }    //submit按钮控件请不要含有name属性    sbHtml.append("<input type=\"submit\" value=\"" + strButtonName + "\" style=\"display:none;\"></form>");    return sbHtml.toString();}

3.5、vue前端调用下单form表单代码

4、回调接口代码

public String chinaPayNotifyUrl(HttpServletRequest request, HttpServletResponse response) {    //获取请求头参数到paramsMap    String notifyType = request.getParameter(Constant.SPEC_NOTIFY_TYPE);    if(StringUtil.isEmpty(notifyType)) {        notifyType = Constant.NOTIFY_TYPE_BACK;    }    Map<String, String> payNotifyUrlParamsMap = new TreeMap<String, String>();    Enumeration<String> paraNames = request.getParameterNames();    while (paraNames.hasMoreElements()) {        String key = paraNames.nextElement();        // 跳过自定义字段        if (key.startsWith(Constant.SPEC_PRIFEX)) {            continue;        }        // 跳过空字段        String value = request.getParameter(key);        if (StringUtil.isEmpty(value)) {            continue;        }        // 后台通知需要解码,正式使用建议前后台接收通知地址分开        if(Constant.NOTIFY_TYPE_BACK.equals(notifyType)) {            try {            value = URLDecoder.decode(value, Constant.ENCODING);            } catch (UnsupportedEncodingException e) {                e.printStackTrace();            }        }        payNotifyUrlParamsMap.put(key, value);    }    log.info("当前时间：" + DateUtils.getCurrentTime() + "银联支付回调原始参数：" + payNotifyUrlParamsMap.toString());       String outTradeNo = payNotifyUrlParamsMap.get("MerOrderNo") == null ? "" : payNotifyUrlParamsMap.get("MerOrderNo"); // 渠道订单号    //返回数据验签    boolean verifyFlag = verifyNotify(payNotifyUrlParamsMap);    if (!verifyFlag) {        System.out.println("ChinaPay支付回调--返回数据验签失败！");        throw new JeecgBootException("ChinaPay支付回调返回数据验签失败，支付明细编号为：" + outTradeNo);    }

// 这里就写你的业务了

4.1、常量说明

/** * 请求参数-通知类型 0前台 1后台 默认是后台. */public static final String SPEC_NOTIFY_TYPE = "__notifyType";/** * 通知类型-后台. */public static final String NOTIFY_TYPE_BACK = "1";/** * 特殊字段前缀. */public static final String SPEC_PRIFEX = "__";/** * 默认编码. */public static final String ENCODING = "UTF-8";

5、验签

public boolean verifyNotify(Map<String, String> notifyMap) {    String securityUrl = upLoadPath + Constant.CHINA_PAY_SECURITY + notifyMap.get("MerId") + ".properties";    secssUtil = new SecssUtil();    File file = new File(securityUrl);    boolean bool = secssUtil.init(file.getPath());    if (bool) {        System.out.println("ChinaPay交易证书、验签证书初始化成功！");    } else {        System.out.println("ChinaPay交易证书、验签证书初始化失败："+secssUtil.getErrCode() + "=" + secssUtil.getErrMsg());    }    try {        //验签        String sign = notifyMap.get("Signature");        if (StringUtil.isNotEmpty(sign)) {            secssUtil.verify(notifyMap);//入参：返回商户报文中的所有参数        }        if (!SecssConstants.SUCCESS.equals(secssUtil.getErrCode())) {            System.out.println(secssUtil.getErrCode() + "=" + secssUtil.getErrMsg());            System.out.println("ChinaPay返回的应答数据【验签】失败:" + secssUtil.getErrMsg());            return false;        }        return true;    } catch (Exception e) {        e.printStackTrace();    }    return false;}

能给下单获取签名和回调进行验签，那么订单查询、订单退款也就没什么大问题了，以上就是本次分享的银联支付的代码，如有问题，请评论去指出，互相学习，共同进步。

六、总结

现在进行总结一下。

1、进行银联接入，需要提前了解接入后的效果。

2、开发前提前准备好需要的相应参数，否则沟通效率低下，问一个参数就一天了，文档上说不是必填，实际上又是需要必填，导致找不到原因，让银联配合，但是他们效率低下，导致你们接入进度延迟，比如文档上的支付机构号，可能有些情况下不是必填的，但是有些情况下是必填的，但是文档上没有说明，导致踩坑了。

3、form表单提交下单，这里的请求，如果是前端跳转，那么这时的跳转地址是你本地浏览器的地址，无需配置你测试环境的地址，只需要你本地的出口地址在银联的白名单即可。

4、正式环境无需配置白名单，测试环境才需要配置，否则开发的时候联调不了。

5、以上就是接入银联支付的所有，希望后人在接入的时候能给到一些参考，进而避免一些坑，从而提高接入效率。