邮政储蓄个人网银与邮政综合服务平台接口技术规范V12要点.docx
《邮政储蓄个人网银与邮政综合服务平台接口技术规范V12要点.docx》由会员分享，可在线阅读，更多相关《邮政储蓄个人网银与邮政综合服务平台接口技术规范V12要点.docx（95页珍藏版）》请在冰豆网上搜索。
邮政储蓄个人网银与邮政综合服务平台接口技术规范V12要点
邮政储蓄个人网银系统与邮政综合服务平台接口技术规范
个人网银项目组发布
2010-07-12发布
目次
目次I
前言III
邮政储蓄个人网银系统与邮政综合服务平台接口技术规范1
1范围1
2规范性引用文件1
3术语和定义1
3.1综合服务平台1
3.2前置系统1
4符号和缩略语1
5修改原则1
5.1个人网银系统与综合服务平台要求2
5.1.1个人网银系统设计要求2
5.1.2综合服务平台设计要求2
5.2通讯连接方式2
6报文结构及使用说明2
6.1通信报文协议2
6.2传送路段代号说明2
6.3取值符号说明2
6.4数据类型说明3
6.5MAC的构成3
6.5.1报文数据元的选取3
6.5.2MAC块数据元的构成规则4
6.6报文结构说明4
6.6.1报文结构4
6.6.2报文头说明4
6.6.3位图的说明5
6.7报文格式异常5
6.7.1报文语法错误5
6.7.2报文语义错误6
6.7.3报文错误码6
6.8链路检测报文说明6
7报文数据域说明6
7.1报文数据域列表6
7.2消息类型7
7.3主帐号／卡号（位元２）8
7.4交易处理码（位元3）8
7.5交易金额（位元4）8
7.6渠道标识码（位元7）9
7.7流水号（位元11）9
7.8本地时间（位元12）9
7.9本地日期（位元13）9
7.10清算日期（位元15）9
7.11交易标志（位元20）10
7.12服务点进入方式（位元22）10
7.13服务点条件代码（位元25）11
7.14手续费1（位元28）11
7.15手续费2（位元29）11
7.16交易系统代码（位元32）11
7.17发信系统代码（位元33）12
7.18第二磁道数据（位元35）12
7.19第三磁道数据（位元36）12
7.20系统检索号（位元37）12
7.21响应码（位元39）12
7.22终端标识号（位元41）13
7.23交易局代码/受卡方标识码（位元42）13
7.24户名（位元43）13
7.25存折印刷号（位元46）13
7.26交易货币代码（位元49）13
7.27个人识别号（PIN）数据（位元52，个人网银不验密，此域不上送）14
7.28安全控制信息（位元53）14
7.29消息原因码（位元60）14
7.30证件信息（位元61）15
7.31附加个人标识号数据（位元62）15
7.32原始交易信息（位元90）15
7.33报文安全码（位元96）16
7.34接收系统代码（位元100）16
7.35转入号码（位元103）16
7.36对帐信息（位元121）16
7.37发起自定义数据（位元122）16
7.38应答自定义数据（位元123）16
7.39报文鉴别码（位元128）17
8交易定义17
8.1交易报文接口17
8.1.1管理通知类17
8.1.2加办类（代扣缴费）19
8.1.3代缴类24
8.1.4异常通知35
8.2交易流程35
8.2.1管理通知类35
8.2.2加办类36
8.2.3代缴类37
8.2.4异常通知37
附 录 A39
附 录 B40
附 录 C42
附 录 D47
附 录 E48
附 录 F49
1前言
本指导性文件依据“邮政储蓄银行个人网上银行系统技术方案”对涉及个人网银系统和综合服务平台之间的代理业务、代售业务、打印发票等方面的接口进行了规范。
本指导性文件的附录A、附录B、附录C、附录D、附录E、附录F为规范性附录。
本指导性文件由国家邮政局信息技术局提出。
本指导性文件起草单位：
国家邮政局信息技术局。
邮政储蓄个人网银系统与邮政综合服务平台接口技术规范
11 范围
本指导性文件规定了个人网银系统与邮政综合服务平台接口的定义、符号和缩略语、应用通信接口要求、报文格式、报文数据元说明、交易流程等内容。
本指导性文件适用于邮政储蓄个人网银系统与邮政综合服务平台之间接口软件的开发、测试和运行维护。
12 规范性引用文件
下列文件中的条款通过本指导性文件的引用而成为本指导性文件的条款。
凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本指导性文件，然而，鼓励根据本指导性文件达成协议的各方研究是否可使用这些文件的最新版本。
凡是不注日期的引用文件，其最新版本适用于本指导性文件。
GB/T2260-2002中华人民共和国行政区划代码
13 术语和定义
13.1 综合服务平台
综合服务平台是一套用于整合各类代缴、代售业务需求，完成与储蓄省中心、第三方合作单位等业务系统之间的数据交互，实现各类代缴、代售业务稳定、有效办理的功能完善、便于二次开发的平台化系统。
13.2 前置系统
前置系统包括电话银行系统及个人网银系统或ATM（自助终端）前置系统和POS前置系统等，它作为综合服务平台的一个交易渠道存在，负责处理终端设备的交易接入、报文转换和交易转发，并管理和监控相关的终端设备，另外还有相应的报表和统计功能。
14 符号和缩略语
以下符号和缩略语适用于本指导性文件。
ATM：
AutomaticTellerMachine，自动柜员机
DES：
DataEncryptStandard，数据加密标准
IP：
InternetProtocol，网间网协议
MAC：
MessageAuthenticationCode，报文鉴别码
PIN：
PersonalIdentificationNumber，个人识别号
POS：
PointOfSales，销售点终端
TCP：
TransmissionControlProtocol，传输控制协议
15 修改原则
此次网上缴费与电话银行缴费的区别：
✓通讯方式由原来的socket同步长连接，改为socket同步短连接。
✓网银交易无需上送账户密码，中间业务平台不需要对账户密码进行校验，转送储蓄统版系统时，填送无需校验密码标志。
✓网银渠道标识号使用16
✓增加了加办，撤办和加办查询3支交易。
可实现中间业务平台的代扣业务
✓加办、撤办和加办查询交易返回字段增加了“签约协议号”，另加办查询还增加“缴费编码备注”字段
✓代理缴费和预存缴费交易请求字段增加了“备注”字段，分别放在代理缴费122.7位元和预存缴费122.6位元
✓已缴费用查询交易返回字段增加了“中间业务流水号”和“备注”字段
✓代理缴费和预存缴费交易增加了“证件信息”（61位元）字段，该字段在信用卡消费时，根据业务需要选择上送
✓报文数据域列表中增加了户名字段，代扣缴费加办交易、应缴费用查询交易、预存余额查询交易增加了返回字段“户名”；代理缴费交易和预存缴费交易上送字段和返回字段都增加了户名（如果该缴费项目无户名，该字段则返回空）。
✓增加了6.8链路检测报文说明，用于实现检测个人网银和中间业务平台的链路功能。
✓增加了交易报文接口8.1.3.6合同号查询，用于通过中间业务平台查询缴费号码在第三方系统的合同号信息，供用户选择合同号，进行缴费或加办。
（该交易适用于某种缴费业务的缴费号码对应多个合同号的情况，进行查询显示，供用户选择合同信息，进行缴费或加办，根据各省实际情况，选择使用）
15.1 个人网银系统与综合服务平台要求
15.1.1 个人网银系统设计要求
个人网银系统按综合服务平台提供的IP地址和通信端口与综合服务平台进行报文的交互。
系统采用负载均衡模式，当某一节点发生故障时，可保证其仍按原IP地址和通信端口与综合服务平台通信。
15.1.2 综合服务平台设计要求
综合服务平台提供固定的IP地址和通信端口供个人网银系统接入。
对于实施了双机互备的系统，当一个节点出现故障而发生系统切换时，按照透明切换的原则，不会对综合服务平台和个人网银系统的通信连接产生影响，即个人网银系统仍按综合服务平台原IP地址和通信端口与综合服务平台进行通信。
15.2 通讯连接方式
由于采用负载均衡模式，通讯方式使用SOCKET同步短连接方式。
16 报文结构及使用说明
16.1 通信报文协议
个人网银系统与综合服务平台进行数据交换时，交易报文采用类ISO8583报文格式。
16.2 传送路段代号说明
AN：
交易的请求方。
IN：
交易的应答方。
16.3 取值符号说明
在报文格式的列表中采用以下表示方法：
M：
强制数据元（Mandatory），此数据元在该种报文中必须出现否则将被认为报文格式出错。
M+：
必须增加的数据元。
Cn：
条件数据元（Conditional），此数据元在报文中出现，但只在一定条件下有效。
在该种报文中，具体的条件请查阅每个列表后的条件数据元说明（为了方便，将某位元相对应的数据元用“某位元”描述）。
（n为特定的数字）。
Space：
此数据元在该种报文中不出现。
（N）：
此数据元可重置。
若某数据元未使用该符号，则除非该数据元在之前的路段上未出现，否则不可重置。
R：
必须与先前报文中对应数据元的值相同。
16.4 数据类型说明
Axx位定长的字母字符
A..x最大长度为x位的变长字母字符
ANxx位定长的字母和/或数字字符
AN..x最大长度为x位的变长字母和/或数字字符
ANSxx位定长的字母、数字和/或特殊符号字符
ANS..x最大长度为x位的变长字母、数字和/或特殊符号字符
ASxx位定长的字母和/或特殊符号字符
AS..x最大长度为x位的变长字母和/或特殊符号字符
B二进制位
DD日
hh时
LL可变长数据元的长度值（二位数）
LLL可变长数据元的长度值（三位数）
MM月
mm分
Nxx位定长的整型数值。
若表示金额，则最右二位为角分
N..x最大长度为x位的整型数值。
若表示金额，则最右二位为角分
Sxx位定长的特殊符号字符
S..x最大长度为x位的变长特殊符号字符
ss秒
VAR可变长数据元
X借贷符号，在数值之前，D表示借，C表示贷
YY年（2位）
YYYY年（4位）
Z由ISO7811和ISO7813制定的磁卡第二、三磁道的数据类型
特别说明：
对于定长的非数值型数据，一律左对齐，长度不足时右补空格。
对于定长的数值型（整型、实型）数据，一律右对齐，位数不足时左补零。
对于变长的数据，则表示为数据元长度+数据元值的形式。
16.5 MAC的构成
16.5.1 报文数据元的选取
对于需计算消息鉴别码的报文，以下数据元（见下表）只要出现，就应该包含在MAC计算中。
报文消息鉴别码计算一览表见附录F。
表1 MAC应计算的数据元表
NO.
位元
数据元名称
位数
1
消息类型
N4
2
2
主帐号／卡号
AN..19（LLVAR）
3
3
交易处理码
N6
4
4
交易金额
N12
5
11
流水号
N8
6
12
本地时间
N6
7
13
本地日期
N8
8
32
交易系统代码
AN11
9
33
发信中心代码
AN11
10
39
应答码
AN2
11
53
安全控制信息
N16
12
100
收信中心代码
AN11
13
103
转入号码
ANS..28（LLVAR）
其中：
a）主账号应根据长度来取。
内容为主账号长度
（2）+主账号；
b）安全控制信息仅用于更新密钥消息的MAC中。
c）转入号码应根据长度来取。
内容为转入号码长度
（2）+转入号码
16.5.2 MAC块数据元的构成规则
MAC数据元的选取将根据Bitmap中上述数据元是否出现在报文中来确定。
上述数据元只要出现在报文中，应截下送入MAC计算数据元；数据元和数据元之间应插入一个空格。
对所选择的MAC报文数据元，应进一步作字符处理。
除去一些冗余信息，以提高MAC的质量。
处理方法如下：
a）在数据元和数据元之间插入一个空格；
b）除了字母（A-Z，a-z），数字（0-9），空格，逗号（，）和点号（.）以外的字母都删去；
c）删去打头空格和结尾空格；
d）多于一个的连续空格，由一个空格代替；
e）将经过字符选择处理的数据按64Bit一块划分若干块，若最后一块的位数小于64Bit，则用0x00填满。
16.6 报文结构说明
16.6.1 报文结构
报文由四部分组成：
报文头，报文类型标识符，位图（Bitmap：
以表示各数据元的有无），及数据元。
报文结构如图1所示：
报文头
报文类型标识符
位图
数据元
图1 报文结构
16.6.2 报文头说明
a）报文头包含报文长度、系统ID、交易流水号、错误码等4个部分，共21个字节，结构见表2。
表2 报文头结构
1
2
3
4
报文长度
系统ID
交易流水号
错误码
1-2字节
3-9字节
10-17字节
18-21字节
注：
报文头中拒绝报文的错误码见附录B，成功交易应为全“0”。
b）报文头组成部分的描述
1）报文长度
指整个报文的长度（不包括报文长度本身这两个字节），采用十六进制数表示，共两个字节：
例如：
整个报文长度是256，那么报文长度中记录的数据就是256－2＝254，十六进制表示为：
0x000xFE。
2）系统ID
表示个人网银系统的ID号。
由系统内报文发起方置入，ID号为7位，是指该系统在储蓄省中心注册的平台号。
3）交易流水号
描述该笔交易流水号。
由个人网银系统产生，请求报文与响应报文中内容一致。
4）错误码
描述报文被拒绝的原因，由拒绝方置入。
编码见6.7“报文格式异常”和附录B；
16.6.3 位图的说明
报文中带有位图来标识报文中有哪些域而没有哪些域。
一个报文中可以有一个或两个：
第一和第二位图用于磁条卡/折交易，在这种情况下第一、第二可以同时出现。
本节描述这些位图。
报文头
报文类型标识符
位图
报文域
位图1=域2-64
位图2=域66-128
图2 位图说明
c）第一个位图
每一个报文都有主位图。
它是由64个二进制位（8个字节）构成，位于报文类型标识符之后。
除了第一位，每一位和一个域相对应，即和域2到域64相对应。
每位的值指示该域是否出现在报文中：
如果一个位为0，与之相关的域不出现在报文中
如果一个位为1，与之相关的域出现在报文中
域号是1的域不存在。
主位图的第一位用来指明在主位图后是否还有第二个位图，称为位图二。
位图二的说明见下节。
d）第二个位图
主位图的第一位指明了主位图后是否有第二个位图—－位图二。
和主位图相同，位图二也由64个二进制位（八字节）构成。
可以认为位图二是主位图的扩展，和域66到128相关。
报文域65不存在。
图3 第二位图说明
只有当报文中包含有域66到域128中的域，位图二才会使用到。
位图二紧接着主位图，并在报文域之前。
图3显示了位图二的位置和功能。
主位图的第一位是1表示位图二的存在。
如果位图中的哪一位为1，表示以该位序号为序号的域存在。
16.7 报文格式异常
16.7.1 报文语法错误
语法错误是接收到的报文格式不符合本指导性文件的报文格式说明。
一旦发生报文语法错误，向交易的发送方发送拒绝应答。
16.7.2 报文语义错误
报文语义错误是指接收到的报文中位元的取值范围或数据类型不符合本指导性文件的报文位元说明。
一旦发生报文语义错误，向交易的发送方发送拒绝应答。
16.7.3 报文错误码
对产生语法错误和语义错误的报文，将在应答消息中给出报文错误码。
报文错误码见附录B，其编码规则如下：
报文错误码由4位数字字符组成：
XXXY，其中：
——XXX为错误位元编号；
——Y为错误定义：
1-位元未定义
2-长度域中出现非法字符/长度域的长度值大于规定值
3-非法数字字符/非法值
4-缺少必要位元
16.8 链路检测报文说明
为了确保个人网银与综合服务平台链路的正常，保证链路异常时的快速应急处理，个人网银系统在设定的时间，会向综合服务平台发送探测报文，该报文不带任何附加数据，并置报文长度域的值为零。
综合服务平台收到这样的报文后，不做任何业务处理，直接给个人网银返回应答报文，该应答报文不带任何附加数据，并置报文长度域的值为零。
报文长度格式：
十六进制表示为：
0x000x00
当个人网银收到检测报文应答时，证明个人网银与综合服务平台链路正常。
17 报文数据域说明
17.1 报文数据域列表
报文数据域列表见表3。
表3 报文数据域列表
索引号
位元标识
位元名称
位元格式和长度
位元说明
MSGTYPE
消息类型
N4
消息类型
2
ACCOUNT
主帐号/卡号
AN..19（LLVAR）
客户的帐号或卡号
3
PCODE
交易处理码
N6
交易的标识代码
4
AMOUNT
交易金额
N12
7
CHNLNO
渠道标识码
AN2
用来区分不同交易渠道
11
SEQNO
流水号
N8
12
LOCALTIME
本地时间
N6（hhmmss）
交易时系统时间
13
LOCALDATE
本地日期
N8（YYYYMMDD）
交易时系统日期
15
CLEARDATE
清算日期
N8（YYYYMMDD）
帐务性交易参加清算的记帐日期
20
TXN_FLAG
交易标志
AN8
交易报文中指明交易属性或处理方法的标志
22
SERVENTRY
服务点进入方式
N3
交易发起时，系统采集帐户的方式
25
SERVCODE
服务点条件代码
N2
交易发起时的交易处理情况
28
FEE1
手续费1
N8
为处理交易的手续费预留
29
FEE2
手续费2
N8
为处理交易的手续费预留
32
TRANSINST
交易系统代码
AN11
交易系统代码
33
SENDINST
发信系统代码
AN11
发信系统代码
35
TRACK2DATA
第二磁道数据
Z..37（LLVAR）
以卡发起的交易中，卡的第二磁道数据信息
36
TRACK3DATA
第三磁道数据
Z...104（LLLVAR）
以卡发起的交易中，卡的第三磁道数据信息
37
RetrievalRefNbr
系统检索号
AN12
在POS交易和ATM跨行交易使用
39
RESPCODE
响应码
AN2
主机处理交易后给受理方的应答码。
41
TERMID
终端标识码
ANS8
发起交易的终端标识码
42
TRANBRANCH
交易局代码/受卡方标识码
ANS15
交易的交易局代码/受卡方标识码
43
CUSTNAME
户名
ANS..40（LLVAR）
客户的姓名
46
PRINTNO
存折印刷号
ANS10
存折的存折印刷号
49
CURRENCY
交易货币代码
AN3
交易的货币代码
156：
人民币
52
PINDATA
个人识别号（PIN）数据
B64
客户个人密码的密文
53
SECUINFO
安全控制信息
N16
报文加密的安全传输的控制信息
60
REASONCODE
消息原因码
N4
交易发起原因码
61
IDINFO
证件信息
ANS..22（LLVAR）
证件代码＋证件号码
61.1
PERSONID
证件代码
N2
61.2
PERSONCODE
证件号码
ANS..20
62
PINDATA1
附加个人识别号数据
B64
可存放新密码或新密钥
90
ORGDATA
原始交易信息
描述原始交易信息。
90.1
ORGMSGTYPE
原交易处理码
N6
90.2
ORGDATE
原本地日期
N8（YYYYMMDD）
90.3
ORGTIME
原本地时间
N6（hhmmss）
90.4
ORGCLRDATE
原清算日期
N8（YYYYMMDD）
90.5
ORGTRANSINST
原交易系统代码
AN11
90.6
ORGSEQNO
原流水号
N8
90.7
ORGAMOUNT
原交易金额
N12
96
KEYDATA
报文安全码
B64
用于存放新密钥
100
DESTINST
接收系统代码
AN11
121
ACCTCHK
对帐信息
ANS...999（LLLVAR）
对帐信息
122
FILLER1
发起自定义数据元
ANS...999（LLLVAR）
发起方请求报文中定义的扩展位元
123
FILLER2
应答自定义数据元
ANS...999（LLLVAR）
接收方响应报文中定义的扩展位元
128
MAC
报文鉴别码
B64
鉴别报文的合法性信息
17.2 消息类型
a）变量属性：
N4，4个字节的定长数字
b）描述：
报文类型标识符（MessageTypeIdentifier）由四位数字组成。
其含义见下表。
表4 报文类型标识符定义表
第1、2位置标识报文类型
含义
第3位置标识报文功能
含义
第4位置标识传输方式
含义
01
授权报文
0
普通请求
0
普通
02
金融交易报文
1
普通应答
1
重发
03
文件更新报文
2
通知请求
2
反向
04
撤销报文
3
通知应答
05
对帐控制报文
06
管理报文
07
ISO保留
08
网络管理报文
09-79
ISO保留
80-89
国家保留
90-99
民间保留
c）用法：
见附录E。
17.3 主帐号／卡号（位元２）
a）变量属性：
AN..19（LLVAR），两位长度值＋最大19个字节的变长数字和/或字母字符串。
b）描述：
用来进行交易的主帐号或卡号，即通过刷磁条方式获取或手工输入的用户帐号或卡号。
c）用法：
对持卡交易，个人网银系统必须从客户磁卡的第二磁道或第三磁道上截取帐号后，填入此数据元。
对一些特定的交易，交易局可根据用户输入的主帐号信息填写此数据元。
17.4 交易处理码（位元3）
a）变量属性：
N6，6个字节的定长数字
b）描述：
交易处理码（ProcessingCode）由六位数字组成。
第1和第2位置固定为“88”；第3位置表示交易类别；第5位置表示交易序号；第4、6位置保留。
交易处理码定义表见表5。
表5 交易处理码定义表
交易处理码
字节
代码
含义
代码
含义
代码
含义
1、2
升级会员 