搜索
铁通话费银行代收系统接口规范说明书第1页共21页铁通话费银行代收系统接口规范说明书编写单位：华泰贝通计费事业部定稿时间：2003年7月16日【版权声明】本文档版权归北京华泰贝通公司所有，任何人不得以任何方式将本文档传递给其他与本项目无关的个人或机构，我公司对违反此声明者保留依法追究法律责任的权利。铁通话费银行代收系统接口规范说明书第2页共21页版本历史版本作者/修改者日期备注1.0高佩忠2002-4-25一稿1.1高佩忠2002-8-19修改了一些表达不准确的地方2.0何武军2002-10-24增加发票打印及发票补打交易2.1高佩忠2002-11-13加目录；备注移到文件尾3.0高佩忠2003-4-16将批扣和托收部分单独形成一个文档3.1高佩忠2003-4-16修改第8页关于交易包填充的说明3.2高佩忠2003-4-16将与批量代扣相关的FTP说明移至《铁通话费银行批量代扣规范》3.3武豪2003-5-28细化了关于时间的说明3.4高佩忠2003-7-16增加辽宁各地市金融机构代码定义3.5李洪涛2005-3-1取消“缴费申请”、“缴费确认”两种交易铁通话费银行代收系统接口规范说明书第3页共21页目录1接口规范说明..................................................................................................51.1参数定义.........................................................................................................51.2关于对帐.........................................................................................................61.3实现方式.........................................................................................................61.4关于银行柜台缴费..........................................................................................61.5关于其它缴费模式..........................................................................................61.6响应码定义.....................................................................................................61.7关于安全问题..................................................................................................61.8通讯方式.........................................................................................................72铁通话费银行现金代缴规范............................................................................82.1通信报文格式..................................................................................................82.1.1话费查询（银行→铁通）...............................................................................82.1.2话费缴纳（银行→铁通）...............................................................................92.1.3发票打印（银行→铁通）.............................................................................112.1.4发票补打（银行→铁通）.............................................................................122.1.5用户退费（银行→铁通）.............................................................................142.1.6缴费冲正（银行→铁通）.............................................................................142.1.7退费冲正（银行→铁通）.............................................................................152.1.8总额对帐（银行→铁通）.............................................................................162.1.9明细对帐（银行→铁通）.............................................................................172.2交易返回码定义（铁通→银行、银行→铁通）...........................................183银行-铁通FTP文件传输规范.......................................................................193.1登录用户及密码............................................................................................193.1.1用户名..........................................................................................................193.1.2密码..............................................................................................................203.2路径说明.......................................................................................................203.2.1银行上传明细对帐文件路径..........................................................................20铁通话费银行代收系统接口规范说明书第4页共21页3.3其它说明.......................................................................................................203.3.1FTP用户浏览权限........................................................................................203.3.2关于上传、下载路径.....................................................................................204备注..............................................................................................................21铁通话费银行代收系统接口规范说明书第5页共21页1接口规范说明1.1参数定义1)代理金融机构代码：3位，用于识别代金融机构110建行、210交行、310农行、410中行、510工行、610招行、710邮储、810城市商业银行、910广发行、A10福建兴业银行、B10华夏银行、C10中信实业银行、D10光大银行、E10农联社F10~Z10其它银行依次定义。【辽宁金融机构代码定义】仍用三位表示：ABC“A”代表金融机构，其余两位“BC”代表地市；“A”的定义为：0银联、1建行、2交行、3农行、4中行、5工行、6招行、7邮储、8城市商业银行、9广发行；“BC”的定义为：沈阳24铁岭10大连11鞍山12抚顺13本溪14丹东15锦州16营口17阜新18辽阳19朝阳21盘锦27葫芦岛29通辽75赤峰762)电信运营商代码：铁通0110。3)应用种类定义：铁通话费银行代收系统接口规范说明书第6页共21页代缴话费：0101/0001；代扣话费：0102；代办业务：0103，如需增加业务种类，双方协商决定。1.2关于对帐1)对帐标准：通过银行代收代缴发生的帐务，以银行端交易记录为准。2)异常处理：经核对，双方不一致的交易，进行人工干预处理。3)对帐时间：由银行系统发起对帐交易请求，时间可以考虑在每天营业结束后进行，具体时间由双方协商确定。1.3实现方式目前不仅考虑实时联网的现金或支票缴费方式，也包括批量代扣方式等缴费方式。1.4关于银行柜台缴费1)目前允许的缴费方式：可支持用户现金缴费，同时系统也要支持个人或单位的支票缴费方式，以方便用户，具体的支票缴费流程需要由银行完成。2)业务流程：向铁通计费系统查询话费→用户身份核对→用户缴费→打印发票→完毕。1.5关于其它缴费模式电话银行缴费、网上银行支付、银行查询终端缴费等交易处理模式可参照银行柜台交易的模式进行处理，计费系统只负责按照统一的格式传送交易包请求回复资料，具体的处理流程由银行完成。1.6响应码定义采用自定义响应码，见后。1.7关于安全问题交易传输过程中涉及的资料加密问题，由银行方提供相应标准及接口函数。铁通话费银行代收系统接口规范说明书第7页共21页1.8通讯方式双方前置机通讯采用TCP/IPsocket编程方式，连接方式为短连接，即每有交易时由客户端（银行端）发起通讯请求，建立TCP/IP连接，交易结束后双方断开连接。铁通话费银行代收系统接口规范说明书第8页共21页2铁通话费银行现金代缴规范2.1通信报文格式2.1.1话费查询（银行→铁通）请求响应属性备注MMChar(4)包长度，传递ASCΠ码字符（长度不足左补零）01000110MMChar(4)单位编号（铁通4位、0110）MChar(10)银行应收金额（取整后），以分为单位，（长度不足左补零）；MChar(10)用户实际费用金额，以分为单位，（长度不足左补零）MMChar(14)交易流水号（响应时的交易流水号与请求相同）MChar(14)交易时间（YYYYMMDDHHMMSS）MMChar(4)应用种类（代缴话费：0101）MMChar(30)银行柜台代码