




已阅读5页,还剩58页未读, 继续免费阅读
版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领
文档简介
内部资料注意保密内部资料注意保密小额支付系统与商业银行接口方案版本号:V2.0中 国 人 民 银 行 科 技 司二五年十一月版本修改记录:版本号完成日期简单描述1120050520提交总行科技司作为向全国发布的第一个版本1220050610根据总行支付司业务需求变更008号文件,对接口业务范围进行相应的修改。同时根据MBFE的设计要求,制定了对连接API的使用新规范,同时增加了多进程并发处理示例(附录A4)。具体修改内容参见接口方案修改记录001文档。1220050727期间进行了一些修改,具体修改内容参见接口方案修改记录002、接口方案修改记录003、接口方案修改记录004文档1320050823期间根据测试中出现的问题,对接口文档进行了相应的修改,具体修改内容参见接口方案修改记录005、接口方案修改记录0061.420050901期间支付司对通存通兑,支票圈存,定期借贷记等业务规范做了最终确定,具体修改内容参见接口方案修改记录0071.520051030取消发送CMT920的功能;修改报头中报文参考号类型由 n 改为 x;启用报文头的来往帐标志目录1概述11.1目的11.2小额支付系统概述11.3商业银行与小额支付系统接口概述42接口分析52.1业务处理范围52.2运行时序图73物理连接说明93.1物理连接结构图93.2网络结构图103.3系统软件结构图113.4前置机系统配置124应用连接说明134.1应用连接结构图134.2接口处理模式134.3前置机与商业银行系统接口功能174.3.1发送功能174.3.2接收功能205接口双方需要完成的工作235.1小额支付系统开发单位需要完成的工作235.2商业银行需要完成的工作236API使用说明246.1连接API246.2断开连接API256.3发送API266.4接收API296.5接收确认API317接口报文说明338接口安全管理348.1用户管理348.2审计追踪348.3网络安全348.4报文权限控制348.5API使用安全管理349差错及故障处理369.1差错处理369.2故障处理36附件A 接口程序例程39A.1接口处理基本框架39A.2商业银行系统向支付系统发送信息41A.2.1交易控制流程41A.2.2 例子程序(C+语言)43A.3 商业银行系统接收支付系统信息45A.3.1交易控制流程45A.3.2 例子程序(C+语言)47 小额支付系统与商业银行接口方案1 概述1.1目标本方案的目标是描述小额支付系统与各商业银行、城市商业银行、办理人民币业务的外资银行、城市信用社、农村信用联社(以下统称为商业银行)行内综合业务系统、电子汇兑系统之间的接口规范、接口业务以及小额支付系统接口API函数的使用方法。商业银行可以依据小额支付系统业务需求书和本方案进行小额支付系统接口系统的设计。1.2小额支付系统概述中国现代化支付系统(以下简称支付系统)是为我国金融机构之间以及金融机构与人民银行、国库之间的支付业务提供最终资金清算的重要核心业务系统,也是各商业银行综合业务系统、电子汇兑系统资金清算的枢纽系统,还是我国金融市场的核心支持系统,是全社会资金流动的“大动脉”,对中国经济金融运行发挥了重要作用。中国现代化支付系统之大额支付系统自2002年10月8日在国家处理中心(以下简称NPC)、北京和武汉两个城市处理中心(以下简称CCPC)成功试运行以来,目前已建成的系统规模包括:一个NPC、32个CCPC(即4个直辖市、27个省会、首府城市和深圳市),正在按计划于2005年6月底前完成在全国的推广应用。大额支付系统通过商业银行前置系统(以下简称MBFE)与各商业银行直接参与者连接;实现了与中央银行会计集中核算系统(以下简称ABS)、中央银行国库业务处理系统(以下简称TBS)、外汇交易系统、中央债券综合业务系统、中国银联系统、城市商业银行汇票处理系统等的连接。小额支付系统是中国现代化支付系统的一个重要应用系统,主要处理中央银行及国库、国有独资商业银行、股份制商业银行、城乡信用社等金融机构以及其他特许非银行金融机构之间在规定金额以下的贷记支付业务、借记支付业务的支付与清算以及特定的信息服务。其建设目标是通过小额支付系统建设,为各银行、企事业单位、个人提供一个支持跨行小额贷记业务和借记业务的支付清算平台,支撑各种支付工具的应用,为社会提供低成本、大业务量的支付清算服务。同时,小额支付系统可以与经批准的清算组织对接,为其提供支付清算和信息转发服务,促进清算组织的健康发展,从而提高整个社会的金融服务水平。小额支付系统在系统结构上遵从于支付系统总体结构,系统设备与系统软件与大额支付系统基本一致,但应用上与大额支付系统相对独立,主要表现在以下几个方面:l 系统结构:小额支付系统将使用完全独立的中间件资源,即为小额支付系统配置专用的CICS REGION和MQ QManager;小额支付系统与大额支付系统共享数据库资源,通过数据库物理设计予以区分;NPC小额支付系统将运行在独立的应用服务器;CCPC小额支付系统则与大额支付系统共用应用服务器。l 应用系统:小额支付系统除与大额支付系统共享主机SAPS资源及行名行号等基础数据外,其业务处理模块、公共控制模块、系统管理模块等完全独立于现有的大额支付系统,即小额支付系统与大额支付系统应用彼此独立。l 业务操作:小额支付系统使用独立的业务操作界面,与大额支付系统彼此独立。l 接口函数:小额支付系统提供单独的一套API函数供直接参与者编写接口系统;小额支付系统接口系统可以共享现有的大额支付系统接口系统物理设备,也可以使用另一套独立的物理设备。1.3商业银行与小额支付系统接口概述小额支付系统MBFE介于商业银行行内系统与CCPC之间,完成商业银行跨行小额支付业务及信息业务在商业银行行内系统与CCPC之间的转发,以及小额支付业务数据和信息的加押与核押处理,同时提供小额支付业务及信息业务的管理和查询功能。商业银行通过调用小额支付系统提供的API函数,编写小额支付系统接口系统与MBFE连接,实现商业银行行内系统与支付系统的直接对接,这种商业银行接入支付系统的模式简称为直联模式。直联对接后,商业银行可以由商业银行行内系统直接发起与接收允许本行收发的小额支付业务以及信息业务。2 接口分析2.1 业务处理范围 小额支付系统接口处理的业务主要包括支付类批量包、信息类批量包、业务信息类报文、系统管理类报文等四类报文。具体报文清单如下表所示(报文格式及填写要求参见文档小额系统报文格式汇总):报文按序重排报文类型收、发编号报文名称报文编号支付类批量包报文发送1普通贷记业务包PKG0012贷记退汇业务包PKG0073定期贷记业务包PKG0054实时贷记业务包PKG0035普通借记业务包PKG0026定期借记业务包PKG0067实时借记业务包PKG0048实时贷记回执包PKG0089普通借记回执包PKG00910定期借记回执包PKG01011实时借记回执包PKG011接收1普通贷记业务包PKG0012贷记退汇业务包PKG0073定期贷记业务包PKG0054实时贷记业务包PKG0035普通借记业务包PKG0026定期借记业务包PKG0067实时借记业务包PKG0048实时贷记回执包PKG0089普通借记回执包PKG00910定期借记回执包PKG01011实时借记回执包PKG011信息类批量包报文发送1通用信息业务包(包括清算组织发起的代付信息、通用信息等)PKG0122实时信息业务包(包括客户账户查询、支票圈存等)PKG013接收1通用信息业务包(包括清算组织发起的代付信息、通用信息等)PKG0122实时信息业务包(包括客户账户查询、支票圈存等)PKG013业务信息类报文发送1查询报文CMT3012查复报文CMT3023小额业务撤销申请报文CMT3214小额业务退回申请报文CMT3195小额业务退回应答报文CMT3206自由格式报文CMT3037小额批量包处理状态通知报文CMT3168借记业务止付申请报文CMT3279借记业务止付应答报文CMT32810实时业务冲正申请报文CMT32311小额业务状态查询报文CMT519接收1查询报文CMT3012查复报文CMT3023小额业务撤销应答报文CMT3224小额业务退回申请报文CMT3195小额业务退回应答报文CMT3206自由格式报文CMT3037小额批量包处理确认通知报文CMT9208通用报文处理确认报文CMT9119小额批量包处理状态通知报文CMT31610借记业务止付申请报文CMT32711借记业务止付应答报文CMT32812实时业务冲正应答报文CMT32413实时业务冲正通知报文CMT32514小额业务状态查询应答报文CMT52015小额轧差净额清算通知报文CMT254管理信息类报文日终对帐发送1小额业务包明细核对申请报文CMT8502小额业务包明细核对下载申请报文CMT852接收1小额业务包汇总核对报文CMT8422小额业务包明细核对应答报文CMT851下载发送1小额业务包明细下载申请报文CMT8532小额业务状态补发申请报文CMT521接收1小额业务状态下发报文CMT522运行控制接收1业务权限控制通知报文CMT5032公共数据变更报文CMT5023贷记业务金额上限变更报文CMT5074下级节点变更通知报文CMT5045小额支付系统状态变更通知报文CMT5006系统停运通知报文CMT501额度控制发送1清算账户圈存资金管理报文CMT5102净借记控制额度管理报文CMT5123净借记控制可用额度预警管理报文CMT5144小额支付业务排队管理报文CMT517接收1清算账户圈存资金管理应答报文CMT5112净借记控制额度管理应答报文CMT5133净借记控制可用额度预警管理应答报文CMT5154净借记可用额度预警通知报文CMT5165小额支付业务排队管理应答报文CMT518计费接收1小额收费通知报文CMT5522小额对外返还通知报文CMT554 表1 CNAPS与商业银行小额接口业务处理范围一览表2.2 运行时序图小额支付系统实行724小时不间断运行,每日16:00进行日切处理,即前一日16:00至当日16:00为小额支付系统的一个工作日,具体日切时间由NPC根据运行管理需要灵活调整,但一般不得晚于大额支付系统业务截至时间。小额支付系统日切后,立即进入日间处理阶段,正常受理与转发小额业务包及各类报文,并进行上日已清算或已撤销的小额支付业务的核对。MBFE在与CCPC核对完成后,主动与商业银行行内系统进行业务汇总对帐。商业银行行内系统汇总对帐不符的,向MBFE发送明细对帐申请,进行业务明细对帐,并根据MBFE下发的明细业务进行明细调整,具体流程参见差错处理。商业银行系统应根据小额支付系统的运行时序设置行内系统的运行时序,应与小额支付系统运行时序保持同步。图 运行时序图3 物理连接说明3.1 物理连接结构图图4 物理连接结构图说明:1. 前置机系统采用开放式平台。2. 前置机系统包括一台服务器和若干台PC,前置机系统应支持双机热备份。3. 前置机通过专用网络方式连接CCPC。4. 前置机与商业银行系统的主机通过ESCCON通道或LAN直接相连;支付业务由商业银行各网点通过商业银行主机提交前置机。5. 为保证网络安全性,可在前置机与CCPC之间设置防火墙。3.2 网络结构图说明:前置机与商业银行行内系统之间的网络设备配置方案由商业银行自行决定。3.3 系统软件结构图图5 前置机系统软件结构图3.4 前置机系统配置小额支付系统前置机系统共享大额支付系统前置机系统的硬件设备及系统资源,其系统配置要求参见中国现代化支付系统商业银行前置机配置指引。4 应用连接说明4.1 应用连接结构图图6应用连接结构图图6中前置机端和商业银行主机端的接口需要商业银行自行开发,其通讯协议和信息交换方式也由商业银行自己决定。在前置机端的服务器上提供一组API,供前置机端的接口程序调用,从而实现商业银行行内系统与小额支付系统的对接。4.2 接口处理模式包括三种模式,具体如下:l 模式一说明:1. 商业银行发送报文此模式适用于除商业银行系统向MBFE申请明细对帐的小额业务包明细核对申请报文和小额业务包明细下载申请报文外的所有发起的报文。2. 接收API同步确认响应当API检查报文出错,或发送到MBFE时出错,将向商业银行返回失败的同步响应;API将报文成功发送到MBFE后,将返回成功的同步响应。3. 接收MBFE返回的异步回执MBFE对报文处理完成后(业务检查出错或成功转发到CCPC),将向商业银行返回异步回执。如果商业银行发送的是CMT报文时,将返回CMT911回执报文;如果商业银行发送的是PKG包时,将返回CMT920回执报文,但是,如果MBFE解析PKG包出错,将无法得知报文是CMT报文还是PKG包,也将返回CMT911回执报文。4. 发送异步回执一的同步回应商业银行接收到MBFE的异步回执后,自行调用MB_CONFIRM_BEPS函数发送同步回应,表示接收报文成功或失败,API做相应处理。5. 接收CCPC或NPC返回的异步回执对于批量包报文,CCPC和NPC一定会给一个异步回执(成功或失败)。需要说明一点,对于非批量包业务报文(即各种CMT报文),有两种情况。第一种情况,本身该报文有相应的异步回执报文,如撤销申请报文,有对应的异步回执(撤销应答报文),具体参见4.3.1,此种情况,一定会有第5步和第6步。第二种情况,本身该报文没有对应的异步回执报文,如自由格式信息报文,此种情况,如果CCPC和NPC都转发成功,就没有第5步和第6步。只有当此报文在CCPC或NPC检查出错或处理不成功时,会发送包含拒绝信息的确认报文,才有第5步和第6步。6. 发送异步回执二同步回应商业银行接收到CCPC或NPC的异步回执后,自行调用MB_CONFIRM_BEPS发送异步回执,表示接收报文成功或失败,API做相应处理。注:另外需要说明一点,对于支付类批量包贷记业务报文,第5步接收的异步回执,可能是排队或拒绝或轧差,只有收到拒绝或轧差回执商业行才能认为该笔业务处理完成。l 模式二说明:1. 商业银行发送报文此模式主要适用于商业银行系统向MBFE发起小额业务包明细核对申请报文和小额业务包明细下载申请报文。2. 接收API同步确认响应当API检查报文出错,或发送到MBFE时出错,将向商业银行返回失败的同步响应;API将报文成功发送到MBFE后,将返回成功的同步响应。3. 接收MBFE返回的异步回执MBFE对报文处理完成后(业务检查出错或成功转发到CCPC),将向商业银行返回异步回执。如果商业银行发送的是CMT报文时,将返回CMT911回执报文;如果商业银行发送的是PKG包时,将返回CMT920回执报文,但是,如果MBFE解析PKG包出错,将无法得知报文是CMT报文还是PKG包,也将返回CMT911回执报文。4. 发送异步回执的同步回应商业银行接收到MBFE的异步回执后,自行调用MB_CONFIRM_BEPS函数发送同步回应,表示接收报文成功或失败,API做相应处理。l 模式三说明:1. 接收报文此模式主要适用于商业银行系统接收业务处理范围内的所有报文。商业银行系统接收到报文后需根据不同业务类型做相应的处理。2. 发送同步回应商业银行接收到报文后,自行调用MB_CONFIRM_BEPS函数发送同步回应,表示接收报文成功或失败,API做相应处理4.3 前置机与商业银行系统接口功能4.3.1 发送功能类型编号功能名称处理模式报文种类业务回执备注支付类批量包报文1普通贷记业务包模式一PKG001CMT920CMT9112贷记退汇业务包模式一PKG007CMT920CMT9113定期贷记业务包模式一PKG005CMT920CMT9114实时贷记业务包模式一PKG003CMT920CMT9115普通借记业务包模式一PKG002CMT920CMT9116定期借记业务包模式一PKG006CMT920CMT9117实时借记业务包模式一PKG004CMT920CMT9118实时贷记回执包模式一PKG008CMT920CMT9119普通借记回执包模式一PKG009CMT920CMT91110定期借记回执包模式一PKG010CMT920CMT91111实时借记回执包模式一PKG011CMT920CMT911信息类批量包报文1发送通用信息包模式一PKG012CMT920CMT9112发送实时信息包(包括客户账户查询、支票圈存等)模式一PKG013CMT920CMT911信息类报文1发送查询报文模式一CMT301CMT9112发送查复报文模式一CMT302CMT9113发送小额业务撤销申请报文模式一CMT321CMT322CMT9114发送小额业务退回申请报文模式一CMT319CMT9115发送小额业务退回应答报文模式一CMT320CMT9116发送自由格式报文模式一CMT303CMT9117发送小额批量包处理状态通知报文模式一CMT316CMT9118发送借记业务止付申请报文模式一CMT327CMT328CMT9119发送借记业务止付应答报文模式一CMT328CMT91110发送实时业务冲正申请报文模式一CMT323CMT324CMT91111发送小额业务状态查询报文模式一CMT519CMT520CMT911管理类报文1发送小额业务明细核对申请报文模式二CMT850CMT851CMT911如果报文被拒绝,MBFE返回CMT9112发送小额业务包明细核对下载申请报文模式二CMT852CMT911如果报文被拒绝,MBFE返回CMT911;否则MBFE补发对帐不符的业务报文3发送小额业务包明细下载申请报文模式一CMT853CMT9114发送清算账户圈存资金管理报文模式一CMT510CMT511CMT9115发送净借记控制额度管理报文模式一CMT512CMT513CMT9116发送净借记控制可用额度预警管理报文模式一CMT514CMT515CMT9117发送小额支付业务排队管理报文模式一CMT517CMT518CMT9118小额业务状态补发申请报文模式一CMT521CMT911备注:l 对于发送批量包,如果支付系统解析出错,将无法组织CMT920回执报文,此时支付系统将返回CMT911回执;其他情况,支付系统都返回CMT920回执。l 对于其他非批量包报文有两种情况,第一种情况,本身该报文有相应的异步回执报文,如撤销申请报文,有对应的异步回执(撤销应答报文),支付系统如果处理成功将返回对应的异步回执,如果处理失败,则返回CMT911异步回执;第二种情况,本身该报文没有相应的异步回执报文,则支付系统只返回CMT911异步回执。l 而对于异步回执CMT911,如果报文本身不存在业务三要素(如:自由格式报文),或支付系统解析报文时出错无法解析出报文的业务三要素,此时,支付系统组织CMT911报文时,原委托日期填写报文头日期,原序号填写原报文的报文参考号,原报文发起人填写支付系统报文头的源地址(直接参与者号),商业行通过此三要素匹配原业务;否则,商业行都可通过业务三要素原委托日期,原报文发起人,原报文序号匹配原业务。(具体可参见小额支付系统报文格式标准CMT911报文描述)4.3.2 接收功能类型编号功能名称处理模式报文种类业务回执备注支付类批量包报文1接收普通贷记业务包模式三PKG0012接收贷记退汇业务包模式三PKG0073接收定期贷记业务包模式三PKG0054接收实时贷记业务包模式三PKG0035接收普通借记业务包报文模式三PKG0026接收定期借记业务包模式三PKG0067接收实时借记业务包模式三PKG0048实时贷记回执包模式三PKG0089普通借记回执包模式三PKG00910定期借记回执包模式三PKG01011实时借记回执包模式三PKG011信息类批量包报文1接收通用信息业务包(包括清算组织发起的代付信息、通用信息等)模式三PKG0122接收实时信息业务包(包括客户账户查询、支票圈存等)模式三PKG013信息类报文1接收查询报文模式三CMT3012接收查复报文模式三CMT3023接收小额业务撤销应答报文模式三CMT3214接收小额业务退回申请报文模式三CMT3195接收小额业务退回应答报文模式三CMT3206接收自由格式报文模式三CMT3037接收小额批量包处理确认通知报文模式三CMT9208通用报文处理确认报文模式三CMT9119接收小额批量包处理状态通知报文模式三CMT31610接收借记业务止付申请报文模式三CMT32711接收借记业务止付应答报文模式三CMT32812接收实时业务冲正应答报文模式三CMT32413接收实时业务冲正通知报文模式三CMT32514接收小额业务状态查询应答报文模式三CMT52015接收小额轧差净额清算通知报文模式三CMT254管理类报文1接收小额业务包汇总核对报文模式三CMT8422接收小额业务包明细核对应答报文模式三CMT8513接收业务权限控制通知报文模式三CMT5034接收公共数据变更报文模式三CMT5025接收下级节点变更通知报文模式三CMT5046接收小额支付系统状态变更通知报文模式三CMT5007接收系统停运通知报文模式三CMT5018接收清算账户圈存资金管理应答报文模式三CMT5119接收净借记控制额度管理应答报文模式三CMT51310接收净借记控制可用额度预警管理应答报文模式三CMT51511接收净借记可用额度预警通知报文模式三CMT51612接收小额支付业务排队管理应答报文模式三CMT51813接收小额收费通知报文模式三CMT55214接收小额对外返还通知报文模式三CMT55415小额业务状态下发报文模式三CMT52216贷记业务金额上限变更报文模式三CMT5075 接口双方需要完成的工作5.1 小额支付系统开发单位需要完成的工作l 编写小额支付系统与商业银行接口方案。l 设计、开发接口API,供商业银行开发前置机端小额接口程序时调用。l 编写接口API安装和使用手册。5.2 商业银行需要完成的工作l 改造商业行行内业务系统,支持小额支付系统各种业务的发起和接收。l 开发编写商业银行系统和前置机系统两端的接口程序,调用API以实现相应接口功能。接口程序分别位于前置机(MBFE)和商业行内系统主机。l 按照人民银行的统一计划,进行系统和网络集成,参加支付系统联调和集成测试、模拟运行。l 根据小额支付系统运行管理制度编写商业行行内的系统运行管理制度。6 API使用说明小额支付系统的API函数定义在“bepsapi_mbfe.hpp”中,以静态库(libbepsapi_mbfe.a)的形式提供给商业银行。此静态库只能被UNIX环境中的C+编译器链接,且C+编译环境应支持异常处理,即编译器能识别throw关键字。小额支付系统为商业银行提供的API包括以下五个:l 连接API:命名为MB_CONNECT_BEPS(),用于商业行行内系统从小额支付系统接收指令或发送指令时,接口程序与小额支付系统建立连接。l 断开连接API:命名为MB_DISCONNECT_BEPS(),用于商业行行内系统不再从小额支付系统接收指令或发送指令时,断开与小额支付系统的连接,该API由接口程序调用。l 发送API:命名为MB_SEND_BEPS(),用于商业行行内系统向小额支付系统发送指令, 该API由接口程序调用。l 接收API:命名为MB_RECEIVE_BEPS(),用于商业行行内系统从小额支付系统接收指令,该API由接口程序调用。l 接收确认API:命名为MB_CONFIRM_BEPS(),用于商业行行内系统成功处理从前置机系统接收的指令后,返回确认信息,该API由接口程序调用。6.1 连接APIl 原型void * MB_CONNECT_BEPS(const char *pPsWord, char *pRetStr )l 参数说明pPsWord:安全识别码。pRetStr:3位返回码 + 00000000256位错误描述,表示调用该API的处理结果。000成功100连接数据库失败101安全识别码错误102系统错误,检查前置机故障后可重发116前置机模式为间联,不允许使用直联接口l 返回说明该API函数返回与CNAPS系统连接ID。如果连接失败,返回NULL。具体错误描述从pRetStr中获取。l 使用方法说明前置机端的对接程序中首先包含头文件“bepsapi_mbfe.hpp”,然后只需要将前置机端的接口程序和支付系统提供的静态库一起编译后即可调用该函数。小额支付系统建议商业银行采用长连接模式连接MBFE。l 代码片断void*pID;pID = MB_CONNECT_BEPS(sPassWord, sRetStr);if(strncmp(sRetStr, 000, 3) != 0 ) /解析错误代码,并进行相应的错误处理 6.2 断开连接APIl 原型void MB_DISCONNECT_BEPS ( const void *pID )l 参数说明pID:与CNAPS系统连接ID。l 返回说明该API函数无返回值。l 使用方法说明前置机端的对接程序中首先包含头文件“bepsapi_mbfe.hpp”,然后只需要将前置机端的接口程序和支付系统提供的静态库一起编译后即可调用该函数。l 代码片断MB_DISCONNECT_BEPS(pID);6.3 发送APIl 原型void MB_SEND_BEPS (const void *pID, int nRTimeFlag,const char *pInPutMsg,char *pRetStr) l API调用参数说明pID:与CNAPS系统连接ID。nRTimeFlag:实时报文标识,0 表示非实时报文, 1表示实时报文。pInPutMsg:表示由商业银行系统形成的待发送报文,报文大小限定在28K以内, 超过28K大小的报文,商业银行应采用文件类报文,即将实际正文体内容放到文件中,报文中的正文体只指明该文件名(包括路径)。其格式参见接口报文说明。注意:商业银行发送文件类报文时,文件放置的路径应使用MBFE的bepsmbfe.ini配置文件的SENDFILEMSG参数设置的路径,否则API函数将拒绝处理。文件名的命名规则为:YYYYMMDD8位编号.send。8位编号由直接参与者每日顺序编号。pRetStr:表示调用该API的处理结果,由3位返回码+8位错误发生所在明细笔数+256位返回描述组成。(注:如果3位返回码为000,则后面8位笔数为00000000,当返回码不为000,而后面8位为00000000,则表示错误不发生在明细中)。返回码含义说明:000成功102系统错误,检查前置机故障后可重发103报文解析错,说明报文不完整,修正错误后重发104报文格式错,对批量数据整包拒绝,修正错误后重发105批量包总分一致检查错,总分笔数不符或总分金额不符,修正错误后重发106贷记业务金额超过上限,修正错误后重发107批量包业务笔数超过上限,修正错误后重发108批量包的大小超过上限,修正错误后重发109 报文长度超长(超过28K)110 发起清算行非本清算行111 委托日期非法(委托日期超过MBFE历史保存期)112 报头日期非法(小于委托日期)114 重账(报文标识号重)115 文件路径错(与MBFE配置不相符)117 发送的报文不在接口处理范围118 传入参数不合法119 系统未连接120 由于对帐不平,MBFE拒收报文(2天以上对帐不平)999 其它错l API返回说明无返回值l API使用方法说明前置机端的对接程序中首先包含头文件“bepsapi_mbfe.hpp”,然后只需要将前置机端的接口程序和支付系统提供的静态库一起编译后即可调用该函数。l 代码片断while( bFlag )/检查是否有要发送的数据,如果有的话,则组织并进行发送if(CheckSend() iReturn = getpacket(sSendBuff); MB_SEND_BEPS(pID, 0, sSendBuff, sRetStr);/解析返回码(sRetStr),如果发送错误则做相应的处理if(strncmp(sRetStr, 000, 3) != 0)/解析错误代码,并进行相应的错误处理else/没有报文发送,进行相它的业务处理6.4 接收APIl 原型void MB_RECEIVE_BEPS (const void *pID, int nRTimeFlag,char *pOutPutMsg,char *pRetStr )l API调用参数说明pID:与CNAPS系统连接ID。nRTimeFlag:是否取实时报文的标识,0 表示取非实时报文, 1表示取实时报文。pOutPutMsg:表示由支付系统形成的返回报文,对于返回报文,可能是正常报文,或文件类报文,文件类报文将实际正文体内容放到文件中,报文中的正文体只指明该文件名(包括路径),文件类报文适用于大小超过28K的大报文,其具体格式见接口报文说明。商业银行可根据报头区分不同的业务,对文件分别处理;若接收失败则该字符串不可预见;若没有可提取的报文,该字符串保留原样。注意:商业银行接收文件类报文时,文件放置的路径由MBFE的bepsmbfe.ini配置文件的RECVFILEMSG参数设置的路径决定。文件名的命名规则为:YYYYMMDD8位编号.recv。 8位编号由MBFE每日顺序编号。pRetStr:3位返回码+00000000256位错误描述,表示调用该API的处理结果。若返回码为000,则需要处理参数pOutPutMsg;否则不需处理参数pOutPutMsg。返回码含义说明:000 正常102系统错误,检查前置机故障后可重新接收113前置机系统没有报文可被提取118 传入参数不合法119 系统未连接999 其它错l API返回说明无返回值。l API使用方法说明前置机端的对接程序中首先包含头文件“bepsapi_mbfe.hpp”,然后只需要将前置机端的接口程序和支付系统提供的静态库一起编译后便可调用该函数。l 代码片断while(m_flag)/调用接收函数,进行数据接收/(第二个参数int iFlag 0:表示非实时业务,1:表示实时业务)MB_RECEIVE_BEPS(pID, 0, sRecvBuff, sRetStr);/没有报文可取if(strncmp(sRetStr, 113, 3) != 0)/没有可接收的报文,进行其他处理else if(strncmp(sRetStr, 000, 3) = 0)/对报文进行相应的处理6.5 接收确认APIl 原型void MB_CONFIRM_BEPS ( const void *pID, const char * pMsgDate,const char *pMsgId,int nFlag, int nRTimeFlag,char *pRetStr)l API调用参数说明pID:与CNAPS系统连接ID。pMsgDate:接收API取得报文的报头日期。msgId: 接收API取得报文的报文标识号(唯一标识一笔业务)。nFlag : 标志该笔业务是成功处理还是处理失败。含义:0 表示成功处理1 表示处理失败nRTimeFlag:是否实时报文的标识,0 表示非实时报文, 1表示实时报文。pRetStr:3位返回码00000000+256位错误描述,表示调用该API的处理结果。返回码含义说明:000 成功102系统错误118 传入参数不合法119 系统未连接999 其它错l API返回说明无返回值。l API使用方法说明前置机端的对接程序中首先包含头文件“bepsapi_mbfe.hpp”,然后只需要将前置机端的接口程序和支付系统提供的静态库一起编译后即可调用该函数。l 代码片断/返回接收确认/流程为首先从报文中取得消息ID,然后,调用接收确认函数进行接收确认/填入相应的报文头日期if(success)MB_CONFIRM_BEPS(pID, sMsgData,smsgId, 0, 0, sRetStr);elseMB_CONFIRM_BEPS(pID, sMsgData,smsgId, 1, 0, sRetStr); 7 接口报文说明接口报文说明具体参见文档小额支付系统报文格式标准。但该文档中报头格式为支付系统使用的报头格式,与商业银行接口报头格式不同。商业银行接口报文报头使用大额支付系统接口报文报头,格式定义如下:相对位移长度属性名称值域说明03x块标识1:36n报文长度表示整个报文的长度91n报文用途0,1,2预留101n来往标记0,10: 往帐, 1: 来帐111n业务类型0,1,20:大额,1:小额,2:其他123n业务状态码000表示正常业务001表示来账核全国押错002表示来帐核地方押错158n报文标识号在通讯上唯一标识发起方发起的一笔业务2320x报文参考号用于在接收业务回执时匹配原有的业务指令4314n发送时间yyyymmddhhmmss573nCMT或PKG号码CMT或PKG号608n工作日期当前工作日681x结束标识8 接口安全管理8.1 用户管理由商业行行内系统自身保证对其用户的权限管理,并对处理资源、通信资源、信息资源进行访问控制。8.2 审计追踪为了方便安全事件的事后稽查,商业银行行内系统和接口系统应制订合理的审计策略,对重要的业务操作(包括:所有报文的收发以及异常处理)进行日志记录和日志管理。日志包括用户操作日志,文件日志,以及记录出错信息的系统日志。任何符合审计追踪条件的操作都会记录必要的审计追踪信息;并建立完整的审计追踪信息。前置机系统设置的审计追踪条件、记录的审计追踪信息只有经过授权的人员才能够访问。8.3 网络安全为保证支付信息的安全传输,商业银行系统与支付系统之间的网络连接必须采用相应的安全措施,不得与其他非支付信息传输(如办公自动化、互联网等)共用一个网络,并使用防火墙进行隔离。8.4 报文权限控制小额支付系统将严格控制商业银行系统发起和接收报文的权限,不在允许范围内的,将予以拒绝。8.5 API使用安全管理商业银行系统接口提供安全识别码检验功能,用于保证API调用的安全性,接口程序在调用API时,必须填写相应的安全识别码, 安全识别码不符将拒绝调用。9 差错及故障处理9.1 差错处理(1) 发起方错误的处理接口及小额支付系统各节点将对商业行行内系统发出的报文进行严格的格式检查和业务检查(如业务权限、收发行号等),发现错误后,商业银行行内系统应根据确认信息中的错误原因,改正后重新发送。(2) 接收方错误的处理商业银行行内系统应对接收的报文进行必要的格式及业务检查,检查正确的继续处理,错误的要予以登记错帐登记薄,查明原因后进行相应处理。(3) 对帐不符的处理商业银行在日终进行汇总对账时,如果汇总对账不平,可以向前置机发出业务包明细核对申请,前置机收到业务明细核对申请后,将当日某类业务包明细清单(仅含包标识)下发给商业银行,商业银行根据明细清单以前置机为准进行核对和调整。并可向前置机发出业务包明细核对下载申请,申请下载没有收到的来帐包或本方不存在的往帐包。前置机收到业务明细下载申请后,将商业银行申请下发的包添加补发标志,重新发送给商业银行。9.2 故障处理l 前置机系统与CCPC(或商业银行系统)通讯故障的处理当前置机系统与CCPC(或商业银行系统)的通讯出现故障时,前置机系统会检测到故障,并在客户端人工界面提示错误,通知商业银行维护人员进行通讯故障的修复;如果通讯故障在短时间之内不能修复,前置机系统提供磁介质的方式与CCPC(或商业银行系统)进行数据的传送。l 前置机系统系统故障的处理商业银行的前置机系统采用实时双机热备份机制, 备份的前置机
温馨提示
- 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
- 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
- 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
- 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
- 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
- 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
- 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。
最新文档
- 2024下半年肇庆市德庆县事业单位招聘考试《综合基础知识》试题(附答案)
- 摄影导演基础知识培训课件
- 水文新技术应用试题及答案
- 环保知识培训课件
- 2025关于租房合同协议书的范本
- 2025年建筑工程施工合同的法律效力解析
- 摄影中的色彩搭配
- 公司课外知识培训课件
- 援疆消防安全知识培训课件
- 揭阳安全知识培训课件学校
- DL∕T 1362-2014 输变电工程项目质量管理规程
- 业务跟单培训
- 河北省唐山市路北区2023-2024学年八年级下学期期末数学试题
- DL-T-5161.13-2018电气装置安装工程质量检验及评定规程第13部分:电力变流设备施工质量检验
- 安全顾问聘请协议
- 设备材料进场报验单
- 班组长计划管理能力考试题库-上(选择题)
- 八年级物理下册期末试卷综合测试卷(含答案)
- (正式版)HGT 20656-2024 化工供暖通风与空气调节详细设计内容和深度规定
- (完整版)《机械制造工艺基础》教案
- 抖音剪辑合同
评论
0/150
提交评论