铁通铁通话费银行代收系统接口规范介绍(doc 21页)

编写单位华泰贝通计费事业部

定稿时间 2003年7月16日

【版权声明】本文档版权归北京华泰贝通公司所有任何人不得以任何方式将本文档传递给其他与本项目无关的个人或机构我公司对违反此声明者保留依法追究法律责任的权利。

版本历史

目 录

1 接口规范说明. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3

1 .1 参数定义. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3

1 .2 关于对帐. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

1 .3 实现方式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

1 .4 关于银行柜台缴费. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

1 .5 关于其它缴费模式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

1 .6 响应码定义. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

1 .7 关于安全问题. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

1 .8 通讯方式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

2 铁通话费银行现金代缴规范. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

2.1 通信报文格式. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

2.1 .1 话费查询银行→铁通. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

2.1 .2 话费缴纳银行→铁通. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

2.1 .3 发票打印银行→铁通. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8

2.1 .4 发票补打银行→铁通. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

2.1 .5 用户退费银行→铁通. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

2.1 .6 缴费冲正银行→铁通. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

2.1 .7 退费冲正银行→铁通. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12

2.1 .8 总额对帐银行→铁通. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13

2.1 .9 明细对帐银行→铁通. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14

2.2 交易返回码定义铁通→银行、银行→铁通. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15

3 银行-铁通FT P文件传输规范. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16

3.1 登录用户及密码. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16

3.1 .1 用户名. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16

3.1 .2 密码. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

3.2 路径说明. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

3.2.1 银行上传明细对帐文件路径. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

3.3 其它说明. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

3.3.1 FTP用户浏览权限. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

3.3.2 关于上传、下载路径. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

4 备注. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18

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

赤峰 76

2) 电信运营商代码铁通01 10。

3) 应用种类定义

代缴话费 0101/0001 代扣话费 0102代办业务 0103如需增加业务种类双方

协商决定。

1.2关于对帐

1) 对帐标准通过银行代收代缴发生的帐务 以银行端交易记录为准。

2) 异常处理经核对双方不一致的交易进行人工干预处理。

3) 对帐时间 由银行系统发起对帐交易请求时间可以考虑在每天营业结束后进行具体

时间由双方协商确定。

1.3实现方式

目前不仅考虑实时联网的现金或支票缴费方式也包括批量代扣方式等缴费方式。

1.4关于银行柜台缴费

1) 目前允许的缴费方式可支持用户现金缴费 同时系统也要支持个人或单位的支票缴费

方式 以方便用户具体的支票缴费流程需要由银行完成。

2)业务流程 向铁通计费系统查询话费→用户身份核对→用户缴费→打印发票→完毕。

1.5关于其它缴费模式

电话银行缴费、 网上银行支付、银行查询终端缴费等交易处理模式可参照银行柜台交易的模式进行处理计费系统只负责按照统一的格式传送交易包请求回复资料具体的处理流程由银行完成。

1.6响应码定义

采用自定义响应码见后。

1.7关于安全问题

交易传输过程中涉及的资料加密问题 由银行方提供相应标准及接口函数。

1.8通讯方式

双方前置机通讯采用TCP/IP socket编程方式连接方式为短连接 即每有交易时由客户端银行端发起通讯请求建立TCP/IP连接交易结束后双方断开连接。2铁通话费银行现金代缴规范

2.1通信报文格式

2.1.1话费查询银行→铁通

注

1) 本报文用于银行方查询用户费用情况。

2) “M”的意义为该域在请求或应答交易包中必须存在无“M”标志的域在交易包中可做填充也可不填充若在交易包中填充则必须以空格填充但最好不填充。此规则适用于所有交易包。

3) “交易返回码”参见“交易返回码定义”。此规则适用于所有交易包。

4) “说明信息”域是对“交易返回码”的辅助说明。

5) “话费明细”域第一项为上期余额其它为话费明细没有合计项话费明细有些项目有可能为负值。例如

上期余额************0000000000 月租费用************0000005000 长话费用

************0000050000 市 话 费 用 ************0000080000 时 段 优 惠

************-000002000  ‘*’表示空格。

6) 交易包各域的填充规则用于数值运算的域长度不足左补零如果为负值负号在首位其它域右补空格。此规则适用于所有交易包。

7) 交易包总长度包括“包长度”域的四个字节。此规则适用于所有交易包。

8) 关于“银行应收金额”和“用户实际费用金额”

银行应收金额=取整用户实际费用金额上期余额取整规则由双方协议

如果用户实际费用金额小于上期余额银行应收金额不进行取整为精确到分的一个负值用户实际费用金额=话费明细中除去上期余额项之外的所有项之和。

2.1.2话费缴纳银行→铁通

注

1) 该报文用于银行代缴话费。

2) 用户缴费前必须做话费查询交易。

3) “实交金额”即银行实际收取的金额

4) “用户实际费用金额”域必须与话费查询交易中返回的“用户实际费用金额”完全一致否则缴费会失败。

5) 发票信息可以从话费查询交易中获取也可以通过发票打印交易获取。

6) 如果从话费查询交易中获取无法分帐期打印发票同时在缴费请求包中应将应用种类置为

0101银行方应将“实交金额”“用户实际费用金额” “上期余额”打印在用户发票的“本期余额”项目中该项目不包含在查询应答包的名细项目中要由银行端程序产生。通过此方式打印发票后铁通将该张发票置为已打印银行不能再通过发票打印或发票补打

交易打印该张发票。

7) 如果银行不利用话费查询交易信息打印发票在缴费请求包中应将应用种类置为0001铁通将该次缴费的发票置为未打印银行能通过发票打印或发票补打交易打印该次缴费的发票。

2.1.3发票打印银行→铁通

注

1) 该报文用于用户缴纳话费之后分帐期打印发票。

2) 该交易只返回本次缴费的发票信息如果该次缴费跨几帐期发票将会有多张每次只返回某一帐期的发票信息该次缴费由“对应的话费缴纳交易流水号”域唯一决定。

3) 如果银行申请的为第一张发票应将“上张发票打印结果”域置为2表示申请第一张发票其它情况按照上张发票的实际打印结果置该域为相应的值。

4) 如果银行申请的为第一张发票将“发票申请标志”域置为1 。

5) 银行在打印发票过程中可以选择继续申请上一张发票在上一张发票打印失败的情况下或者申请下一张未打印发票或者停止申请如果银行停止申请铁通将不返回信息给银行。

6) 正常情况下如果有n张发票需要打印银行需要发n+1次请求其中最后一次请求为第n张发票的打印确认信息。

7) 银行在申请每一张发票时都需要重新连接 即通讯采用短连接方式。

2.1.4发票补打银行→铁通