邮政储蓄个人网银与邮政综合服务平台接口技术规范V12要点.docx

1、邮政储蓄个人网银与邮政综合服务平台接口技术规范V12要点邮政储蓄个人网银系统与邮政综合服务平台接口技术规范个人网银项目组 发布2010-07-12发布目 次目 次 I前 言 III邮政储蓄个人网银系统与邮政综合服务平台接口技术规范 11 范围 12 规范性引用文件 13 术语和定义 13.1 综合服务平台 13.2 前置系统 14 符号和缩略语 15 修改原则 15.1 个人网银系统与综合服务平台要求 25.1.1 个人网银系统设计要求 25.1.2 综合服务平台设计要求 25.2 通讯连接方式 26 报文结构及使用说明 26.1 通信报文协议 26.2 传送路段代号说明 26.3 取值符号说

2、明 26.4 数据类型说明 36.5 MAC的构成 36.5.1 报文数据元的选取 36.5.2 MAC块数据元的构成规则 46.6 报文结构说明 46.6.1 报文结构 46.6.2 报文头说明 46.6.3 位图的说明 56.7 报文格式异常 56.7.1 报文语法错误 56.7.2 报文语义错误 66.7.3 报文错误码 66.8 链路检测报文说明 67 报文数据域说明 67.1 报文数据域列表 67.2 消息类型 77.3 主帐号卡号（位元） 87.4 交易处理码(位元3) 87.5 交易金额（位元4） 87.6 渠道标识码（位元7） 97.7 流水号（位元11） 97.8 本地时间（

3、位元12） 97.9 本地日期（位元13） 97.10 清算日期（位元15） 97.11 交易标志（位元20） 107.12 服务点进入方式（位元22） 107.13 服务点条件代码（位元25） 117.14 手续费1（位元28） 117.15 手续费2（位元29） 117.16 交易系统代码（位元32） 117.17 发信系统代码（位元33） 127.18 第二磁道数据（位元35） 127.19 第三磁道数据（位元36） 127.20 系统检索号（位元37） 127.21 响应码（位元39） 127.22 终端标识号（位元41） 137.23 交易局代码/受卡方标识码（位元42） 137.2

4、4 户名（位元43） 137.25 存折印刷号（位元46） 137.26 交易货币代码（位元49） 137.27 个人识别号（PIN）数据（位元52，个人网银不验密，此域不上送） 147.28 安全控制信息（位元53） 147.29 消息原因码（位元60） 147.30 证件信息（位元61） 157.31 附加个人标识号数据（位元62） 157.32 原始交易信息（位元90） 157.33 报文安全码（位元96） 167.34 接收系统代码（位元100） 167.35 转入号码（位元103） 167.36 对帐信息（位元121） 167.37 发起自定义数据（位元122） 167.38 应答自

5、定义数据（位元123） 167.39 报文鉴别码（位元128） 178 交易定义 178.1 交易报文接口 178.1.1 管理通知类 178.1.2 加办类（代扣缴费） 198.1.3 代缴类 248.1.4 异常通知 358.2 交易流程 358.2.1 管理通知类 358.2.2 加办类 368.2.3 代缴类 378.2.4 异常通知 37附录A 39附录B 40附录C 42附录D 47附录E 48附录F 491前 言本指导性文件依据“邮政储蓄银行个人网上银行系统技术方案”对涉及个人网银系统和综合服务平台之间的代理业务、代售业务、打印发票等方面的接口进行了规范。本指导性文件的附录A、附

6、录B、附录C、附录D、附录E、附录F为规范性附录。本指导性文件由国家邮政局信息技术局提出。本指导性文件起草单位：国家邮政局信息技术局。邮政储蓄个人网银系统与邮政综合服务平台接口技术规范11范围本指导性文件规定了个人网银系统与邮政综合服务平台接口的定义、符号和缩略语、应用通信接口要求、报文格式、报文数据元说明、交易流程等内容。本指导性文件适用于邮政储蓄个人网银系统与邮政综合服务平台之间接口软件的开发、测试和运行维护。12规范性引用文件下列文件中的条款通过本指导性文件的引用而成为本指导性文件的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本指导性文件，然而，鼓

7、励根据本指导性文件达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本指导性文件。GB/T 2260-2002 中华人民共和国行政区划代码13术语和定义13.1综合服务平台综合服务平台是一套用于整合各类代缴、代售业务需求，完成与储蓄省中心、第三方合作单位等业务系统之间的数据交互，实现各类代缴、代售业务稳定、有效办理的功能完善、便于二次开发的平台化系统。13.2前置系统前置系统包括电话银行系统及个人网银系统或ATM（自助终端）前置系统和POS前置系统等，它作为综合服务平台的一个交易渠道存在，负责处理终端设备的交易接入、报文转换和交易转发，并管理和监控相关的终

8、端设备，另外还有相应的报表和统计功能。14符号和缩略语以下符号和缩略语适用于本指导性文件。ATM：Automatic Teller Machine，自动柜员机DES：Data Encrypt Standard，数据加密标准IP：Internet Protocol ，网间网协议MAC：Message Authentication Code，报文鉴别码PIN：Personal Identification Number，个人识别号POS：Point Of Sales，销售点终端TCP：Transmission Control Protocol，传输控制协议15修改原则 此次网上缴费与电话银行缴费的

9、区别： 通讯方式由原来的socket同步长连接，改为socket同步短连接。 网银交易无需上送账户密码，中间业务平台不需要对账户密码进行校验，转送储蓄统版系统时，填送无需校验密码标志。 网银渠道标识号使用16 增加了加办，撤办和加办查询3支交易。可实现中间业务平台的代扣业务 加办、撤办和加办查询交易返回字段增加了“签约协议号”，另加办查询还增加“缴费编码备注”字段 代理缴费和预存缴费交易请求字段增加了“备注”字段，分别放在代理缴费122.7位元和预存缴费122.6位元 已缴费用查询交易返回字段增加了“中间业务流水号”和“备注”字段 代理缴费和预存缴费交易增加了“证件信息”（61位元）字段，该字

10、段在信用卡消费时，根据业务需要选择上送 报文数据域列表中增加了户名字段，代扣缴费加办交易、应缴费用查询交易、预存余额查询交易增加了返回字段“户名”；代理缴费交易和预存缴费交易上送字段和返回字段都增加了户名（如果该缴费项目无户名，该字段则返回空）。 增加了6.8链路检测报文说明，用于实现检测个人网银和中间业务平台的链路功能。 增加了交易报文接口8.1.3.6合同号查询，用于通过中间业务平台查询缴费号码在第三方系统的合同号信息，供用户选择合同号，进行缴费或加办。（该交易适用于某种缴费业务的缴费号码对应多个合同号的情况，进行查询显示，供用户选择合同信息，进行缴费或加办，根据各省实际情况，选择使用）1

11、5.1个人网银系统与综合服务平台要求15.1.1个人网银系统设计要求个人网银系统按综合服务平台提供的IP地址和通信端口与综合服务平台进行报文的交互。系统采用负载均衡模式，当某一节点发生故障时，可保证其仍按原IP地址和通信端口与综合服务平台通信。15.1.2综合服务平台设计要求综合服务平台提供固定的IP地址和通信端口供个人网银系统接入。对于实施了双机互备的系统，当一个节点出现故障而发生系统切换时，按照透明切换的原则，不会对综合服务平台和个人网银系统的通信连接产生影响，即个人网银系统仍按综合服务平台原IP地址和通信端口与综合服务平台进行通信。15.2通讯连接方式由于采用负载均衡模式，通讯方式使用S

12、OCKET同步短连接方式。16报文结构及使用说明16.1通信报文协议个人网银系统与综合服务平台进行数据交换时，交易报文采用类ISO8583报文格式。16.2传送路段代号说明AN：交易的请求方。IN：交易的应答方。16.3取值符号说明在报文格式的列表中采用以下表示方法：M： 强制数据元(Mandatory)，此数据元在该种报文中必须出现否则将被认为报文格式出错。M+： 必须增加的数据元。Cn： 条件数据元(Conditional)，此数据元在报文中出现，但只在一定条件下有效。在该种报文中，具体的条件请查阅每个列表后的条件数据元说明（为了方便，将某位元相对应的数据元用“某位元”描述）。(n为特定的

13、数字)。Space： 此数据元在该种报文中不出现。(N)： 此数据元可重置。若某数据元未使用该符号，则除非该数据元在之前的路段上未出现，否则不可重置。R： 必须与先前报文中对应数据元的值相同。16.4数据类型说明 Ax x位定长的字母字符A.x 最大长度为x位的变长字母字符ANx x位定长的字母和/或数字字符AN.x 最大长度为x位的变长字母和/或数字字符ANSx x位定长的字母、数字和/或特殊符号字符ANS.x 最大长度为x位的变长字母、数字和/或特殊符号字符ASx x位定长的字母和/或特殊符号字符AS.x 最大长度为x位的变长字母和/或特殊符号字符B 二进制位DD 日hh 时LL 可变长数

14、据元的长度值(二位数)LLL 可变长数据元的长度值(三位数)MM 月mm 分Nx x位定长的整型数值。若表示金额，则最右二位为角分N.x 最大长度为x位的整型数值。若表示金额，则最右二位为角分Sx x位定长的特殊符号字符S.x 最大长度为x位的变长特殊符号字符ss 秒VAR 可变长数据元X 借贷符号，在数值之前，D表示借，C表示贷YY 年（2位）YYYY 年（4位）Z 由ISO 7811和ISO 7813制定的磁卡第二、三磁道的数据类型特别说明：对于定长的非数值型数据，一律左对齐，长度不足时右补空格。对于定长的数值型(整型、实型)数据，一律右对齐，位数不足时左补零。对于变长的数据，则表示为数据

15、元长度+数据元值的形式。16.5MAC的构成16.5.1报文数据元的选取对于需计算消息鉴别码的报文，以下数据元（见下表）只要出现，就应该包含在MAC计算中。报文消息鉴别码计算一览表见附录F。表1MAC应计算的数据元表NO.位元数据元名称位数1消息类型N422主帐号卡号AN.19(LLVAR)33交易处理码N644交易金额N12511流水号N8612本地时间N6713本地日期N8832交易系统代码AN11933发信中心代码AN111039应答码AN21153安全控制信息N1612100收信中心代码AN1113103转入号码ANS.28(LLVAR)其中：a) 主账号应根据长度来取。内容为主账号长

16、度(2) + 主账号；b) 安全控制信息仅用于更新密钥消息的MAC中。c) 转入号码应根据长度来取。内容为转入号码长度（2）+ 转入号码16.5.2MAC块数据元的构成规则MAC数据元的选取将根据 Bit map 中上述数据元是否出现在报文中来确定。上述数据元只要出现在报文中，应截下送入 MAC 计算数据元；数据元和数据元之间应插入一个空格。对所选择的 MAC 报文数据元，应进一步作字符处理。 除去一些冗余信息，以提高 MAC 的质量。处理方法如下：a) 在数据元和数据元之间插入一个空格；b) 除了字母（A-Z，a-z），数字（0-9），空格，逗号（，）和点号（.）以外的字母都删去；c) 删去

17、打头空格和结尾空格；d) 多于一个的连续空格，由一个空格代替；e) 将经过字符选择处理的数据按 64 Bit 一块划分若干块，若最后一块的位数小于 64 Bit，则用 0x00 填满。16.6报文结构说明16.6.1报文结构报文由四部分组成：报文头，报文类型标识符，位图（Bit map：以表示各数据元的有无），及数据元。报文结构如图1所示：报 文 头报文类型标识符位图数 据 元图1报文结构16.6.2报文头说明a) 报文头包含报文长度、系统ID、交易流水号、错误码等4个部分，共21个字节，结构见表2。表2报文头结构1234报文长度系统ID交易流水号错误码1-2字节3-9字节10-17字节18-

18、21字节注：报文头中拒绝报文的错误码见附录B，成功交易应为全“0”。b) 报文头组成部分的描述1) 报文长度指整个报文的长度（不包括报文长度本身这两个字节），采用十六进制数表示，共两个字节：例如：整个报文长度是256，那么报文长度中记录的数据就是2562254，十六进制表示为：0x00 0xFE。2) 系统ID表示个人网银系统的ID号。由系统内报文发起方置入，ID号为7位，是指该系统在储蓄省中心注册的平台号。3) 交易流水号描述该笔交易流水号。由个人网银系统产生，请求报文与响应报文中内容一致。4) 错误码描述报文被拒绝的原因，由拒绝方置入。编码见6.7“报文格式异常”和附录B；16.6.3位图

19、的说明报文中带有位图来标识报文中有哪些域而没有哪些域。一个报文中可以有一个或两个：第一和第二位图用于磁条卡/折交易，在这种情况下第一、第二可以同时出现。本节描述这些位图。报文头报文类型标识符位 图报文域 位图1=域2-64 位图2=域66-128图2位图说明c) 第一个位图每一个报文都有主位图。它是由64个二进制位(8个字节)构成，位于报文类型标识符之后。除了第一位，每一位和一个域相对应，即和域2到域64相对应。每位的值指示该域是否出现在报文中：如果一个位为0，与之相关的域不出现在报文中如果一个位为1，与之相关的域出现在报文中域号是1的域不存在。主位图的第一位用来指明在主位图后是否还有第二个位

20、图，称为位图二。位图二的说明见下节。d) 第二个位图主位图的第一位指明了主位图后是否有第二个位图位图二。和主位图相同，位图二也由64个二进制位(八字节)构成。可以认为位图二是主位图的扩展，和域66到128相关。报文域65不存在。图3第二位图说明只有当报文中包含有域66到域128中的域，位图二才会使用到。位图二紧接着主位图，并在报文域之前。图3显示了位图二的位置和功能。主位图的第一位是1表示位图二的存在。如果位图中的哪一位为1，表示以该位序号为序号的域存在。16.7报文格式异常16.7.1报文语法错误语法错误是接收到的报文格式不符合本指导性文件的报文格式说明。一旦发生报文语法错误，向交易的发送方

21、发送拒绝应答。16.7.2报文语义错误报文语义错误是指接收到的报文中位元的取值范围或数据类型不符合本指导性文件的报文位元说明。一旦发生报文语义错误，向交易的发送方发送拒绝应答。16.7.3报文错误码对产生语法错误和语义错误的报文，将在应答消息中给出报文错误码。报文错误码见附录B，其编码规则如下：报文错误码由4位数字字符组成：XXXY，其中：XXX为错误位元编号；Y为错误定义： 1 - 位元未定义2 - 长度域中出现非法字符/长度域的长度值大于规定值3 - 非法数字字符/非法值4 - 缺少必要位元16.8链路检测报文说明为了确保个人网银与综合服务平台链路的正常，保证链路异常时的快速应急处理，个人

22、网银系统在设定的时间，会向综合服务平台发送探测报文，该报文不带任何附加数据，并置报文长度域的值为零。综合服务平台收到这样的报文后，不做任何业务处理，直接给个人网银返回应答报文，该应答报文不带任何附加数据，并置报文长度域的值为零。报文长度格式：十六进制表示为：0x00 0x00 当个人网银收到检测报文应答时，证明个人网银与综合服务平台链路正常。17报文数据域说明17.1报文数据域列表报文数据域列表见表3。表3报文数据域列表索引号位元标识位元名称位元格式和长度位元说明MSGTYPE消息类型N4消息类型2ACCOUNT主帐号/卡号AN.19(LLVAR)客户的帐号或卡号3PCODE交易处理码N6交易

23、的标识代码4AMOUNT交易金额N127CHNLNO渠道标识码AN2用来区分不同交易渠道11SEQNO流水号N812LOCALTIME本地时间N6(hhmmss)交易时系统时间13LOCALDATE本地日期N8(YYYYMMDD)交易时系统日期15CLEARDATE清算日期N8(YYYYMMDD)帐务性交易参加清算的记帐日期20TXN_FLAG交易标志AN8交易报文中指明交易属性或处理方法的标志22SERVENTRY服务点进入方式N3交易发起时，系统采集帐户的方式25SERVCODE服务点条件代码N2交易发起时的交易处理情况28FEE1手续费1N8为处理交易的手续费预留29FEE2手续费2N8

24、为处理交易的手续费预留32TRANSINST交易系统代码AN11交易系统代码33SENDINST发信系统代码AN11发信系统代码35TRACK2DATA第二磁道数据Z.37(LLVAR)以卡发起的交易中，卡的第二磁道数据信息36TRACK3DATA第三磁道数据Z.104(LLLVAR)以卡发起的交易中，卡的第三磁道数据信息37RetrievalRefNbr系统检索号AN12在POS交易和ATM跨行交易使用39RESPCODE响应码AN2主机处理交易后给受理方的应答码。41TERMID终端标识码ANS8发起交易的终端标识码42TRANBRANCH交易局代码/受卡方标识码ANS15交易的交易局代码

25、/受卡方标识码43CUSTNAME户名ANS.40(LLVAR)客户的姓名46PRINTNO存折印刷号ANS10存折的存折印刷号49CURRENCY交易货币代码AN3交易的货币代码156：人民币52PINDATA个人识别号(PIN)数据B64客户个人密码的密文53SECUINFO安全控制信息N16报文加密的安全传输的控制信息60REASONCODE消息原因码N4交易发起原因码61IDINFO证件信息ANS.22(LLVAR)证件代码证件号码61.1PERSONID证件代码N261.2PERSONCODE证件号码ANS.2062PINDATA1附加个人识别号数据B64可存放新密码或新密钥90OR

26、GDATA原始交易信息描述原始交易信息。90.1ORGMSGTYPE原交易处理码N690.2ORGDATE原本地日期N8(YYYYMMDD)90.3ORGTIME原本地时间N6(hhmmss)90.4ORGCLRDATE原清算日期N8(YYYYMMDD)90.5ORGTRANSINST原交易系统代码AN1190.6ORGSEQNO原流水号N890.7ORGAMOUNT原交易金额N1296KEYDATA报文安全码B64用于存放新密钥100DESTINST接收系统代码AN11121ACCTCHK对帐信息ANS.999(LLLVAR)对帐信息122FILLER1发起自定义数据元ANS.999(LLL

27、VAR)发起方请求报文中定义的扩展位元123FILLER2应答自定义数据元ANS.999(LLLVAR)接收方响应报文中定义的扩展位元128MAC报文鉴别码B64鉴别报文的合法性信息17.2消息类型a) 变量属性：N4，4个字节的定长数字b) 描述：报文类型标识符（Message Type Identifier）由四位数字组成。其含义见下表。表4报文类型标识符定义表第1、2位置标识报文类型含义第3位置标识报文功能含义第4位置标识传输方式含义01授权报文0普通请求0普通02金融交易报文1普通应答1重发03文件更新报文2通知请求2反向04撤销报文3通知应答05对帐控制报文06管理报文07ISO保留

28、08网络管理报文09-79ISO保留80-89国家保留90-99民间保留c) 用法：见附录E。17.3主帐号卡号（位元）a) 变量属性：AN.19(LLVAR)，两位长度值最大19个字节的变长数字和/或字母字符串。b) 描述：用来进行交易的主帐号或卡号，即通过刷磁条方式获取或手工输入的用户帐号或卡号。c) 用法：对持卡交易，个人网银系统必须从客户磁卡的第二磁道或第三磁道上截取帐号后，填入此数据元。对一些特定的交易，交易局可根据用户输入的主帐号信息填写此数据元。17.4交易处理码(位元3)a) 变量属性：N6，6个字节的定长数字b) 描述：交易处理码(Processing Code)由六位数字组成。第1和第2位置固定为“88”；第3位置表示交易类别；第5位置表示交易序号；第4、6位置保留。交易处理码定义表见表5。表5交易处理码定义表交易处理码字节代码含义代码含义代码含义1、2