聊一聊Java如何接入招行一网通支付功能

1.前提条件

相比较于支付宝和微信的支付功能接入这一块，银行相对来说更加严格，比如说支付宝，在你签约之前可以进行一些测试。但是银行来说就不是这样了，如果您现在要进行招行的支付功能开发的话，请务必先让相关人员去进行签约

2. 测试开发必须条件

进行测试开发之前有几个比较重要的东西是不可避免的，我们来看一下都是有什么：

1. 商户号、商户分行号以及商户秘钥（具体明细请参考：http://link.cmbchina.com/open2/doc/totest6.aspx）

2. 验证码查询地址（测试环境招行所发的验证码都可以在此网站查询到http://121.15.180.69/getmsgverifycode/default.aspx）

3. api文档（进行签约时招行一般会给我们一份文档，但是此文档也是很有参考价值的http://link.cmbchina.com/open2/api/apidefault.aspx）

3.测试开发

咱们这次一个完整的支付流程为例

进入正式的开发之前咱们先来看一下一个图，这个图呢，简单介绍了一下这个支付的流程，并没有考虑失败的因素。仅供大家参考！

接下来呢，我们就按照上图所示的流程进行开发。

1. 第一个相信不用费心，app请求时携带一个订单号就行。

2. 我们根据订单号查询出此订单关联的订单金额及用户等信息，然后呢参考此链接（http://link.cmbchina.com/open2/api/pwdpayapi4.aspx）的请求报文要求的必填字段一一组合起来。
   
   这里组合的时候有几个小小的问题，因为招行对我们发送的请求报文是有要求的：测试环境回调地址不支持域名，只能是纯ip地址，且端口只能为80、443、8081其中的一个。另外请求报文中的reqdata字段里的内容要进行排序。最后，排序完的报文要进行签名。详细要求请看此链接：http://link.cmbchina.com/open2/api/sigandcheck2.aspx
   
   
   这里进行排序的话我可以提供一种全新的思路，我们可以把待排序的字段使用一个dto封装起来类似于下面这种：

 //客户协议号。
private string agrno;

//金额
private string amount;

 //银行订单流水号
private string bankserialno;

// 商户分行号
private string branchno;

这样的dto转换成json串的时候是已经有序了的。

对参数进行签名的话怎可以参考招行为我们提供的代码示例。http://link.cmbchina.com/open2/api/appendix16.aspx#jvch2
需要注意的就是上方我们dto转成的是一个json串，但是签名要求的待签名的字符串格式是这样的。agrno=xxx&amount=88.88&bankserialno=1234567&branchno=xxx

排序以及签名完毕以后就可以把这个发送给app了，我们发送给app的就是下方这个形式的json：

{
  "version":"1.0",
  "charset":"utf-8",
  "sign":"见签名处理章节",
  "signtype":"sha-256",
  "reqdata":{
       "datetime":"20161209112230",
       "branchno":"0755",
       "merchantno":"000054",
       "date":"20161209",
       "orderno":"9999000001",
       "amount":"0.01",
       "expiretimespan":"30",
       "paynoticeurl":"http://www.merchant.com/path/paynotice.do",
       "paynoticepara":"12345678|abcdefg|hijklm",
       "returnurl":"http://www.merchant.com/path/return.do",
       "clientip":"99.12.38.165",
       "cardtype":"a",
       "agrno":"12345678901234567890",
       "merchantserialno":"2016062014308888",
       "userid":"2016062388888"
       }
 }

3. app收到服务器返回的请求报文，就可以组成如下表单向招行发送请求：

<form action="http://121.15.180.66:801/netpayment/basehttp.dll?mb_euserpay" method="post" >
    <input type="hidden" name="jsonrequestdata" value='服务端返回的请求报文' />
<input type="submit" >
</form>

这一块呢，也有一个需要注意的地方，因为有的时候我们服务端开发的时候可能app还没有时间，如果我们每次都让人家帮忙也挺浪费时间的。这里也有一个快速测试的好办法。我们可以把上方的代码拿着自己建一个html文件，发送到自己手机上，然后使用手机浏览器打开其实也是可以的。

4. 此时招行就会返回一个统一的支付页面

5. 在这我们填入签约时招行给我们的测试账号等信息，账号支付使用的验证码请参考文章刚开始我们所说的网址

6. 假设支付成功，那么招行就会回调我们请求参数所填的回调地址，这里其实是有两个回调地址的，一个是签约成功的回调，一个是支付成功的回调。
   
   
   关于这些回调的问题一般我们会有两种方式解决，1呢是内网穿透，2呢就是远程debug，因为招行的测试回调地址只能是ip所以这里我们就是要第二种方式，不熟悉远程debug的同学可以参考我的另一篇博文idea远程debug
   
   
   我们就拿支付成功的回调来说。
   招行会把参数放到一个jsonrequestdata的属性里。我们可以通过以下方式来取得：
   jsonobject jsonrequestdata=jsonobject.parseobject(request.getparameter("jsonrequestdata"));
   这个json里面的东西我们可以参考一下这个链接http://link.cmbchina.com/open2/api/payrltapi6.aspx
   有了这些东西我们就可以准确的知道此次支付的一些相关信息。
   
   不过呢，这样有个问题呀，这东西要是别人伪造的怎么办呀。所以呢，这里还一个验签的过程，验证此次回调到底是不是招行发来的。
   
   这个验签还牵扯到一个问题，那就是验签需要招行的公钥，而招行的公钥是会定期更新的，所以我们可以做一个定时任务定期去请求招行的公钥（关于定时任务的相关可以参考我的这篇博客：java定时任务解决方案）
   
   至于怎么去查询请参考此链接http://link.cmbchina.com/open2/api/queryapi3.aspx,使用我们上方所说的如何排序请求参数，如何进行签名。不过这个只需要在服务端请求就可以了，至于在服务端如何发送请求大家可以使用一下方式：

public static string dopost(string jsonparam, string url, string charset) {
       outputstreamwriter out = null;
       bufferedreader in = null;
       stringbuffer result = new stringbuffer();
       try {
           url httpurl = new url(url);
           httpurlconnection urlcon = (httpurlconnection) httpurl.openconnection();
           urlcon.setrequestmethod("post");
           urlcon.setrequestproperty("content-type", "application/x-www-form-urlencoded");
           urlcon.setdooutput(true);
           urlcon.setdoinput(true);
           urlcon.setreadtimeout(5 * 1000);
           out = new outputstreamwriter(urlcon.getoutputstream(), charset);
           out.write("jsonrequestdata=" + jsonparam);
           log.info("the request to cmb jsonrequestdata is :{}",jsonparam);
           out.flush();

           in = new bufferedreader(new inputstreamreader(urlcon.getinputstream(), charset));
           string str = null;
           while ((str = in.readline()) != null) {
               result.append(str);
           }

       } catch (malformedurlexception e) {
           e.printstacktrace();
       } catch (ioexception e) {
           e.printstacktrace();
       } finally {
           try {
               if (out != null) {
                   out.close();
               }
               if (in != null) {
                   in.close();
               }
           } catch (ioexception e) {
               e.printstacktrace();
           }
       }
       return result.tostring();
   }

既然公钥有了，我们就可以进行验签了。
具体验签细节可参看此链接:http://link.cmbchina.com/open2/api/appendix16.aspx。

如果验签通过的情况下我们就可以happy进行各种操作了。

不过呢，还有一点。记得给招行返回一个收到的信息
`
response.setstatus(httpstatus.sc_ok);

`
你要是不告诉人家你收到了，他是会在间隔一段时间后再次发送通知，直到10个以后。

7. 这个大流程终于走到这了，这个时候你是使用app轮训，或者向app推送告知支付完成的信息就是看你需求了。

结语

关于招行的支付功能是我上周刚刚亲手撸出来的代码，我想能踩的坑我基本上已经踩过了，如果大家在开发过程中遇到什么问题的话都可以来我的网站，我们一起交流讨论：

本文出自,转载请保留。