银行接口专题培训.ppt

银行接口专题培训,confidential 2009 isoftstone corporation. all rights reserved.,2,议程,银行接口概述,1,银行接口平台的介绍及实施,3,银行接口的功能介绍,4,银行接口的技术架构,2,confidential 2009 isoftstone corporation. all rights reserved.,3,银行接口概述,confidential 2009 isoftstone corporation. all rights reserved.,4,银行接口概念,银行接口也可以称之为”银企直联”、”银企互联” 所谓 “银企直联”，就是集团企业在集团内部建立自己的资金管理系统，并与商业银行共同开发内部资金管理系统及商业银行网银系统之间的数据接口，通过数据接口将企业内部的资金管理系统与商业银行网银系统实现联接，所以被称为“银企直联”。 银行接口为银行和企业之间架起了”桥梁”,主要作用实现企业业务系统同银行核心系统的数据交换。按照双方不同的数据格式进行数据转换。,confidential 2009 isoftstone corporation. all rights reserved.,5,银行接口的业务需求,功能扩展,资金集中 管理,资金利用率 资金风险 经营成本 .,客户需求 差异化,银企功能满足 全面资金需求,银企直联需求,个性化服务,高度集成,实时性,财务数据 银行数据,历史数据 管理,付款业务 收款业务,confidential 2009 isoftstone corporation. all rights reserved.,6,结总 问题与答疑,confidential 2009 isoftstone corporation. all rights reserved.,7,议程,银行接口概述,1,银行接口平台的介绍及实施,3,银行接口的功能介绍,4,银行接口的技术架构,2,confidential 2009 isoftstone corporation. all rights reserved.,8,银行接口技术架构,confidential 2009 isoftstone corporation. all rights reserved.,9,银行接口逻辑结构,confidential 2009 isoftstone corporation. all rights reserved.,10,银行接口技术实现模式-分层,总体来讲，银行接口定义为三个层次 第一层是api层，提供给外部使用系统调用的接口。银行提供的服务功能，业务数据对象都在此定义；该层屏蔽了各个银行之间的差异，使资金管理系统很容易的完成对多家银行的对接，减少了业务系统的开发难度 第二层是接口管理层，实现服务的管理、事件通知、自动任务管理，以及全局性的基础功能等等； 第三层是spi，定义了对银行接口的实现包的要求。该层主要负责将资金管理系统发出的请求封装为各商业银行规定的数据报文，并将请求报文发送到银行前置机指定端口上，等银行处理完毕后，接收从前置返回的银行响应信息并进行解析，传递给资金管理系统。,confidential 2009 isoftstone corporation. all rights reserved.,11,银行接口技术实现模式-分层,confidential 2009 isoftstone corporation. all rights reserved.,12,银行接口技术实现模式-分层,第二层是接口管理层，实现服务的管理、事件通知、自动任务管理，以及全局性的基础功能等,initialbankservice,bankservicemanager,configmanager,bankservice,configinfo,icbcbankservicefactory,abcbankservicefactory,xxxbankservicefactory,icbcbankservice,abcbankservice,xxxbankservice,bankservicefactory,icbc task、event,abc task、event,xxx task、event,confidential 2009 isoftstone corporation. all rights reserved.,13,银行接口技术实现模式-通讯方式,银行接口支持三种通讯方式 http通讯： 采用apache的公共包，由于工行对http的特殊要求，我们进行了特殊的修改，但是它兼容org的包，因此在其他系统使用http通讯的时候必须使用接口提供的包，否则在发送银行指令的时候会出现错。 中行、工行、民生、交行、北京银行 sock通讯： 农行、建行、招商银行、中信银行 ftp通讯： 境外银行的直联是主要通过ftp方式进行数据传输 渣打、花旗、荷兰、汇丰、中银香港 ,confidential 2009 isoftstone corporation. all rights reserved.,14,银行接口技术实现模式-特殊处理,银行接口支持三种数据格式 xml格式： 通过接口把传送的数据按照银行提供的接口文档定义，转化为各商业银行可以识别的xml报文格式，目前使用xml报文格式的银行有： 中行、工行、民生、北京银行、中信、招行、民生、光大、浦发 字符串格式： 按照银行文档中定义的每个字段长度进行字符串拼接，以确保银行可以正确的截取每一个字段信息，使用的银行有： 建行、华夏、深发展 xml+字符串格式： 农行、交行,confidential 2009 isoftstone corporation. all rights reserved.,15,银行接口技术实现模式-特殊处理,日志管理 当前银行接口日志不与任何外部接口程序关联，属于单独初始化，单独输出。接口的初始化调整为，首先读取配置文件bank_service_config.xml，然后初始化日志。 银行接口日志分两种，一种是log4j,另一种是system.out输出形式。在配置文件文件中可以指定日志的采用形式。 例如： com.iss.itreasury.bs.log.systemoutimpl 上述配置采用了systemoutimpl. 若没有配置，银行接口默认将采用log4j的形式输出日志。,confidential 2009 isoftstone corporation. all rights reserved.,16,银行接口技术实现模式-特殊处理,支付指令管理 发送支付指令的时候指令id必须唯一。在指令id文件中存放已经使用的最大的id信息，每次在内存中存放20个连续的id，用完以后自动追加20个在内存中同时在文件中更新。每次服务重起的时候自动加载文件中的id信息。 文件名称：package_id.dat 中间指令的处理方式： 属于中间指令的为：支付处理中、支付末知 对于处于中间状态的指令，系统会记录指令信息，然后再自动到银行去同步指令信息。对于超过48小时的指令不在同步指令状态。同步的时间计划为：2，5，15，30 6次，60 45次 文件名称：virement_instruction.dat,confidential 2009 isoftstone corporation. all rights reserved.,17,银行接口技术实现模式-特殊处理,银行返回code管理 成功、失败、未知、处理中、一段时间后置失败 以上状态，是根据银行返回的code进行判断。目前的对于银行返回的code信息将会在配置文件进行处理。 配置文件如下格式： 0 银行返回code 提交成功,等待银行处理 返回信息 3 通过返回信息翻译的处理状态 翻译后的指令状态字典： 1:成功、2:失败、3:处理中、4:未知 5.一段时间内为未知，超过设定时间，则设为失败,confidential 2009 isoftstone corporation. all rights reserved.,18,银行接口数据处理流程,开始,数据校验,数据组包,发送数据,接收数据,解析数据,构造结果对象,结束,参数异常,组包异常,传输异常,银行返回异常,confidential 2009 isoftstone corporation. all rights reserved.,19,数据发送及接收流程,银行,银行安全服务器,web server,主机系统,公网/专线,internet /ddn,https,https,企业端,企业安全服务器 （前置机）,银企互联系统 （bank interface ）,关系数据库,资金 管理系统,confidential 2009 isoftstone corporation. all rights reserved.,20,功能测试 功能测试是接口中最重要的环节，它直接影响到接口的可用情况和风险控制情况 功能测试注意点的 1、对于组包方式，是否符合银行需求的格式和内容 2、在传输过程中，请求包头传送的参数是否和银行要求的一致 3、银行文档中的必输项和非必输项以及字段的最大长度，都要进行测试 4、银行在正确情况下会返回什么样的状态码和描述信息 5、银行在出错情况下会返回什么样的状态码和描述信息 6、确定银行返回的错误代码和错误信息是否一致并且唯一 7、对于转账支付类功能，必须确定银行返回的code哪些表示支付成功? 哪些表示支付失败?哪些为支付中间状态,银行接口单元功能测试,confidential 2009 isoftstone corporation. all rights reserved.,21,银行接口发布,接口发布 提供bank_service_api.jar和bank_service_sp_xxx.jar(具体银行接口) 提供每一家银行各自的配置文件 提供支持接口包的第三方包，如： bs_httpclient.jar 、jakarta-oro-2.0.8.jar 提供接口整体配置文件： bank_service_config.xml，此配置可以根据每一家银行的特性进行设置 提供接口实施和发布文档,confidential 2009 isoftstone corporation. all rights reserved.,22,银行接口升级,由于银行系统升级，需要对银行接口同步进行升级 接口升级特点：向下兼容、并行使用、弃前用新 向下兼容型： 随着客户业务的增加，银行需要不断提供新的功能供企业使用但在提供直联的接口时，对于常用的功能也不会进行改造，只是在原有的接口功能中添加新的功能。 使用的银行： 农行、交行、浦发银行、北京银行、华夏银行、光大银行、民生银行、兴业银行。 升级方式： 对于向下兼容型的银行接口，升级时只需要更新银行接口api和接口实现两个jar包即可。,confidential 2009 isoftstone corporation. all rights reserved.,23,银行接口升级,并行使用型： 随着客户业务的增加，银行需要不断提供新的功能供企业使用。但由于银行的银企直联系统相当不稳定，银行考虑再三后，决定使用新的直联方式，新的报文格式。在新的接口文档中添加常用功能和新的功能。同时会保留原有接口使用模式，使两种接口类型并行运行。 使用的银行： 工行、建行、招商银行、中信银行、深发展银行 升级方式： 对于并行使用型的银行接口，升级时只需要更新银行接口api和接口实现两个jar包，可能不同银行还需要更新各自己银行的前置机软件程序，来达到配合新接口使用的目的。,confidential 2009 isoftstone corporation. all rights reserved.,24,银行接口升级,弃前用新型： 随着客户业务的增加，银行需要不断提供新的功能供企业使用。但由于银行的银企直联系统相当不稳定，银行考虑再三后，决定使用新的直联方式，新的报文格式。在新的接口文档中添加常用功能和新的功能。将不会保留原有接口使用模式，使直联接口只能在一种模式下运行，此种情况会造成所有使用到的对应银行的项目全部升级，且可能会影响业务系统改造 使用的银行： 中行 升级方式： 对于弃前用新型的银行接口，不仅需要升级api和接口实现包，可能还会涉及到业务系统的修改，以满足银行接口中的要素。相当于上线一家新接口,confidential 2009 isoftstone corporation. all rights reserved.,25,agenda,结总 问题与答疑,confidential 2009 isoftstone corporation. all rights reserved.,26,议程,银行接口概述,1,银行接口平台的介绍及实施,3,银行接口的功能介绍,4,银行接口的技术架构,2,confidential 2009 isoftstone corporation. all rights reserved.,27,银企平台的介绍及实施,confidential 2009 isoftstone corporation. all rights reserved.,28,银行接口平台整体架构,基础设置,基础层,运营层,分析层,工商银行,集 团 公 司 统 一 信 息 门 户,成员企业,业务人员,公司领导,账户管理,资金划拨管理,外部银行,核心系统,自动任务管理,银 企 接 口,日志管理,财务系统,业务系统,费用报销,支 付 管 理,交易管理,资金监控,统计分析,基础设置,基础层,日志管理,建设银行,中国银行,入账管理,confidential 2009 isoftstone corporation. all rights reserved.,29,基础层,日志管理,用户操作日志的管理 同银行进行数据交互的日志管理,基础设置,银行设置、客户设置、币种设置、关联设置、账户属性设置,confidential 2009 isoftstone corporation. all rights reserved.,30,银行接口平台整体架构,基础设置,基础层,运营层,分析层,工商银行,集 团 公 司 统 一 信 息 门 户,成员企业,业务人员,公司领导,账户管理,资金划拨管理,外部银行,核心系统,自动任务管理,银 企 接 口,日志管理,财务系统,业务系统,费用报销,支 付 管 理,交易管理,资金监控,统计分析,建设银行,中国银行,入账管理,confidential 2009 isoftstone corporation. all rights reserved.,31,账户管理,完成对银行账户的管理。账户是接口进行数据传递的核心。 开户、销户、冻结、解冻、限额 账户体系的建立 账户信息查询（余额、交易） 直联查询、本地查询,confidential 2009 isoftstone corporation. all rights reserved.,32,自动任务管理,为了减少客户操作的复杂性，接口平台启动多种后台任务来完成数据的交互。为了减少对银行系统的多次交互增加银行系统的压力，定期将数据导入到接口平台，供客户使用。 当日数据导入 历史数据核对 自动入账 指令状态的更新,confidential 2009 isoftstone corporation. all rights reserved.,33,资金划拨管理,划拨管理主要实现对账户归集下拨的规则设置，可以设置划拨账户的各种隶属关系、划拨规则。实现根据不同的时间设定和金额设定进行资金划拨。,confidential 2009 isoftstone corporation. all rights reserved.,2008 isoftstone holdings ltd. all rights reserved.,2008 isoftstone holdings ltd. all rights reserved.,多种账户归集模式,三 级 单 位,二 级 单 位,一 级 单 位,集 团,主要收入户,其他收入户,其他收入户,收支户,主要收入户,其他收入户,主要收入户,其他收入户,其他收入户,主要收入户,其他收入户,其他收入户,主要收入户,其他收入户,其他收入户,逐级归集,垂直归集,跨级归集,主要收入户,其他收入户,其他收入户,主要收入户,其他收入户,其他收入户,主要收入户,其他收入户,其他收入户,收支户,主要收入户,其他收入户,confidential 2009 isoftstone corporation. all rights reserved.,35,交易管理,交易管理主要是针对从银行接收的数据进行管理。 对于是否自动入账的数据进行人工的确认，然后实现系统自动形成业务数据的功能。 对于银行返回信息不全的情况，可以进行信息补录。,confidential 2009 isoftstone corporation. all rights reserved.,36,支付管理,支付管理的主要功能是借助银行接口提供的汇兑功能为企业提 供丰富的支付业务。 普通支付 先拨后支 代理汇兑 对私业务,实现同业务系统的对接并且从业务系统接收支付数据。,confidential 2009 isoftstone corporation. all rights reserved.,37,银行指令管理,通过对指令的维护需要防范指令信息错误、指令重复发送、指令状态不明确等问题。,指令查询,指令维护,状态刷新,confidential 2009 isoftstone corporation. all rights reserved.,38,银行接口平台整体架构,基础设置,基础层,运营层,分析层,工商银行,集 团 公 司 统 一 信 息 门 户,成员企业,业务人员,公司领导,账户管理,资金划拨管理,外部银行,核心系统,自动任务管理,银 企 接 口,日志管理,财务系统,业务系统,费用报销,支 付 管 理,交易管理,资金监控,统计分析,建设银行,中国银行,入账管理,confidential 2009 isoftstone corporation. all rights reserved.,39,资金监控系统,多家商业银行接口,资金预警监控系统,规则设置,监控报告,统计分析,系统设置,商业银行1,商业银行2,商业银行3,公司领导,业务人员,财务人员,系统设置,监控规则设置,监控结果统计,预警处理,资金监控系统主要功能是防范资金风险、监控资金流量及存量，通过 在系统中设定相应的监控规则，以便用户对资金进行监控，并且能够 及时发现资金风险和漏洞。,confidential 2009 isoftstone corporation. all rights reserved.,40,统计分析,根据客户的要求，对银行数据进行多角度、多纬度分析。,账户每日余额表 账户日均余额表 账户日均余额变动表 客户每日余额汇总表 银行每日余额汇总表 ,confidential 2009 isoftstone corporation. all rights reserved.,41,银行接口平台特点,个性化服务,结合公司个性化资金管理需求进行客户化开发,如资金归集、下拨策略,高度集成,与公司内部erp系统实时集成,更全面更及时的反映资金业务信息,自动化处理,通过接口系统自动生成银行指令，自动对外支付 通过接口系统自动生成会计凭证，实现业务数据共享,统一管理,通过银行接口平台实现集团企业统一的信息系统管理，如权限管理等,confidential 2009 isoftstone corporation. all rights reserved.,42,银行接口平台的安全性,建立ssl/tls安全通信通道， 对通信数据进行加密传输,资金 安全 保证,提供银行接口前置，部署“银 企直联”服务多项安全措施,为每个用户颁发不同的ca证 书（身份认证）,对用户ca证书采用硬件加密 方式（usb电子钥匙）,用户操作需要数字签名，只有 签名成功才可以进行业务操作,采用权威认证机构的证书服务 （cfca认证),confidential 2009 isoftstone corporation. all rights reserved.,43,银行接口平台的作用与意义,实现对成员企业收款、付款，内部结算进行全方位控制，防范资金风险 能够实时、动态、准确监控集团所有资金的存量、流量和流向 对资金流向合法性、安全性和效益性进行审查，确保资金合理使用 实现企业零余额的管理，减少沉淀资金和贷款规模，节省财务费用 有效监控成员单位资金运作，通过对资金流动信息掌握财务经营状况,confidential 2009 isoftstone corporation. all rights reserved.,44,银行接口平台主要功能流程,页面录入,账户是否有效,组建银行报文,直接返回,发送银行,是,否,银行返回,解析返回 数据,查询账户数据,confidential 2009 isoftstone corporation. all rights reserved.,45,银行接口平台主要功能流程,录入交易,复核交易,此交易开户行的银行为有效的银行,生成银行指令,复核完成,发送指令,是,否,银行接口模块,结算模块,结算发起的转账,confidential 2009 isoftstone corporation. all rights reserved.,46,银行接口平台主要功能流程,资金上划,开始,循环处理每一成员 单位的银行账户,检验账户中是否存在 处理中或可疑的指令,到银行查询 账户的余额,判断余额,账号当前余额 减余额留存限额 是否小于单笔最 大金额且大于 单笔最小金额,生成银行转账 指令并发送,定时同步指令 的处理结果,循环处理 下一账户,任务结束,否,余额大于零,是,余额不大于零,否,是,confidential 2009 isoftstone corporation. all rights reserved.,47,银行接口平台主要功能流程,资金下拨,开始,根据下拨策略查询 需要下拨的账户,到银行查询 账户的余额,下拨金额大于该 账户对应该的 内部户的余额,生成银行转账 指令并发送,定时同步指令 的处理结果,循环处理 下一账户,任务结束,否,是,confidential 2009 isoftstone corporation. all rights reserved.,48,银行接口平台主要功能流程,查询银行交易,财务公司接收交易后保存,自动任务判断是否需要入账,发送结算入账,接收到入账交易信息,终止,保存活期交易,是,否,银行接口系统,复核活期交易,结算系统,通知入账,返回结果,查询银行返回交易,查询入账活期交易,通知入账的业务流程,confidential 2009 isoftstone corporation. all rights reserved.,49,银行接口平台实施流程,银行账户维护 账号信息 账号上下级关系 与内部户间对应关系,配置文件整理 perties bank_services_config.xml,自动任务设置 自动任务执行频率、时间设置,试运行 检查自动任务运行情况 检查指令发送情况,基础信息设置 币种、国家信息 开户行信息,定义资金划拨策略 划拨策略及启动时间定义 划拨关系定义,运行支持,confidential 2009 isoftstone corporation. all rights reserved.,50,银行接口平台常见问题处理,常见问题 指令状态失败，入账失败，入账重复，rmi问题 指令状态 系统内银行指令的状态为支付成功、支付失败、支付处理中和支付未知，这都是系统根据银行的返回代码翻译、解释过来的，并不是说银行会直接返回很明确的指令结果。,confidential 2009 isoftstone corporation. all rights reserved.,51,指令支付失败大概原因及处理办法,账户未授权 ： 这类错误的描述信息大致为：账户权限无效；检查签约关系错误；无效的业务标识等。 发现银行返回这类异常，基本就可以确定指令已经失败，并且需要及时联系该付款账号的开户行，完成账号的直连授权工作。 账户头寸不足 ： 在账户头寸不足时，银行一般会直接返回：账户余额不足；检查账户头寸，账户头寸不足等信息。 当银行返回账户头寸不足类的信息时，应立即使用”直接去银行查询”的功能，检查该付款账号的余额是否小于指令的付款金额。 对方（收款方）账户信息异常 ： 这类错误的描述信息大致为：账户名与账户名称不符；对方账户不存在；收方账号不允许通兑；对方账户非活期户等。 发现银行返回这类异常，就需要联系收款方确认收方账号信息是否正确。,confidential 2009 isoftstone corporation. all rights reserved.,52,入账失败原因及处理办法,与结算开机时间不符 ： 结算的开机日在该笔交易发生时间之前。如：交易时间为08年12月2日，结算开机日是08年12月1日，这样的交易将无法入账 结算系统处于关机或关机处理中状态 ： 在入账时发现结算系统正在关机或处于关机状态，系统自动不入账 内部户余额不足 ： 主要是针对于下拨的交易 处理办法： 如果发现入账失败的交易，在确认客户业务人员没进行有手工补录的情况下，可以 “重新入账”功能进行重新入账处理,confidential 2009 isoftstone corporation. all rights reserved.,53,rmi问题原因及处理办法,原因 监控模块与结算模块间的通讯，是靠rmi服务来实现的。在实施过程中可能偶尔会遇到rmi服务启动不正常的情况 查询步骤 检查配置文件 ：rmi服务的配置，涉及到3个配置文件，integration.xml、settlement.xml和perties，需要确认这3个配置文件中rmi服务的ip和端口都一致 检查配置文件中所用的rmi端口是否已经被占用 如果配置的ip地址为，需要确保在操作系统的hosts文件中已经对的ip做了映射；hosts文件路径为：/etc/hosts 检查bp_integration.jar包是否正确 检查sett_integration.jar包是否正确 处理办法 经过排查上述步骤，当发现有问题时，修改配置文件或替换jar包以后都需要重启服务器，在重启过程中要注意启动日志，查看日志信息中是否还有报错提示。,confidential 2009 isoftstone corporation. all rights reserved.,54,agenda,结总 问题与答疑,confidential 2009 isoftstone corporation. all rights reserved.,55,议程,银行接口概述,1,银行接口平台的介绍及实施,3,银行接口的功能介绍,4,银行接口的技术架构,2,confidential 2009 isoftstone corporation. all rights reserved.,56,银行接口的功能介绍,confidential 2009 isoftstone corporation. all rights reserved.,57,银行接口功能说明,普通功能为： 账户当前余额查询 账户历史余额查询 账户当日交易明细查询 账户历史交易明细查询 普通转账 转账指令状态查询,confidential 2009 isoftstone corporation. all rights reserved.,58,银行接口功能说明,特殊功能： 代理汇兑 (实名付款) 当成员企业不具备在银行开户条件，则在银行没有结算账户，发生业务后需要使用财务公司的账户对外付款，但是客户需要将真实的付款信息体现在对方单位的进帐单中。银行为了适应这种业务提供了这个功能。付款的时候提供两个账户的信息，一个是真实付款账户（内部户）一个是代理付款账户（真实存在的银行账户）。收方单位看到的进帐单中的付款信息为内部账户的信息。 实现的银行有：工行、建行、农行、交行 对私支付 主要是员工工资、个人报销、保险赔款。不同的银行采用的功能也各不相同。 实现的银行有：工行、建行、招行、交行、中行 统一对外支付 需要集团公司和成员公司同时在银行开户，付款时，提供同时提供两个账户，由银行内部处