兴业银行银企直联对接记录及SDK

年前因为业务需要，接触了兴业银行的银企直联，因为感兴趣，所以大致搜了下国内一些银行，发现目前银行银企直联模式新接入的用户都只有前置代理机这一途径，所以兴业银行也不例外。

可在此处查看兴业银行的接口文档，该处包含了V4.0.0和V4.0.4版本两份文档。至于前置机安装以及证书之类的，此处就不提供了，如果你有接入的业务需要，兴业银行的相关工作人员会提供相关资料，如下图。

一般而言，你按照《兴业银行银企直联代理软件升级手册.docx》说明一步步安装就行了，但测试用的软证书部分需注意一点，必须在安装完所有软件后才进行证书导入，否则会在启动代理机监控时提示未能找到证书。然后不管是正式还是测试环境，均需要向兴业银行申请将前置代理机对外请求时的IP添加进白名单，只有白名单内的IP地址发出的请求，兴业银行服务端才会接受，所以此处如果有条件，还是建议对外IP固定（如果是通过代理上网也一样的道理），否则一旦你路由器重启之类的导致IP发生了变化，再通过兴业银行重新添加白名单可是要时间的，测试环境的话是固定每周三添加，正式环境不清楚，但想来也不可能很快。前置代理机本身也有个白名单设置，该设置是用于配置哪些请求来源可以进行访问，而这些请求来源才是你真正的业务程序，如下图。

对于企业而言，一般来说，均只需银企直联的支付（对公、对私、行内、行外）功能，我们也不例外，然后这里就牵扯出了一些国家金融监控风险上的问题。就企业账号而言，分基本账户和一般账户，基本账户是每个企业只能有一个，一般账户则可以有多个。因为银企直联并不像网银那样，会经过国家金融监控，所以受国家政策影响，银企直联进行对私支付可能会存在金融风险。当然这风险也与企业账户类型及银行所在地有关，通过基本账户进行支付的话，不存在金融风险；一般账户的话，则与银行所在地有关，上海、北京之类的一线城市国家放开了政策，允许一般账户进行支付，其它地方则任然受政策影响。

兴业银行前置代理机会记录所有的请求与响应内容，所以本质上讲，请求程序无需特意记录每次的请求与响应内容。还有请不要测试账号密码错误的情况，因为如果错了N次之后，该账号就会被永久封停！！！你只能通过兴业银行的相关人员重新申请一个新的账号。

兴业银行的支付一般来讲，只需要通过 3.4 企业财务室 下的 3.4.1 转账汇款 接口即可。当然3.7 集团服务 下的 3.7.1 集团支付 也可以进行支付，但按3.7.1的说明，其只可以进行对公转账（实际测试时发现也可以对私转账）。需注意的是，支付时会有付款费率问题，不同地区的费率不同，支付接口只会返回该笔请求的支付情况，当支付成功时，其对应的手续费是不会在响应中进行体现，所以只能通过 3.4.2 查询转账交易状态 来确定对应的手续费，如果支付时实时响应支付结果为PAYOUT，那么你可以立刻调用3.4.2接口进行流水查询，否则的话，你需要通过其它途径（比如定时、或者人工触发）来进行流水查询。
2019-03-18补充
3.4.2 查询转账交易状态按兴业银行相关人员回复并不能获取手续费，手续费只能通过3.3.6账户余额和交易流水分页查询来获取，手续费一般来说是和对应流水紧联在一起的，那3.4.2 查询转账交易状态这个接口存在还有何意义？尤其还返回了一个集合数据！！！
2019-04-11补充
3.4.2 查询转账交易状态还是有必要，如果通过3.4.1转账汇款指令提交进行查询，因为TRNUID不唯一的话，就会进行支付，所以为了避免误支付，还是用3.4.2 查询转账交易状态进行状态查询比较靠谱。
2019-05-16补充
兴业银行的3.4.1转账汇款指令提交支付是可以支付到信用卡的，不需要调用其它接口。

一般情况下，企业是不会允许当业务程序发起支付请求时，银行就立刻将资金转账到对应目标账户，正常流程是先发送支付请求到网银，然后再由对应的审核人员在网银端确认无误后才进行支付，也就是上图中“网银审核”那块需要在前置代理机上进行勾选。但这时又会牵扯出一个问题，就是银企直联支付的账号，如果该账号对应的转账流程为一级模式，那么不管你是否勾选了“网银审核”，支付请求均会被立刻执行PAYOUT，而不是AUDITING，只有当账号对应的转账流程为二级模式时，才会响应AUDITING，即等待网银审核。账号对应的转账流程为几级模式这需要由兴业银行的人员确认，测试环境的网银审核是不公开给用户的，如果需要测试该流程，需要兴业银行的人员帮忙进行审核。

一般情况下，我们转账都不会设置转账日期，如果输入了DTDUE转账执行日期，那么网银审批需在此日期（含当日）之前进行审核，如果未能在该日期结束之前审批，那么该笔支付状态会被转为EXPIRED，即指令过期，此时你需要重新发起一笔支付请求。

上面都是支付相关的一些注意点，为了方便接入，所以个人还封装了兴业银行银企直联的SDK，该项目开源在Github上，支持NET4.5.2及NETStandard 2.0，该项目依赖第三方类库RestSharp，具体项目地址见此处，你也可以在此处的README查看目前SDK都已经封装了哪些接口。默认请求时SONRQ会设置为密码加密，该部分已参考兴业银行提供的cibFoxDesUtil.jar，按同样的逻辑封装了NET版本，然后该类的构造函数中，encoding参数用于解决可能存在的服务端与客户端默认语言环境不一致的问题，默认为null，代表使用当前系统语言编码方式，即与java一致，采用System.Text.Encoding.Default。使用例子可见此处代码。对于某些支付请求不能实时响应的问题，可以通过另一个开源项目LongIntervalRetries来处理定时调用的问题。

最后由于测试账号权限限制问题，目前完全测试过的只有3.3 账户查询, 3.4 企业财务室、3.6 虚拟子账户、 3.7 集团服务，所以如果你在使用中发现SDK错误，你可以在Github上建立Issue，或者在此处留言。

兴业银行银企直联对接记录及SDK相关推荐

兴业银行银企直联冲账查询及网银审核退回经办
之前写过兴业银行银企直联应当如何查询手续费及退票,但事实上兴业银行还会产生冲账问题.所谓冲账,就是指支付信息错误,导致根本无法到达实际收款银行,这时候因为根本无法到达收款银行,所以也就不会有收款银行回 ...
兴业银行银企直联如何判断支付结果是否成功
说实在的,写这篇博客完全是意料之外,毕竟封装SDK后,银行支付理论上讲就仅仅只是简单的调用加判断,但应用实际上生产后,居然发现支付失败会有多种原因,而不同的错误,其后续处理逻辑也不一样,所以这篇博客内 ...
兴业银行银企直联客户端
兴业银行银企直联客户端是一款企业网上银行,并也是一种新的网上银行系统与企业的财务软件系统在线直接联接的接入方式,也就是说客户可以通过通用浏览器(如微软的IE浏览器)方式来进行直接接入,以此快速的来获取 ...
兴业银行银企直联查转账手续费和退票流水（C#代码篇）
前几天写了在兴业银行的银企直联中,如何查询手续费和退票流水,但没有完整的代码展示,所以这里再完整的提供下查询相关的代码.封装代码不涉及任何外部业务,如果你也正在接入兴业银行,且使用的开发语言是NET, ...
招商银行银企直联开发点滴记录
1. 概述最近工作中用到了招商银行的银企直联系统,作为资金支出渠道.招行系统提供两种方式与企业财务系统对接:一种是前置机式:一种是嵌入式.而"嵌入式直联方式仅作向下兼容支持,新增客户请使用 ...
超融合环境，虚拟化环境使用首驰兴华USB服务器实现银企直联，首驰兴华USBserver
银企直联系统是当前最新的企业级银行业务实现方式,通过互联网或专线连接使企业的财务系统与银行综合业务系统实现对接,企业无需专门登录网上银行,就可以利用自身财务系统自主完成对其银行账户包括分(子)公司银行 ...
SAP银企直联解决方案
SAP 银企直联是一种新的网上银行系统与企业SAP 软件系统在线直接联接的接入方式,改进了传统会计中'银行存款'的核算. 一.传统会计中'银行存款'的核算及特点在传统会计核算系统中,企业会计人员主要 ...
网银和银企直联的区别
1.1网银网银,简单地讲,就是银行在互联网上开展的各种业务,也就是银行客户利用个人计算机通过Internet获得银行的各项服务,银行利用专用的服务器提供各项在线服务.对银行,这种高效.全天候的服务能 ...
网易七鱼客服对接记录以及Vue项目里使用
网易七鱼客服对接记录之前是腾讯客服,因为业务关系,变更到七鱼,所以在这里记录一下 1.第一步去http://help.qiyukf.com/官方注册一个账号 2第二步找到自己需要的业务,我的是现 ...

兴业银行银企直联对接记录及SDK

兴业银行银企直联对接记录及SDK相关推荐

最新文章

热门文章