网银适配器实施问题大全及解决方案

2023年12月16日发(作者：)

网银适配器实施问题大全及解决方案

.方案概述

通过网银适配器与银行系统之间的连接和数据交换，可实现XX转账、账户XX、余额同步等功能。但由于不同银行提供的接口格式、数据、连接方式各不相同，在实际交互过程中可能出现错误或异常情况。本文档总结了近年来一线实施现场常见的各类问题以及对应的解决方案，对实施过程有很高的参考和指导价值.

适用版本:NC所有版本

。银行接口问题

1、 银行接口更改

例：银行明细账下载请改用接口50４00１归集账户明细XX接口

检查504０0１接口是否已经开发过,参考《网银各银行功能说明—各银行支持现状》．如果已经有，则只需根据第五列(调用接口需要nｃ端和ｖb端满足的条件（&分开）)更改其调用条件即可。如果没有，请与开发沟通该需求.确定其合理性和工作量

2、XX出现英文错误

（1)XX 类似下载失败[ＣMPＢ。RｅturｎＭＸ：Type miXXａtch］

（２）XX 类似下载失败[ＣMEＮ.ｃｌsCＭＥN。RｅｔｒunYE:Objｅct ｖariａｂle or

with bｌｏcｋ vａriaｂlｅ noｔ sｅt］

上面两个问题,一般会在解析ＮＣ指令或解析银行返回报文、指令转换时出错。

前边部分ＣMEN。ｃlsＣMEＮ。RetｒｕｎYE，说明是哪个方法出错，RetrunＹＥ是指返回余额时出错.后面英文原因是，哪个必输字段为空造成；如果是在发送阶段出错，检查接收的ＮC指令；如果是返回银行时出错，检查银行返回的报文，对照银行文档,检查必输字段哪个为空。

也可能银行升级，报文变化造成的。如：ｍx明细,当没有XX信息返回时，以前可能没有dｅtail，现在返回带有detaiｌ标签,但里面内容为空，这样原先代码里的读取对应信息时,就会造成CInt或者对空字符串进行截取等操作出错

（3)

图1

Overflow或jXXa。ｌaｎg。ArrａｙInｄexＯuｔＯｆBｏundXXceｐtｉon: 51

说明是数组越界或者iｎｔ越界

问题一般会出现在，报文格式是以“｜” 等特殊格式分割来区分字段的银行。当银行返回的报文最后出现空值时,如， 01｜安徽省路港工程有限责任XX|caｓh｜工程款||｜｜，就会导致数组长度不够。解决方法，一是检查最后几位是那些字段(最有可能是附言或备注）,将里面的值不为空即可。二是交给开发来修改代码

（4)

图２

Xml不匹配，检查对应NＣ配置文件xmｌ，是否符合xmｌ格式，各个标签是否一一对应，XXdataXXXX/ｄata〉正确格式

〈dａｔａ/〉正确格式

XXdata/〉〈／dataXX错误格式

XXdａta〉错误格式

(5）

图3

直接去找银行,XX问题原因,即可解决

３、 XX哪个字段为空

如XX 下载失败[ＣＭEN．clsCＭEN.RｅｔｒuｎYE:［集团账号不能为空]

此类问题

（1） 首先检查前台补录页面集团账号输入框是否有值。

图4

（2） 其次检查对应NＣ配置文件xｍl里是否有集团账号的对应配置，并检查发送给网银的ＮC报文里,该字段是否有值，是否对应。显然单据上是14３２,而接收到的NＣ指令里jｔaｃｃｏunt=＂0000０367Ｔ".不对应。说明是配置文件的问题

XXｒow bulu="N" datatｙpｅ="0” defaulｔｓhｏwｎame＝”集团账号”

XXedｉtflag=＂N” iｔemｋey＝＂jtaccount" XXｎulｌｆｌag=”Ｙ” ｒesiｄ＝”” sｈowｏｒｄｅr="１4” souｒce＝"acｃounｔ_nｕm" srｃiteｍｋey="deｆ1＂〉〈/ｒｏｗ〉

检查该行srcitemkeｙ，知道ｊtａcｃount的值来自,单据编码为def1的输入框。所以，进入单据模板，查看集团账号输入框的编码是否为def1

（3） 检查发送银行的报文,对照银行文档，找到集团账号对应的编码,看里面是否有值,是否与NC前台的值对应

图５

注意，输入框和参照的区别,

4、XXXX文件未找到

VB配置对应第四行的文件路径

从日志中得到路径和文件名，检查路径是否全路径。如C:/proｇｒａm filｅｓ/，并且是否和银行下载的路径是否设置一致（此路径一般是和银行约定的），可以根据文件名本地搜索一下,设置到配置里

JXXa 不用写全路径

5、XXUＰＰ3６120211－00002２

图6

ＵPP36１20211-０00022此类问题,可能是ＮＣ配置文件的报文头有问题, ｂａｎｋ为空造成的

如XX？xml verｓioｎ=”1.0＂ ｅNCodinｇ＝”GB2312＂?XX

XXdata ｂａnk=＂bccb” bulu＝”N" fｏrmulａ1=＂NＣ。vｏ。ｏbｍ。fｏrmulａ。FormulaPａrｓer" fuNＣ＝"ｙｅ” roottaｇ＝＂inpuｔ＂ tyｐｅ="”〉

另外,可能是ｂankｔｙpe．xml里面没有配置相应的银行

上面两个都没有问题，则是NC连接配置错误。连接体没有设置正确，

其中,编号是对应银行账户模板里的编号。如cｍｐ接口对应的编号是00０3１

6、GeｔToken:路径／文件访问错误

图７

ＮC先发送一个报文给网银，网银返回一个字符串,ＮC将其加到头，再发送给网银

原因:

（１）NC和网银版本对不上

（2）测试时是在网页上测试的,并非从NC来测试

（3)银行升级造成

XX

7、XX账号对应的商户无权限

账号不对,可以先在VBCｏnｆｉg的配置程序里输入该账号测试,直接与银行沟通

8、连接失败

首先确保银行前置机和网银适配器已经启动

XX当前方法所用的是jXXａ还是VB版本(参考标题一(２)）

图8

ＪXXA和ＶB的银行连接配置不在一个地方

VB：UBＡＮKcｏnｆｉg。ｅxe里

图9

ＪXXA:登录网银的网页（安装网银的机器上）,

用户名口令，默认都为adｍiｎ。点击配置树节点,更改里面的ｉp和端口

图10

注：IP地址是银行前置机的ip,并非银行服务器端的ip

端口号是银行提供的监控端口，不是网银自己的端口,也不是银行服务端的端口和前置机端口，否则汇报下面的错误

银行前置机未启动，或端口设置不正确

端口设置错误，设置成网银的接口８101造成

９、报“前置流水号不存在”，或者支付成功，且已经生成zf日志,但XX报错

图1１

原因是，

（1)检查对应的支付或者代发代XX是否成功，是否生成日志，如果此条业务没有成功,XX时是查不到的

（2）检查支付时的交易流水号，和XX时的交易流水号是否一样,对比如dｆｄk．ｘml和dｆｄkcｘ。ｘｍｌ的nｅwｐａｃｋagｅid行,检查ＮＣ对应的配置文件里是否有截取操作类似ｅxｅcfoｒmula＝＂ｔｒimByLｅn（ｎewpacｋａｇeid，12）",最好咨询银行，哪个流水号的截取位数是正确的，然后修改保持两者的位数相同，重启NC

10、没有生成日志，报解析包出错，可能是证书错误和编码格式错误

（1)ＣA问题

(2)有可能ＮＣ没有设置安全认证,但在网页配置ｊXXa页面里有,将ip控制和安全认证去掉

（3)检查ＮC指令里是否有特殊符号,如备注里是否有％,影响xmｌ结构

（4）查看NC日志,对应的里面是否有验签失败,如果有，则联系cａ厂商协助帮助一下

(５）XX日志分析器里的日志,检查网银适配器接收的NC指令和返回给NC的签名数据

看是在哪一步出错

图12

11、VBXX文件未找到： ＮVCＰApi.ＤLL或后台

如出现：

（１）XX。jaｃoｂ．XX。CoilEｘcepｔion: Can＇t ｇｅt obｊｅｃｔ cｌｓｉd fｒｏｍ proｇid

银行ｃmｐb对应的插件类cmｐｂ．cｌscｍｐｂ创建失败，请检查该类是否正确。Number:42９ActｉvｅX XXXXneｎｔ can’t crｅaｔｅ object

（2）文件未找到: NVCPApｉ。DＬL

（３）返回“插件无法创建”错误框

原因：DＬL文件未XX

解决:请重新反XXXXＤLＬ文件

12、VB后台XX参数不正确,银行服务器或操作员有一个为空,或端口号不是合法的数字值

检查ＵFbaｎkCｏｎｆｉg。ｘｍl文件里，对应的银行配置,是否正确,看看里面的配置是否缺少或被注释掉

13、如何知道一笔支付业务,在银行到底有没有转账成功?

首先,我们应该明确:NC系统目前XX的转账成功，并不是真正意义上银行的转账业务处理成功，而是指转账指令提交到银行成功,也就仅仅是指银行成功收到转账指令而已，并不代表银行已经进行了实际的转账业务。要想知道一笔款项是否真正转账成功，需要查看

该条转账记录的实际指令状态(需要利用到指令状态下载）,对于指令状态下载,目前NC系统只提供了工行普通版、建行重客、XX银行的指令状态下载，并且是在NCV３１SP3和NＣＶ3５中，其他版本的NC系统和其他银行如果需要明确一笔款项是否真正转账成功，只能通过对账单下载的功能来实现.

14、为什么我在网银补录的时候，如果账户名称超过了20位就会被截断?

目前系统中网银补录界面账户名称默认支持2０位，可以通过修改ｐａy．xｍｌ扩大账户名称的位数，具体参阅前面的NＣ网银配置文件功能说明。

１5、为什么有些银行对账单下载时,没有余额信息或者其他相关信息?

国内15家银行的银企直联系统返回的对账单信息不完全一样的,这些没有的信息并不是NＣ系统没有显示出来,而是银行就没有返回相关的数据。遇到这类型问题的时候，可以先查看ＵＦBＡＮK中的LOG日志,看银行返回的ＸMＬ数据中是否有相关返回数据，如果银行返回的ＸML数据包中都没有这些数据,那说明银行根本就没有把这些信息返回．

。通讯问题：

1、 对账单下载，适配器报文正常返回有记录，但是ＮC显示无记录的问题？

确认适配器返回报文中币种转换是否正确,交易日期是否在XX期间范围内．

币种转换配置文件（currencymapping．ｘｍl)是否有配置,ＮC５系列配置如下

XX：resｏuｒces＼ebank＼systeｍsjｙｈ

NC6系列如下：

２、NC传适配器报文，中文乱码的问题？

ＮC５系列的话,字符编码应该为ＧBK。修改文件:Ｃ：＼UＦＢank＼VB＼encode。ｐrｏpertｉeｓ

3、 上收下拨单走不到jtｇｊ接口，而走了zf接口的问题？委托付款单调用不到XX支付接口也是通用的道理。

修改ｂａnｋｔｙpe。xml文件相应银行的配置，将jtgｊ=”N＂，改成jｔgj=＂Y”

修改ｂａnｋｔype．xmｌ文件相应银行的配置，将dlzf="N”,改成ｄlｚf＝"Y”

文件XX:ｈｏｍe５7resoｕrｃes＼ebanksｙstｅmbankｔｙpｅ。xml

4、 下载对账单超时的问题?

修改NC基础设置-〉网上银行适配器设置,超时时间改大一些，单位秒。

5、 银行通信报URＬ50０的问题?

两种可能行,先检查银行通信的IP和端口配置是否正确

另外看看是不是NＣ启用了CA，而适配器没有启用.

6、 为什么支付时，银行返回的状态为失败，而NC单据上却显示为不明？

这个是基于安全考虑，防止银行返回的状态不对，而导致客户二次支付，在NＣ端，支付状态为失败的都转换为不明了.需要用户去下载支付状态，或是走支付确认单线下判定此笔交易是否成功.如果客户想改动,存在安全隐患,需要签署下面的协议：

７、如何判定网银接口是走ＪXXＡ版还是走ＶB版?

在C:UFBａnkｗebaｐpsuｆbankXX下找到VBInteXXｃｅ.xmｌ这个配置文件,在配置文件里定义的银行接口都是走VＢ版的，否则就是JXXA版的.

８、VB版网银接口配置文件在哪里？

在网银适配器安装XXC：＼UFＢanｋVＢ下，启动UＦBａnkCｏnfig．exｅ文件,弹出的界面可已设定各银行的通信参数。

9、JXXA版网银接口配置文件在哪里?

启动网银适配器,通过网页登陆以后,在系统菜单—XX监控端口设置，选择相应银行后，点击参数设定即可。

10、网银适配器各银行配置文件都包含哪些内容,如何配置？

配置文件包含了用户设置和通信设置两部分，用户设置一般会配置一下企业编码,登陆用户名和密码、或是其他特定信息。通讯设置包含了与银行通信的IＰ、XX端口、协议、访问路径等，有文件通信的话还有ｆtｐ的相关配置信息.配置信息一般是开发后会有一些默认值,但是正式测试的时候，需要跟银行索取相关配置信息,XX修改以后方可测试。

1１、VＢ版网银接口日志文件在哪里？

在C：ＵFBanｋ＼VBlogsXX下可找到相应时刻的日志

１2、JXXＡ版网银接口日志文件在哪里？

网银适配器安装菜单里有取日志的入口,进入画面后可XX并导出，导出格式为csｖ文件。

13、ＮＣ日志文件在哪里取?

在ＮＣＨOME的根XX找到ncｌoｇsｓｅrvｅr文件夹，一般日志会在nｃ—ｌｏg。lｏg这个文件里,6３以后的版本，网银日志单独输出在tXXｂm—这个文件里了。

14、问题判定时各日志的优先顺序以及解决问题的切入点?

首先解读单据画面的错误信息,如果不能准确定位问题点，首要去看的是网银适配器的日志,在这里可以通过错误XX知道问题是银行报出来的还是适配器发生的,XX如果明显XX是银行的错误就直接跟银行沟通,没有必要把问题提交给适配器的支持人员，因为他们最终还是要转银行，如果不清楚问题是哪里的,就把日志反馈给适配器的XX支持人员。如果适配器日志正常,或者没有适配器日志，就要去检查NＣ的日志，错误信息肯定在ＮＣ日志里。

15、NC的单据内容是如何XX给网银适配器的？

是通过配置文件将单据上的内容一一映射给适配器的各接口相应字段的，新开发一个网银接口的时候，开发人员一般会提供这个配置文件.文件存放在HCＨＯMＥ以下路径:ｒesourceｓ＼ebanｋ＼syｓteｍ＼sjyh(银行编码）.

１6、银行XX币种字段超长或者传值不正确该如何处理？

一般是适配器的币种格式没有转换成银行的格式造成的，检查NC配置文件里cｕrrｅncymapping．xml是否存在,其存放路径在ＨCＨOＭＥ以下路径:reｓoｕrｃｅs＼ebaｎksyｓtemsjyh(银行编码）,如果不存在就跟适配器支持人员要一下,或者自己配一下也可以。

17、ＮＣ5系列单据做代发代XX,XX不到支付指令状态单据该如何处理?

检查ncｈoｍｅｒｅｓoｕrｃeｓｅｂａnksystem＼sjyｈ（银行编码)XX下的ＮC配置文件dfdk。xml里,有没有配置【希望日期】这个字段，如果没有可参照别的银行或者找支持人员加上即可．

18、如何解决超时的问题?

超时的原因很多,有可能是NC跟网银适配器通信超时,也有可能是网银适配器跟银行通信超时,还有可能是银行自己处理超时.如果是NC通信超时,超时时间可在NＣ的银企直联模块网银适配器设置节点配置。如果是适配器跟银行通信超时，可检查一下网银适配器服务器的超时设置,JXXＡ版的话就检查Tｏmｃat的超时设置，VB版的话就检查IＩS的超时设置,一般默认值６０秒就可以了。如果上面配置都正常的话，可能是因为数据量过大或者服务器负荷过大造成的。可适当减少数据或稍后再试.

1９、如果截取toｍcａt(网银适配器)日志?

启动用友中间件之后，在电脑下方的开启程序里，可以看到有个程序名字叫”ｔｏmｃat＂.截取日志步骤:右键tomcat上方窗口－编辑-标记-通过拖拽鼠标，选取日志-然后右键ｔｏmｃat上方窗口—编辑-复制—打开新的tｘt文件—粘贴.或者直接将tｏmcａｔ的dos屏幕截屏也可以。

。环境问题

1、 ＭｙsXXl连接数超出或超时

2、 出现平台频繁掉线

原因:可能是网银或银行的IP采用动态方式,IP动态更改，导致连接不上。

解决:联系员,将IP固定

3、 超时的问题

超时的原因很多,有可能是NC跟网银适配器通信超时,也有可能是网银适配器跟银行通信超时，还有可能是银行自己处理超时。如果是ＮＣ通信超时,超时时间可在NC的银企直联模块网银适配器设置节点配置.如果是适配器跟银行通信超时，可检查一下网银适配器服务器的超时设置，ＪXXA版的话就检查Tomｃaｔ的超时设置，VB版的话就检查ＩIS的超时设置,一般默认值60秒就可以了。如果上面配置都正常的话,可能是因为数据量过大或者服务器负荷过大造成的.可适当减少数据或稍后再试。

4、 NＣ与网银适配器之间，突然出现通信不通的状况是什么原因？

通信不通可能有多种原因，从客户的描述来看可能是NC、网银适配器两台机器之间存在网络通信故障。您可以通过NＣ机器pinｇ网银适配器地址,若不通则为网络故障,您可以联系员解决。若能够ｐｉng通,您可以从NＣ的机器访问网银适配器的IIS主页，若发现不通,可能是ＩIS服务器出现远程访问故障;若通，则可能是您的网银适配器安装有问题,请联系维护人员解决。

5、 客户目前使用的银行比较多,UFBAＮK网银适配器经常出现当机的现象，请问这个问题如何解决?

目前，一套ＮC系统只能使用一个ＵFBＡNK适配器,造成了并发的问题，目前还无法解决这个问题.网银产品已经计划下一步解决这个并发的问题，让一套NＣ可以使用多个UFＢＡNK网银适配器。目前该问题在NＣ５．0以上版本，已经解决。

。连接配置问题

一、 NC与网银的连接配置

1。 检查网络是否畅通

ＮＣ应用服务和网银适配器一般会安装在不同的机器上,所以要检查两台机器是否正常连通。在ＮＣ机器上和网银机器上,都要做测试。用pｉnｇ命令,根据返回信息，分析网络是否畅通。例如：NＣ所在机器IP为１0.7。3.11６，网银为10．７．3．117.

NＣ的机器上piｎg网银的IP，进行如下操作:点击“开始"-“运行”-“cmd”

图1

在弹出的命令XX符下输入：ping 1０。7.3。1１7 回车

如果网络连通,返回结果如下图所示:

图２

如果网络没有连通,则返回结果如下图：

图3

说明两台主机之间没有网络连接,请检查网线是否插好，或与您的人员联系,确保客户机(业务系统)与网银适配器所在的主机保持网络畅通。

同理,在网银适配器所在的机器上做同样的操作，测试连通情况.

2. 检查网银适配

请确保网银适配器已按照《网银适配器安装新手册》安装正确。并确保其环境和版本正确.安装网银的机器上,可以成功打开网银日志分析器并和登录网银的网页

连接地址：

（1）安装前请确认您的计算机HD（硬盘）剩余空间：至少200M

（２)确保环境正确：网银目前在32位系统上运行正常,64位暂时不支持

（３)确保版本匹配：n6.１及以上版本，只能装防重版

3． 检查NC端银行的简写

（１）银行的缩写为小写，且拼写正确。如果不正确,会报找不到银行的错误

(2)同一个银行,有可能有不同接口。如图建设银行,四种接口类型:建行外联－〉ｃcｂｎ、建行重客-〉ccb、建行重客ＤＯ８Ｆ系统—〉ｃcbic、建行ＣMＰ—XX ｃmpb，注意区别

4。检查NC的配置和NC配置文件

（1)检查NＣ的Ｄ：nchｏmｅｈｏmｅ63resoｕｒｃesebａｎksyｓteｍbanktyｐe．ｘml里要有对应银行的配置信息.

图４

(2）登录ＮC，打开”动态建模平台-基础数据—网银适配器模板设置”菜单,检查里面是否有该银行的模板信息信息

注：同一个银行，有可能有不同接口。如图建设银行，四种接口类型：建行外联、建行重客、建行重客ＤＯ8Ｆ系统、建行ＣMP 。其为不同接口,每个都需要配置,区别不同

图5

(3)对比前台的网银适配器模板里信息和ｂanktype.ｘml文件里一致

否则会报UＰP３６１2021１－000０2２，即找不到银行的错误信息

图6

XX图7

（4)ｂanｋｔｙpe.ｘmｌ文件里的一些信息也要配置正确。如果网银适配已经实现了某功能接口，对应项要设置为Y.如代发代XX已经实现，则dｆｄk=”Y”,否则设置为Ｎ.如果这里设置不正确，那么当你在前台对私付款时,便找不到dｆdk,就会走对公支付zf.导致网银适配器报错

（5)打开”XX管理—银企直联－网银适配器设置”菜单，进行连接配置，测试成功

图８

注：端口为8１01(网银适配器的默认端口)

a）当银行只有一个接口类型时,如XX。则只需设置一个IP,接口类型下拉框不可编

辑的,默认即可

XXb）当银行有多个接口类型时，如建设银行。存在四种接口类型,接口类型是可编辑的。

这里需要注意：ＩＰ要么全部配置，那么只配置一个

XX如果该银行四种类型接口，在不同机器上，即用不同网银上。则需要单独设置四个IP．一个也不可缺少，否则，没设置IP的接口，访问时会报UＰP3612021１—０00０２２

如果该银行四个类型接口，在同一机器上，即同一个网银上，则仅需要配置一个IP.

接口类型，随便选择一个即可。其他类型的接口，也会通过此ＩP连接访问.

当配置IP多于一个时，没设置IＰ的接口，访问时会报ＵPP３6120211—０000２2

XXｃ)如果存在多个银行在不同机器上，最好一个银行做一个主连接。子数据行银行接口类型里配置同一个银行的各个接口.如建设银行,上面主数据为jiaｎshｅ,银行接口类型为建行CＭP、建行外联等

图9

5．检查NC和网银适配端的加密、验签等是否一致

NC端和网银端都有四个选项:ＣＡ签名、ＣA签名校验、加密、解密。

NC端与网银对应关系

NC端 网银

操作 操作对象 操作 操作对象

CA签名 NC指令 CＡ签名 网银返回的报文

ＣA验签名 网银返回的报文 CA签名校验 NC指令

加密 NC指令 加密 网银返回的报文

解密 网银返回的报文 解密(发送指令） NC指令

NC和网银端要保持一致.如果ＮＣ设置了，网银必须对应解决设置，NC没有设置,网银也必须将对应选项的对勾去掉.保持一致,否则，系统便会XX报错

a）NC设置了签名，则NC指令经过签名后,到达网银端，网银需要验签名,否则网银无法读取正确的NC指令

ｂ)ＮC设置了加密，则ＮＣ指令经过加密后，到达网银端,网银需要解密，否则网银读取的ＮC指令是密文,如果不解密,可能无法解析

c)网银设置了签名,则网银转换银行报文经过签名后,到达NC,ＮＣ需要验签名，否则行报文无法解析

d)网银设置了加密，则网银转换银行报文经过加密后，到达NC,NC需要验签名,否则报文是密文,无法解析

（1） ＮC端的设置，是在ｏbｍconｆig。ｐｒoperｔies文件定义的。

路径：nchome＼home6３＼ｒｅsｏｕrceｓｅbａｎｋsｙsｔｅmｏbｍconfig．ｐｒoｐeｒties

测试环境：一般都为fａｌsｅ，签名实现类、签名实现类等都为空

证书环境:根据情况设置ｔｒuｅ，签名实现类、签名实现类等，由ＣA厂商来设置

图１0

(２）网银适配器端

首先XX当前银行所用的是ＪXXA还是VB版本，具体参考《XX银行的接口是VB还是JXXA》

JXXA和VB的银行连接配置不在一个地方

a) 该银行所有接口都采用JXXA:只需在ＪXXA端配置

b) 该银行所有接口都采用VB:只需在ＶＢ端配置

c) 该银行接口采用ＪXXＡ与ＶＢ混合使用：两端都需要配置

ＪXXA端

登陆,选择安全控制—XX安全认证

图11

VB端

打开UFｂａnkＶＢＵFＢaｎｋConfig。exe，切换到安全设置页签，点高级

图12

对应到ＶB的cｅrtlist。ｘml配置文件，Y为启用，N为不启用

ｕｓXXXX==〉安全认证启用(原先写死Y）

ｓigｎXX＝=XX签名”

vｅrifyXX==〉验签

encｒyｐt〈=＝〉加密＂

dｅｎｃrｙpt〈==XX解密”(原先写死Ｙ）

图１3

（3）将JXXＡ端和NC端的IＰ控制里的IP删除,设置为不采用ＩＰ控制。如果没有去掉,则会:出现“解析业务组的指令数据失败,可能是该数据不是有效的XML格式”,见问题2

６．安全认证

安全认证功能为可选项，通过第三方认证，实现来访计算机身份确认以及数据的加密，此处的设置,必须与业务系统安全设置一致。点击网银适配器系统左侧菜单的“安全控制"后，在右侧选择银行，点击“安全认证”选项。可以选择是否使用安全认证,确认使用后,可以选择签名、验签、加密和解密等类型。

在下方的安全认证厂商列表中,可以选择相应的厂商进行编辑和删除。点击“编辑”按钮，进入到下图页面，对该厂商的参数进行配置,选择“启用该厂商认证”表单,把该厂商设置为正在启用的状态。(注：正在启用的厂商有且仅有一个）点击“确定＂按钮后，保存并退出。

7。检查网银适配的编码

ＶＢ和JXXＡ都在Ｃ:UFBaｎk＼ＶBencｏde。ｐｒｏｐerties里控制，根据ＮC版本做相应修改。否则支付会报xｍｌ格式错误,不匹配

JXXA_VB。encode = UTF—8 ＮＣ6系列

ＪXXＡ_VB．ｅncoｄe = ＧBＫ NＣ5系列

8。检查NC和网银适配端配置常见错误

(1）连接失败,发送指令异常,没有可用的服务器

图14

a) 按上面步骤一一检查,看哪一步有问题。上面步骤对，一般不会连接失败

b) 检查银行账户－〉网银信息页签—XX网银接口类型,是否对应.如农行,分农行专网和农行公网.如果这里设置了

图15

（2） NＣ与网银已经连通，解析业务组的指令数据失败，可能是该数据不是有效的XMＬ格式

原因：JXXA端和ＮC端设置了IP控制

方法：如图11,图1２。将上面的IP控制页签里的IＰ删除，复选框里IP控制对勾去掉。

如果网页上的IP控制无法显示,请修改页面对应的配置也可以

路径：ＵFBａnｋweｂappsufbａｎｋ ＩPｃｏnfig。ｘｍl；UFBａｎkVＢ IPconfｉｇ.xml

方法：useIP设置为N

重启网银适配

图1６

（3） NC与网银已经连通，解包失败,接受到的数据格式错误

a) 按上面步骤一一检查,看哪一步有问题

b) 检查版本是否正确，NC6。1及以上，只能用防重版

c) 查看网银日志，检查是在哪一步出错.参照《网银实施步骤》

图17

（4） 网银页面的Ip控制和安全认证的复选框的对勾去掉时，保存不了

a） 检查对应的文件是否为只读，如果是,请去掉只读属性

b） 检查ip控制里的iｐ是否都已删除,如果未删除，即使去掉上面ip控制复选框的对勾，仍然不会保存

（5） 网网银时，点击保存按钮,页面老是刷新，并跳转到初始化

可能是ｉe版本的问题,请检查Interneｔ选项—》安全－》安全设置里,是否禁用了jXXa脚本。旧版网银只能在ｉｅ下运行.

二、网银与银行的连接配置

1． 检查网银适配是否安装正确

（１)ＩＰ检查

网银适配器和银行前置机一般会安装在同一台机器上， 所以连接IP，一般都填lｏcalｈost或１27．0.0．1。

以登陆成功为准

a) 无法显示页面

运行－cｍd，输入命令ping loｃalｈｏsｔ，检查输出是否为１2７。0。0.１.如果不是,请将ip6协议卸载，或者将１２７。０。０。１加到信任Iｐ;如果是，则说明是toｍcat安装的问题,tｏｍcat限制了以ip访问网银

b) 无法显示页面

检查C：＼ＷＩNＤOWＳ＼system3２＼ｄｒiｖｅrsetｃhｏsts文件 是否有＃1２7.0．0。1 loｃaｌhost,前面如果带有＃号，请将其删除

(2)端口检查

端口：银行提供的前置机监听端口

注：不要写成网银的８101，也不要写成银行服务端的端口

(3）根据当前银行接口的版本进行设置

首先XX当前银行所用的是JXXA还是ＶB版本,具体参考《XX银行的接口是VＢ还是ＪXXA》

JXXA和VＢ的银行连接配置不在一个地方

d) 该银行所有接口都采用JXXA：只需在JXXA端配置

e) 该银行所有接口都采用ＶＢ:只需在VB端配置

f) 该银行接口采用JXXA与ＶB混合使用：两端都需要配置

JXXA端

登陆,选择监控端设置

注意：这里的路径,一般为具体地址,但有个别银行为环境变量的名称，如建行CＭＰ

VB端

打开ＵＦbankVBUFBanｋＣｏnfig。exｅ，切换到业务参数设置页签

编码设置：

路径:UFｂａnkVBｅncode．ｐrｏpertieｓ

内容：JXXA_VB．ｅncode = ＵＴF—８(GBＫ）

2。 检查是否连通

(1)JXXA端：新版本的可以在网银页面上的测试；旧版本需要在NＣ里做测试，网银页面不好用。接口(VＢ或JXXA)，可以查看当前银行的接口使用VＢ或JXXA(仅限新版本)

(２）VB端:如图，点XX按钮来测试

3. 常见错误

１、 配置网银时，点击保存按钮,页面老是刷新，并跳转到初始化

可能是ie版本的问题，请检查Intｅrnet选项－》安全-》安全设置里，是否禁用了ｊXXａ脚本。旧版网银只能在ie下运行。

。证书问题

1、报错信息。ＳockeｔException： Ｃｏnnｅcｔiｏｎ ｒeset

现象：网银连不上银行前置机。

原因:证书错误，银行验证证书错误，会立刻关闭登陆sｏｃｋet，导致读取信息失败.

解决:与银行人员沟通，重新获取证书。

2、银行没有授权

测试环境不需要ｌｉcensｅ,但正是环境需要.

检查该银行的licｅｎse文件是否存在

如果采用自定义liceｎｓe:

打开D:＼ncｈoｍehomｅ63rｅｓourceｓｅｂａｎk＼system＼ｏbｍｌicensecｏnfig。pｒoｐerties配置文件

检查里面是否有对应配置。如defｌｉｃｅｎse1=hXXｃ，银行简写,与NC系统对应

3、返回“4０3 Fｏrbidｄeｎ＂错误

有些银行(如：工行推广版)的业务访问需要权限证书，在客户决定使用银行的业务是需要向银行申请权限证书,即银行提供的用户名和密码。“４０３ Fｏｒbｉdden"错误原因通常是用户没有访问权限，即客户没有权限证书或者使用不正确。

．具体银行特有问题

一、 建设银行

1、签到失败！银行返回错误，类似10000 TrａｃeＩＤ:［]

信息：１000０ TraceＩD：［1０4］，交易状态不确定］等带数字串的问题,去银行确认错误原因即可,和网银无关

2、建行重客系统,为什么系统连续提交第6笔支付业务的时候就非常慢，业务就无法再进行？

这是因为银行方面在银行系统上设置了相关并发的参数造成的，请联系银行方面的技术人员和集团网银相关人员进行解决。

3、建行重客和建行外联有哪些区别?

这两个网银产品都是建设银行推出的面对客户银企直联的网银接口，建行重客在NC的网银项目中应用得比较多,应用效果比较良好，但是需要客户额外付费;而建行外联在项目应用中问题比较多。

４、建行重客的网银系统，为什么对账单返回显示无效数据，但是看UFBＡＮK日志却显示有从银行返回的数据？

请确认在网银支付中的“简要”、“用途"等描述中没有英文状态下的各种标点符号等特殊字符。

二、 招商银行

6、 出现招行接入平台频繁掉线？

主要是银行服务器问题，如果用户是,而且还是ADSＬ拨号上网的,很可能出现这种情况,需要客户向招商银行索取HOＳT文件来，绑定服务器ＩP地址.

7、 招商银行的业务需要密码卡,为什么有密码卡不能正常执行业务请求

使用招行密码进行业务请求,需要开通权限，客户只能执行卡上权限允许的业务,出现这种情况有可能您没有开通相应的权限,请联系银行相关人员确认您是否开通权限。注意：招行的支付业务分为三种,直接支付、集团支付和内部转账,您需要和顾问咨询好您的业务模式属于哪种类型,确认所开通的权限能实现您的业务需要.

三、 工商银行

1、 工行普通版、工行推广版和工行专业版有哪些区别?

工行普通版是前些年工商银行推出的面对客户银企直联的网银接口，目前在NＣ网银的应用中应用效果比较良好；工行专业版是近年工商银行推出的新的银企直联的网银接口，用户比较少,ＮＣ项目中只有哈动股份在正式用这个网银接口.工行推广版是工商银行与07年８月开始推出的新的银企直连版本,合并了普通版与专业版接口，银行目前对新申请的客户,基本都提供的是推广版接口,只对普通版旧客户进行维护。