403041-IC卡系统-前置子系统-概要设计(v1.0.0)2

403041-IC卡系统-前置子系统-概要设计(v1.0.0)2 石家庄商业银行卡系统,前置子系统 概要设计说明书 V1.0.0 石家庄商业银行 上海华腾软件系统有限公司 二零零四年一月 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 修订控制页 章修订节已评章节名称 修订内容简述 修订日期 前版拟稿人 编审 本号 号 初稿 2003-8-11 王建文 修改稿 2004-1-28 俞海宏 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 1 引言 1.1 概述 本文档是石家庄商业银行卡前置系统的概要设计说明书，主要描述了石家庄商行卡前置系统的结构、实现方式等内容，文档的主要阅读者为系统开发人员、系统设计人员和石家庄商业银行与项目相关的科技人员。 1.2 定义 本章节对本设计中采用的主要术语进行描述和说明，以避免歧义。 术 语 说 明 IC卡 集成电路卡的简称，本需求书中指具有计算功能的CPU卡 PSAM卡 终端安全认证模块，用来对用户卡进行安全认证 PBOC 中国人民银行颁布的金融IC卡标准 ATM 自动取款机 POS 消费终端 PIN 用户鉴别码 DES 一种广泛采用的数据加密算法 MAC 交易认证码 Teller 银行网点的交易终端 前置 一卡通业务系统 Host 银行综合业务系统 存储在IC卡上的小额支付工具，支持脱机交易，进行脱机消费 电子钱包 时无需校验PIN，不支持挂失，不计息 存储在IC卡上的支付工具，支持脱机交易，需要校验PIN，可 电子存折 挂失，计活期利息 公用钱包 采用PBOC标准可跨行、跨地区、跨行业使用的电子钱包 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 公用存折 采用PBOC标准可跨行、跨地区、跨行业使用的电子存折 专用钱包 只能应用于某个行业应用或地区应用的电子钱包 用户卡 向社会公开发行的实现支付和管理功能的IC卡 母卡 用来进行密钥管理的特定的IC卡 加密机 提供数据加、解密功能的硬件设备 密钥分散 由主密钥推导出子密钥的加密过程 分散因子 用于进行密钥分散的参数 圈存 将一定数量资金由主账户转入IC卡电子钱包、电子存折的操作 圈提 将一定数量资金由电子存折转入主账户的操作 圈存机 提供对IC卡进行圈存、圈提等联机交易功能的终端 预制卡 根据卡部，预制一批没有客户信息的IC卡的过程 实时发卡 先进行预发卡，然后实时进行用户信息更新和卡启用的发卡方式 获取用户信息后，一次进行密钥装载、用户信息更新和卡启用的批量开卡 发卡方式 补卡 用户IC卡遗失后，重发一张新卡的操作，必须先进行卡挂失 换卡 用户IC卡损坏后，重发一张新卡的操作，必须先进行卡回收 1.3 设计依据 本文档设计时主要参考和依据的文档包括: , 《石家庄商业银行IC卡需求分析v3.0》 , 《TOPSmartAgent中间业务平台使用v2.0.1》 , 《中间业务平台详细设计说明书v1.0.3》 , 《中国集成电路(IC)卡》 , 《金融IC卡前置总体设计方案v4.0.3》 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 2 结构设计 2.1 前置系统逻辑结构 石家庄商业银行卡系统所涉及到的金融IC卡交易、部分卡管理交易以及城市一卡通应用通过前置系统进行预处理，其它的业务采用原有的方式(从网点直接到综合业务系统)进行处理，系统逻辑结构图如下所示: 柜台操作平台 燃气应用出租应用其它应用网点系统(Smart Teller) TuxedoTCP/IP客户端 一卡通管理平台 IC卡务管理机构管理清算和对帐TTCuPx/eTuxedo 服务端行业信息管IdPo费率管理安全、通讯理 综合业务系统TCP/IP 硬件加密机一卡通平台数据库 综合业务系统数据库 图表 2-1 系统逻辑结构图 说明: , 前置机的软件架构在基于TopSmartAgent(SA) 中间业务平台 , 前置机系统与网点连接方式采用TCP/IP协议(长连接) , 前置机与综合业务主机的通信方式基于Tuxedo中间件通信 , 前置机与加密机的连接方式为TCP/IP连接(长连接) , 前置机与机构的连接为TCP/IP连接 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 2.2 卡前置系统软件架构 HSM API TuxedoTCP/IPClient TopSmartAgent AIX 图表 2-2 一卡通平台软件架构 说明: , 前置系统运行平台为AIX(操作系统) + Tuxedo(客户端) + SA(中 间平台) + 加密通信接口 , 前置软件处理各种业务为并发进行，为了提高系统性能，在进行设 计时要考虑防止消息堵塞 2.3 通讯和数据流 2.3.1 与网点的连接 前置软件架构在SA平台之上，其与网点的连接方式采用TCP/IP基础之上，前置软件不采用超时保护，所有网络通信的超时保护全部在网点发起方进行保护，采用的报文格式如下所述，网点与前置软件的交易的一致性保护采用查询和取消交易的方式来实现。 2.3.1.1 网点请求报文基本字段 网点与一卡通系统的交易报文包括基本字段和扩展字段两部分，网点系统基于SmartTeller，考虑到新增的IC卡交易与原有交易的一致性(原有交易通过Tuxedo客户端直联主机，IC卡交易通过Tcp/IP发送到前置系统)，因此，网点向前置的请求报文的通用字段定义与原交易的通用字段定义相同，也与前置向 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 Host请求的通用字段定义相同(参考主机TITA Lable结构定义)。 网点向前置请求报文的基本字段的定义如下表所示: 名称 长度 格式 2 Char 原交易终端号 7 Char 原交易流水号 3 Char 开户行号 3 Char 交易行号 2 Char 交易终端号 7 Char 交易终端流水号 2 Char 交易大类 1 Char 终端类型 4 Char 交易代码 1 Char 取消标志 2 Char 主管授权标志 6 Char 操作员号 6 Char 主管柜员号 6 Char 授权柜员号 7 Char 授权流水号 6 Char 密码 1 Char 存折标志 1 Char 连续交易标志 6 Char 连续交易号 图表 2-3 网点请求通讯报文基本字段 2.3.1.2 向网点返回报文基本字段 基于原有交易和IC卡交易的一致性考虑，前置向网点的返回报文基本字段 与Host向网点返回报文基本字段相同(参考主机TOTW Laber 结构定义)，具体 内容如下表所示: 名称 长度 格式 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3 Char 交易行号 2 Char 交易终端号 7 Char 终端流水号 2 Char 交易大类 8 Char 交易日期 9 Char 交易时间 1 Char 消息结束标志 1 Char 消息类型 4 Char 消息号 4 Char 消息长度 图表 2-4 网点返回报文基本字段 2.3.2 与机构的连接 与机构的连接可以采用TCP/IP通信方式，命令采用消息驱动的方式来触发，卡前置系统与机构连接的通讯方式和报文格式可参考相关行业系统实现文档。 2.3.3 与综合业务主机通信模块 通信方式采用TUXEDO客户端连接到TUXEDO服务端的方式，通信的报文采用华腾自己定义的格式通信，前置与综合业务主机采用异步方式进行通讯，事务触发采用消息方式，即向主机发送申请和接收主机返回处理是两个流程，前置向主机发起交易请求后，并不等待主机返回而直接退出处理，主机的返回消息作为一个事件触发前置系统，前置系统经过消息匹配获得主机返回信息，进入相应的处理流程进行处理。 与综合业务主机通讯报文包括基本字段和扩展字段，其基本字段的内容定义如下表所示: 名称 长度 格式 2 Char 原交易终端号 7 Char 原交易流水号 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3 Char 开户行号 3 Char 交易行号 2 Char 交易终端号 7 Char 交易终端流水号 2 Char 交易大类 1 Char 终端类型 4 Char 交易代码 1 Char 取消标志 2 Char 主管授权标志 6 Char 操作员号 6 Char 主管柜员号 6 Char 授权柜员号 7 Char 授权流水号 6 Char 密码 1 Char 存折标志 1 Char 连续交易标志 6 Char 连续交易号 图表 2-5 与主机通讯报文基本字段 主机返回报文基本字段定义如下表所示: 名称 长度 格式 3 Char 交易行号 2 Char 交易终端号 7 Char 终端流水号 2 Char 交易大类 8 Char 交易日期 9 Char 交易时间 1 Char 消息结束标志 1 Char 消息类型 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 4 Char 消息号 4 Char 消息长度 图表 2-6 主机返回报文基本字段 2.3.4 与加密机器通信 系统软件架构参见< 2.1 IC卡前置系统软件架构>部分，由于加密机属于前置机器的一部分，他们组成在一个局域网内，考虑到SA系统的消息转发机制运用，以及每个消息都需要MAC校验，因此对加密机的使用采用API 的方式进行通信，由此API负责对加密机通讯线路的建立。 调用流程如下所示: SA 调用API加密机驱动控制层 API内部发送报文到加密机 函数调用等待加密机返回从加密机接收返回 返回脚本上层 图表 2-7 加密机调用流程 说明: SA调用加密机的过程采用同步机制，也就是说,SA必须等待加密机的返回，否则超时返回。加密机提供相应的API库供SA所使用，如果希望采用动态管理不同的加密机器的使用，需要提供一套加密机作业队列的管理应用。 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3 交易流程描述 3.1 综述 石家庄商行卡系统中，所有经过前置系统的交易汇总如下: 交易名称 交易码 信息流 说明 8437 个人发卡登记 网点,前置,主机 个人申请开卡(含IC) 8436 批量发卡登记 网点,前置,主机 集团申请开卡(含行业应用) 8438 发卡申请维护 网点,前置,主机 发卡申请维护(含行业应用) 8406 个人领卡激活 网点,前置,主机 8410 补换卡 网点,前置,主机 8460 卡挂失 网点,主机,前置 进行黑名单处理 8461 卡解挂 网点,主机,前置 进行黑名单处理 8413 开户 网点,前置,主机 电子存折、行业应用开户 8462 PIN解锁 网点,前置 8463 PIN重装 网点,前置 8415 电子存折圈提 网点,前置,主机 8416 圈存 网点,前置,主机 8417 电子存折取现 网点,前置,主机 8418 行业充资 网点,前置,主机 8420 黑名单管理 卡部,前置 8421 脱机明细输单 网点,前置,主机 8423 加密机密钥维护 网点,前置 8481 代理机构管理 网点,前置 8482 代理品种管理 网点,前置 8483 机构、品种管理 网点,前置 8485 费率管理 网点,前置 8487 燃气充资信息查询 网点,前置 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 8419 燃气充资 网点,前置 8471 脱机交易明细上传 网点,前置 3.2 发卡及卡务管理 3.2.1 批量开卡(8436、8473) 批量开卡采用先申请、后制卡、再领卡的发卡模式，网点进行用户批量开卡信息录入，产生开卡申请文件(通过8436交易完成)，并将此文件提交给前置系统，前置对申请信息进行处理后提交给业务主机，业务主机根据批量开卡文件内容，进行客户信息添加并产生申请书号，主机在日终批量时产生发卡文件，将此文件传递给前置，前置根据此文件内容，加上行业信息内容，生成发卡文件，由发卡系统根据发卡文件内容进行卡片个人化，实现发卡。 3.2.1.1 操作流程 HostTimeTellerICP 开卡信息录入 开卡信息文件上传 文件处理 开卡文件上传 进入批量 产生主机批量发卡文件在制卡文件中加入行 业信息(预留，目前 不使用生成制卡文件 图表 3-1 批量开卡操作流程 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 批量发卡登记流程说明: 1. 网点输入用户发卡信息(包括行业信息)，保存在文件中 2. Teller发起批量开卡交易，将相应信息文件发送给前置机 3. 前置机对批量文件进行处理，保存相应的行业信息，向主机传递批量文 件 4. 主机对发卡文件处理，登记客户信息(如果是新客户，产生客户号)， 计算应收取的卡片押金，将相关信息返回给前置 5. 前置将卡片押金返回给网点，网点收取押金，交易完成 批量发卡操作流程: 1. 主机日终批量时对申请信息进行处理，开通相关的客户账户，产生卡号， 并将相应信息计入发卡文件中，将此文件传递给前置 2. 前置对主机下传的发卡文件进行处理，在文件中添加相应的行业信息， 生成最终的发卡文件，并提交给发卡系统 3.2.1.2 异常流程 如果前置系统在指定的时间内收不到主机的任何响应，前置系统进入超时处理，向主机发送取消交易，主机对卡片押金信息和发卡登记信息进行恢复处理。 3.2.1.3 联动交易 批量开卡成功后，系统打印相应的单据，并统一收取客户卡片押金。 3.2.1.4 交易码 批量发卡由两个交易完成，卡片信息录入交易和批量开卡交易，交易说明如下表所示: 名称 交易码 类别 说明 8436 开卡信息录入 管理类交易 录入行业应用信息保存在文件中 8473 批量开卡登记 发卡类交易 上传信息文件，进行卡片押金处理 Bh8433 批量开卡(主机) 主机日终批量 产生主机批量发卡文件 Bh8433 批量开卡(前置) 前置日终批量 产生最终批量发卡文件 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.2.1.5 报文内容 网点向前置的请求报文 Teller向前置的请求报文的基本字段内容，请参见本文档网点连接部分 Teller(网点)向前置(一卡通系统)的请求报文的扩展字段如下表所示: 名称 长度 格式 60 Char 单位名称 100 Char 开卡信息文件名称 前置向主机的请求报文 前置向主机的请求报文的扩展字段内容如下表所示: 名称 长度 格式 60 Char 单位名称 100 Char 开卡信息文件名称 主机向前置返回报文 主机向前置返回报文扩展字段定义如下表所示: 名称 长度 格式 10 Char 申请书号 7 Char 交易流水号 14 Char 手续费金额 前置向Teller返回报文 前置向Teller返回报文的基本字段内容，请参见文档与网点通讯部分，前置向Teller返回报文扩展字段内容与主机向前置返回内容相同: 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.2.1.6 处理流程 终端的请求消息处理: 1. TPLGetMessage截取上送柜台消息; 2. 调用CheckMsgMac校验MAC; 3. 申请一个新的流水号，登记超时; 4. 将上送的信息插入到银行请求消息表(调用AgtInsBnkMsg函数，记录 支行号和终端号等信息); 5. 调用AgtAddSeqNo给终端上传的单位申请文件中的每一条记录增加9 位的顺序号; 6. 调用online_instbthcard将文件上传给主机; 7. 在交易明细表(agtxndtl)中插入一条交易明细;状态为resp_code = “??”, agn_resp_code = “??”, rvsl_flg = “0”; 8. 组包向主机发送补换卡交易的请求;注意交易流水号(EJFNO)为“0” +平台流水号(6位)，原交易流水号为这笔交易的终端流水号。 主机成功应答: 1. 将交易状态修改为resp_code = “00”, agn_resp_code = “00”, rvsl_flg = “0”; 2. 调用AgtSelAGBNKMSG恢复SessionHead; 3. 调用AgtBhInsCltAth将文件中每一条记录的行业信息插入到客户协议 信息表中。 4. 组包向终端发送应答。 主机失败应答: 1. 恢复交易明细，将交易状态修改为resp_code = “～～”, agn_resp_code = “～～”, rvsl_flg = “0”; 2. 调用AgtSelAGBNKMSG恢复SessionHead; 3. 组包向终端发送应答。 超时处理: 1. 向网点发送主机系统超时，交易失败应答 2. 修改交易状态，申请超时交易流水号，将超时交易流水置为原交易充正 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 流水 3. 将原交易流水置为充正交易的充正流水 4. 登记系统存储转发表 5. 向帐务主机发起充正交易 主机充正交易正确返回处理: 1. 通过主机返回的原交易流水号获得充正交易信息 2. 修改充正交易状态 3. 解除充正交易存储转发 主机充正交易错误返回处理: 1. 通过主机返回的原交易流水号获得充正交易信息 2. 修改充正交易状态 3. 解除充正交易存储转发 3.2.2 个人开卡登记(8437) 个人开卡登记实现单个用户到银行网点申请发行银行卡的功能，用户到银行网点申请发行银行卡，系统登记用户信息，并在日终批量时产生发卡文件，发卡系统根据发卡文件内容进行卡片个人化。用户在登记发卡的网点进行卡片领用。 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.2.2.1 操作流程 网点前置主机时间 提交开卡申请 提交开卡申请 开卡信息处理 返回申请书号 登记申请书号 返回开卡结果 进行日终批量 产生主机批量发卡文件 添加行业信息，生成最终发卡文件 图表 2 发卡登记操作流程 流程说明: 1. 申请书号是用户进行开卡登记的重要信息，前置系统保存用户开卡登记的申 请书号可以实现用户行业应用登记信息(通过8438交易)和开卡信息的关 联，用户可以在开卡登记成功后，继续进行行业应用登记申请，这样，发卡 文件中不仅包括金融应用内容，而且包含行业应用内容 3.2.2.2 联动交易 个人开卡申请成功后，系统联动收取卡片押金交易，进行卡片押金处理。 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.2.2.3 通讯报文 网点向前置的请求报文 Teller向前置的请求报文的基本字段内容，请参见本文档网点连接部分 Teller(网点)向前置(一卡通系统)的请求报文的扩展字段如下表所示: 名称 长度 格式 2 Char 卡片类型(打名、非打名) 20 Char 客户号 20 Char 客户姓名 20 Char 拼音姓名 2 Char 证件种类 20 Char 证件号码 前置向主机的请求报文 前置向主机的请求报文的扩展字段内容与网点向前置请求报文扩展字段内容相同。 主机向前置返回报文 主机向前置返回报文扩展字段定义如下表所示: 名称 长度 格式 10 Char 申请书号 20 Char 客户号 7 Char 交易流水号 前置向Teller返回报文 前置向Teller返回报文的基本字段内容，请参见文档与网点通讯部分，前置 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 向Teller返回报文扩展字段内容与主机向前置返回内容相同: 3.2.2.4 处理流程 终端的请求消息处理: 1. TPLGetMessage截取上送柜台消息; 2. 调用CheckMsgMac校验MAC; 3. 申请一个新的流水号，不登记超时; 4. 将上送的信息插入到银行请求消息表(调用AgtInsBnkMsg函数，记录支行 号和终端号等信息); 5. 在交易明细表(agtxndtl)中插入一条交易明细;状态为resp_code = “??”, agn_resp_code = “??”, rvsl_flg = “0”; 6. 组包向主机发送个人开卡交易的请求;注意交易流水号(EJFNO)为“0”+ 平台流水号(6位)，原交易流水号为这笔交易的终端流水号。 主机成功应答处理: 1. 将交易状态修改为resp_code = “00”, agn_resp_code = “00”, rvsl_flg = “0”; 2. 调用AgtInsAppnoChk在开卡申请检查表中登记这笔申请书号的信息; 3. 调用AgtSelAGBNKMSG恢复SessionHead; 4. 组包向终端发送应答。 3.2.3 个人行业应用登记(8438) 客户可以在成功进行个人开卡登记(8437)后通过此交易申请行业应用，系统保存用户行业信息，并将需要写入IC卡上的信息通过发卡文件传递到发卡系统。 由于不同的行业信息有很大区别，因此个人行业应用登记交易嵌套了一些具体行业信息输入的交易，这些交易以843X来代表，如843E、843F等，在成功保存了用户申请的所有行业信息后，前置将申请提交到业务主机，业务主机对需要在保存相应的需要开通的账户信息，在批量开卡时，开通相应的账户。 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.2.3.1 交易流程 网点前置后台 输入开卡申请书号 输入行业1信息前置在日终批量时获得主机发卡文件(包含金融信保存行业1信息息和用户申请书号)，将系统保存的行业信息并入主机发卡文件中，形成最输入行业2信息终的发卡文件提交给发卡保存行业2信息系统。。。 登记行业开户申请 日终批量时将行业信息并入发卡文件 图表 3 行业应用登记流程 交易流程说明: 1. 网点首先提交用户基本信息和用户开卡登记申请书号，系统以此申请书号作 为关键字将金融信息和行业信息进行关联，申请书号通过个人开卡申请交易 (代码为8437)获得 2. 按照用户选择的行业应用类别输入行业应用信息，前置将用户信息保存在 “客户代理业务协议表”中 3. 网点逐个输入用户申请的行业信息，直至输入所有的申请信息 4. 网点向前置提交行业应用开通申请，前置将申请提交到后台进行登记 3.2.3.2 关联交易 根据用户申请，此交易会关联一个或多个行业应用信息录入交易，这些交易不能单独发起，只能通过此交易在选择相应的行业应用时进行触发。 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.2.3.3 通讯报文 行业信息录入通讯报文 由于不同的行业机构所需要输入的信息有很大差别，因此无法统一行业信息录入报文，具体录入报文结构另行约定。 网点向前置的请求报文 Teller向前置的请求报文的基本字段内容，请参见本文档网点连接部分 Teller(网点)向前置(一卡通系统)的请求报文的扩展字段如下表所示: 名称 长度 格式 2 Char 卡片类型(打名、非打名) 19 Char 卡号,, 20 Char 客户号 10 Char 开卡申请书编号 60 Char 单位名称 20 Char 客户姓名 前置向主机的请求报文 前置向主机的请求报文的扩展字段内容与网点向前置请求报文扩展字段内容定义如下: 名称 长度 格式 2 Char 卡片类型(打名、非打名) 19 Char 卡号,, 20 Char 客户号 7 Char 平台流水号 10 Char 开卡申请书编号 60 Char 单位名称,, 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 20 Char 客户姓名 20 Char 应用申请内容 主机向前置返回报文 主机向前置返回报文扩展字段定义如下表所示: 名称 长度 格式 20 Char 客户号 20 Char 客户姓名 7 Char 交易流水号 前置向Teller返回报文 前置向Teller返回报文的基本字段内容，请参见文档与网点通讯部分，前置向Teller返回报文扩展字段内容与主机向前置返回内容相同: 3.2.3.4 处理流程 终端的请求消息处理: 1. TPLGetMessage截取上送柜台消息; 2. 调用CheckMsgMac校验MAC; 3. 申请一个新的流水号，不登记超时; 4. 将上送的信息插入到银行请求消息表(调用AgtInsBnkMsg函数，记录支行 号和终端号等信息); 5. 在交易明细表(agtxndtl)中插入一条交易明细;状态为resp_code = “??”, agn_resp_code = “??”, rvsl_flg = “0”; 6. 调用AgtSelCLTATHACT返回当前卡片所对应的所有帐户类型(行业类型); 7. 组包向主机发送行业应用登记交易的请求;注意交易流水号(EJFNO)为“0” +平台流水号(6位)，原交易流水号为这笔交易的终端流水号。 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.2.4 领卡、激活(8406) 用户在已登记发卡，发卡系统已实现了用户卡个人化，用户到登记网点进行卡片领取和启用的过程称为卡片领用，激活针对批量领卡方式，经过批量领卡的用户卡，必须由持卡人到网点进行卡片激活后，才能正常使用。 系统提供如下几种方式实现卡片的申请、发卡和领用: 1. 个人开卡登记(8437)――个人行业应用登记(8438，可选)――领卡 2. 批量开卡登记(8436)――批量领卡(8407)――激活(8406) 3. 批量开卡登记(8436)――领卡(8406) 3.2.4.1 交易流程 网点前置主机 申请领卡 卡领用处理 成功 行业应用处理 成功 3.2.4.2 异常流程 卡领用涉及对卡片的凭证管理，卡片凭证在后台采用表外帐进行管理，因此为了保证数据的一致性，对此交易进行超时保护，前置超时向后台发起充正交易。 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.2.4.3 通讯报文 网点向前置的请求报文 Teller向前置的请求报文的基本字段内容，请参见本文档网点连接部分 Teller(网点)向前置(一卡通系统)的请求报文的扩展字段如下表所示: 名称 长度 格式 19 Char 卡号 10 Char 开卡申请书编号 20 Char 客户姓名 2 Char 证件种类 20 Char 证件号 1 Char 领卡类型 1 Char 密码类型 8 Char 密码 前置向主机的请求报文 前置向主机的请求报文的扩展字段内容与网点向前置请求报文扩展字段内容相同。 主机向前置返回报文 主机向前置返回报文扩展字段定义如下表所示: 名称 长度 格式 20 Char 客户号 20 Char 客户姓名 7 Char 交易流水号 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 前置向Teller返回报文 前置向Teller返回报文的基本字段内容，请参见文档与网点通讯部分，前置向Teller返回报文扩展字段内容与主机向前置返回内容相同: 3.2.4.4 处理流程 终端的请求消息处理: 1. TPLGetMessage截取上送柜台消息; 2. 调用CheckMsgMac校验MAC; 3. 申请一个新的流水号，登记超时; 4. 将上送的信息插入到银行请求消息表(调用AgtInsBnkMsg函数，记录支行 号和终端号等信息); 5. 在交易明细表(agtxndtl)中插入一条交易明细;状态为resp_code = “??”, agn_resp_code = “??”, rvsl_flg = “0”; 6. 组包向主机发送补换卡交易的请求;注意交易流水号(EJFNO)为“0”+平 台流水号(6位)，原交易流水号为这笔交易的终端流水号。 主机成功应答处理: 1. 恢复交易明细表中的这条交易数据;判断交易状态，如果rvsl_flg 不等于 “0” 则表示此交易已经被冲正，此应答是一个迟到应答，平台将调用 Req84**FromHostTimeoutFun函数进行异常处理。 2. 如果非迟到应答，则解除超时登记; 3. 将交易状态修改为resp_code = “00”, agn_resp_code = “00”, rvsl_flg = “0”; 4. 根据卡号查询用户行业应用信息，修改行业应用状态为已启用状态 5. 调用AgtSelAGBNKMSG恢复SessionHead; 6. 调用FillVarNorToDevAndSend组包向终端发送应答。 平台超时处理 1. 恢复交易明细，判断交易状态如果为状态为rvsl_flg 不等于 “0”并且 resp_code 不等于 “??”，则表示此交易已经被冲正无须平台处理，平台直接 退出。 2. 如果交易没有被冲正则先向终端返回超时应答; 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3. 重新申请一个冲正交易流水号; 4. 修改原交易状态为resp_code = “～～”, agn_resp_code = “～～”, rvsl_flg = “1”; 在交易明细表中插入冲正交易的明细，状态为resp_code = “??”, agn_resp_code = “??”, rvsl_flg = “0”; 5. 组包向主机发送冲正交易，注意EJFNO = "0" + 终端流水号，HEJFNO = "0"+平台原交易流水号; 6. 登记存储转发表，进行冲正交易的存储转发; 3.2.5 卡挂失、解挂(8460/8461) 用户在IC卡遗失后，对IC卡申请挂失的操作，挂失包括口头挂失(含电话挂失)和书面挂失两种类型，口头挂失一定时间后会自动失效，此处所说的卡挂失指书面挂失，即用户到银行网点提交挂失申请后进行的挂失。 IC卡挂失后系统即将此卡计入黑名单，由于IC卡支持脱机交易，因此IC卡的挂失期比较长，目前采用45天，在挂失期内的黑名单卡脱机交易进行清算，超过挂失期的黑名单卡不进行清算，损失由商户或收单行承担。 卡解挂是卡挂失的逆向操作，执行卡解挂后，系统从黑名单表中删除此卡号，并将黑名单删除信息下发给终端。 3.2.5.1 交易流程 卡挂失、解挂处理流程如下表所示: 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 网点前置主机 申请卡挂失、解挂 成功 挂失、解挂申请 进行黑名单处理 返回处理结果 图表 3-4 挂失、解挂流程图 操作流程: 1. 考虑到与原有交易的一致性，挂失、解挂交易网点首先发送给主机，主 机进行成功的挂失、解挂交易处理后，网点再将申请发送给后台 2. 前置进行黑名单处理，计入黑名单流水表，并将处理结果返回给Teller， 挂失交易和解挂交易均计入黑名单，挂失计入黑名单添加，解挂计入黑 名单删除。 3.2.5.2 联动交易 卡挂失、解挂交易成功完成后，由Teller触发收取手续费交易，收取挂失、解挂交易手续费。 3.2.5.3 报文内容 网点向主机挂失、解挂申请报文 网点向主机挂失、解挂申请报文内容与现有综合业务系统相同，详见综合业务系统相关文档。 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 卡挂失Teller请求报文扩展字段 Teller请求报文扩展字段内容如下表所示: 名称 长度 格式 1 Char 交易类型 19 Char 卡号 3.2.5.4 库表结构 卡挂失、卡解挂交易涉及到系统对黑名单的管理，卡挂失需要将卡号加入黑名单中，相反，卡解挂需要将相应卡号从黑名单中删除，因此涉及到的数据库表主要包括黑名单信息表和黑名单查询表，黑名单查询表用来保持系统的黑名单，黑名单信息表用来保存系统黑名单的变化情况。黑名单信息表和黑名单明细表的详细内容，在本文档的数据库设计部分有详细的说明。 3.2.6 补、换卡(8410) 补卡指用户IC卡遗失后，经过挂失处理，再超过卡挂失期后补发新卡的操作，换卡指用户IC卡物理损坏，申请换卡的操作，在进行补、换卡交易前用户必须进行补、换卡登记(8409)交易。 3.2.6.1 流程图 补、换卡交易操作流程图如下所示: 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 网点前置主机 申请补换卡 申请补、换卡 成功返回 进行补换卡处理 返回 图表 3-5 补、换卡流程图 3.2.6.2 异常交易 补、换卡交易涉及到对补、换卡凭证的处理和表外记账，因此SA需要登记充正流水，并在超时时向后台发送充正交易。 3.2.6.3 联动交易 补、换卡交易成功完成后，由Teller触发收取手续费交易，收取挂失、解挂交易手续费。 3.2.6.4 报文内容 补、换卡Teller申请报文扩展字段 补、换卡Teller向前置请求报文扩展字段如下表所示: 名称 长度 格式 19 Char 原卡号 19 Char 新卡号 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 10 Char 补换卡登记申请书号 20 Char 姓名 2 Char 证件类型 20 Char 证件号码 1 Char 补换卡类型 1 Char 密码类型 6 Char 密码 8 Char 新密码 图表 3-6 补换卡Teller请求报文扩展字段 补、换卡前置申请报文扩展字段 补换卡前置请求报文扩展字段与Teller申请报文的扩展字段相同。 补、换卡Host向前置返回报文扩展字段 补、换卡交易，Host向前置返回报文扩展字段如下表所示: 名称 长度 格式 20 Char 客户号 20 Char 客户姓名 7 Char 交易流水号 图表 3-7 补、换卡Host返回报文扩展字段 补、换卡前置向网点返回报文扩展字段 补、换卡交易，前置向网点返回报文扩展字段如下表所示: 名称 长度 格式 20 Char 客户号 20 Char 客户姓名 7 Char 交易流水号 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 20 Char 应用申请内容 图表 3-8 前置向网点返回报文扩展字段 3.2.6.5 处理流程 终端的请求消息处理: 1. 调用TPLGetMessage截取上送柜台消息; 2. 调用CheckMsgMac校验MAC; 3. 判断这笔交易的类型，如果是终端发起的冲正交易则进入DevRsvRes 函数(稍后说明)处理。否则继续进行正常处理。 4. 申请一个新的流水号，并且登记超时; 5. 将上送的信息插入到银行请求消息表(调用AgtInsBnkMsg函数，记录支 行号和终端号等信息); 6. 在交易明细表(agtxndtl)中插入一条交易明细;状态为resp_code = “??”, agn_resp_code = “??”, rvsl_flg = “0”; 7. 组包向主机发送补换卡交易的请求;注意交易流水号(EJFNO)为“0” +平台流水号(6位)，原交易流水号为这笔交易的终端流水号。 主机成功应答: 1. 交易明细表中的这条交易数据;判断交易状态，如果rvsl_flg 不等于 “0”则表示此交易已经被冲正，此应答是一个迟到应答，平台将调用 Req84**FromHostTimeoutFun函数进行异常处理。 2. 如果非迟到应答，则解除超时登记; 3. 将交易状态修改为resp_code = “00”, agn_resp_code = “00”, rvsl_flg = “0”; 4. 调用AgtSelCLTATHACT函数取出新卡对应的所有行业应用(帐户类 型)，通过卡号和帐户类型对应每条行业信息(在agcltath中记录)，将 每条记录的状态修改为启用状态，。 5. 调用AgtSelAGBNKMSG恢复SessionHead; 6. 调用FillVarNorToDevAndSend组包向终端发送应答。 主机失败应答: 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 1. 解除超时登记; 2. 恢复交易明细，将交易状态修改为resp_code = “～～”, agn_resp_code = “～～”, rvsl_flg = “0”; 3. 调用AgtSelAGBNKMSG恢复SessionHead; 4. 调用FillVarErrToDevAndSend组包向终端发送应答。 平台超时处理 1. 恢复交易明细，判断交易状态如果为状态为rvsl_flg 不等于 “0”并且 resp_code 不等于 “??”，则表示此交易已经被冲正无须平台处理，平台 直接退出。 2. 如果交易没有被冲正则先向终端返回超时应答; 3. 重新申请一个冲正交易流水号; 4. 修改原交易状态为resp_code = “～～”, agn_resp_code = “～～”, rvsl_flg = “1”;在交易明细表中插入冲正交易的明细，状态为resp_code = “??”, agn_resp_code = “??”, rvsl_flg = “0”; 5. 组包向主机发送冲正交易，注意EJFNO = "0" + 终端流水号，HEJFNO = "0"+平台原交易流水号; 6. 登记存储转发表，进行冲正交易的存储转发; 终端发起的冲正交易 1. 恢复银行请求明细表将原交易的平台流水号取出来，通过流水号恢复原 交易的明细，如果判断原交易已经冲正则直接返回终端已冲正的应答; 否则申请新的冲正交易流水号; 2. 将原交易状态置为冲正状态rvsl_flg = “1”; 3. 在交易明细表中插入一条冲正交易的记录; 4. 组包向主机发送冲正交易，注意EJFNO = "0" + 终端流水号，HEJFNO = "0"+平台原交易流水号; 5. 登记存储转发表，进行冲正交易的存储转发; 主机冲正成功应答 1. 恢复原交易的明细，将交易状态置为resp_code = “00”, agn_resp_code = “00”, rvsl_flg = “1”; 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 2. 解除存储转发; 3. 如果是终端发起的冲正交易的应答，恢复SessionHead，调用 FillVarNorToDevAndSend向终端返回冲正应答。 主机冲正失败应答 1. 恢复原交易的明细，将交易状态置为resp_code = “～～”, agn_resp_code = “～～”, rvsl_flg = “1”; 2. 解除存储转发; 3. 如果是终端发起的冲正交易的应答，恢复SessionHead，调用 FillVarErrToDevAndSend向终端返回冲正失败应答。 3.2.7 行业应用开户(8413) 行业应用开户指已领取了商行一卡通卡片的用户申请开通某个行业应用功能的操作，由于金融电子存折账户在开卡时不同时开通，因此，此交易也可以用来开通金融电子存折账户。 行业应用开户交易登记应用的行业应用信息，如果此类行业应用需要在帐务系统中开设相应的账号，前置将开户信息提交给主机，主机开通相应的用户账户。 3.2.7.1 交易流程 网点前置主机 提交开户申请 申请开通后台账户 成功 登记行业信息 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.2.7.2 异常流程 此交易涉及到在银行后台给开通相应的用户行业账户，因此有取消交易，如果前置超时，前置向后台发起充正交易。 3.2.7.3 通讯报文 网点向前置的请求报文 Teller向前置的请求报文的基本字段内容，请参见本文档网点连接部分 Teller(网点)向前置(一卡通系统)的请求报文的扩展字段如下表所示: 名称 长度 格式 1 Char 开户类型 19 Char 卡号 20 Char 客户姓名 2 Char 证件种类 20 Char 证件号 1 Char 领卡类型 1 Char 密码类型 8 Char 密码 前置向主机的请求报文 前置向主机的请求报文的扩展字段内容与网点向前置请求报文扩展字段内容相同。 主机向前置返回报文 主机向前置返回报文扩展字段定义如下表所示: 名称 长度 格式 20 Char 客户号 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 20 Char 客户姓名 7 Char 交易流水号 前置向Teller返回报文 前置向Teller返回报文的基本字段内容，请参见文档与网点通讯部分，前置向Teller返回报文扩展字段内容与主机向前置返回内容相同。 3.2.7.4 处理流程 终端的请求消息处理: 1. TPLGetMessage截取上送柜台消息; 2. 调用CheckMsgMac校验MAC; 3. 调用AgtChkCardStat函数判断交易卡是否已经列入黑名单; 4. 判断这笔交易的类型，如果是终端发起的冲正交易则进入DevRsvRes函 数(稍后说明)处理。否则继续进行正常处理。 5. 申请一个新的流水号，并且登记超时; 6. 将上送的信息插入到银行请求消息表(调用AgtInsBnkMsg函数，记录支行 号和终端号等信息); 7. 在交易明细表(agtxndtl)中插入一条交易明细;状态为resp_code = “??”, agn_resp_code = “??”, rvsl_flg = “0”; 8. 组包向主机发送行业应用开户交易的请求;注意交易流水号(EJFNO) 为“0”+平台流水号(6位)，原交易流水号为这笔交易的终端流水号。 主机成功应答处理 1. 恢复交易明细表中的这条交易数据;判断交易状态，如果rvsl_flg 不等 于 “0”则表示此交易已经被冲正，此应答是一个迟到应答，平台将调用 Req84**FromHostTimeoutFun函数进行异常处理。 2. 如果非迟到应答，则解除超时登记; 3. 将交易状态修改为resp_code = “00”, agn_resp_code = “00”, rvsl_flg = “0”; 4. 添加用户申请信息到客户代理协议信息表 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 5. 调用AgtSelAGBNKMSG恢复SessionHead; 6. 调用FillVarNorToDevAndSend组包向终端发送应答。 3.2.7.5 说明 1. 目前系统并没有处理用户行业信息登记内容，需要以后根据行业应用具 体情况进行添加 2. 目前系统所有的行业应用开户均向后台申请开通相应的用户行业账户 3.2.8 PIN解锁、重装(8462、8463) 持卡人如果因为误操作将IC卡芯片密码锁定，可以持卡片和有效证件到营业柜台，由柜员在主管的授权下完成此功能，PIN解锁交易无需经过业务主机，直接由前置完成。 3.2.8.1 流程图 PIN解锁交易流程图如下所示: 网点前置加密机 提交解锁数据 申请加密计算 返回加密结果 加密结果返回 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.2.8.2 报文内容 PIN解锁Teller请求报文扩展字段 PIN解锁Teller请求报文扩展字段内容如下表所示: 名称 长度 格式 1 Char 解锁应用类别 2 Char 密钥索引号 2 Char 密钥版本号 8 Char 随机数 1 Char PIN长度 PIN N Char 1 Char APDU命令长度 N Char APDU命令 图表 3-9 PIN解锁请求报文扩展字段 PIN解锁前置返回报文扩展字段 PIN解锁前置返回报文扩展字段内容如下表所示: 名称 长度 格式 16 Char 密码密文 MAC 8 Char 图表 3-10 PIN解锁返回报文扩展字段 PIN重装Teller请求报文扩展字段 PIN重装Teller请求报文扩展字段内容如下表所示: 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 名称 长度 格式 20 Char 应用类别 2 Char 密钥版本号 2 Char 密钥索引号 2 Char 产生MAC数据长度 Char 产生MAC数据 图表 3-11 PIN重装请求报文扩展字段 PIN重装前置返回报文扩展字段 PIN重装前置返回报文扩展字段内容如下表所示: 名称 长度 格式 MAC 8 Char 图表 3-12 PIN重装返回报文扩展字段 3.3 金融IC卡交易 3.3.1 圈存 通过圈存交易，用户可以将指定金额从持卡人基本活期账户，划入电子钱包或电子存折账户，并同时在用户IC卡中加入指定金额。 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.3.1.1 流程图 网点前置主机时间 卡片圈存初使化 圈存请求 校验MAC1 产生MAC2 圈存请求 超时流水申请 圈存帐务处理 失败失败 成功成功 卡片圈存处理 失败，取消交易取消交易 超时 主机超时，交易失败 取消交易 3.3.1.2 异常流程 异常流程1: 平台、主机均成功，卡片圈存操作失败，由网点发起圈存取消交易，平台和主机均进行交易取消处理。 异常流程2:平台向主机发起圈存交易后，在指定的时间内没有收到后台响应(平台超时)，平台首先向网点发送交易失败消息，然后向主机发起交易取消请求。 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.3.1.3 报文内容 圈存交易Teller请求报文扩展字段 圈存交易Teller请求报文扩展字段内容如下表所示: 名称 长度 格式 19 Char 卡号 2 Char 币种 1 Char 密码类型 6 Char 密码 14 Char 交易金额 14 Char 卡片原余额 1 Char 账户类型 2 Char 卡片密钥索引 2 Char 联机交易序号 2 Char 密钥版本号 1 Char 算法标识 1 Char 交易类型标识 8 Char 卡片随机数 8 Char 卡片MAC1 图表 3-13 圈存交易请求报文扩展字段 圈存交易前置返回报文扩展字段 圈存交易前置返回报文扩展字段内容如下表所示: 名称 长度 格式 20 Char 客户号 20 Char 客户姓名 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 25 Char 客户账户 7 Char 柜员流水 6 Char 开户行代码 3 Char 开户行机构号 1 Char 循环贷款标志 14 Char 交易时间 14 Char 主账户余额 MAC2 8 Char 图表 3-14 PIN解锁返回报文扩展字段 圈存交易前置申请报文扩展字段 圈存交易前置申请报文扩展字段内容如下表所示: 名称 长度 格式 1 Char 账户类型 19 Char 卡号 2 Char 币种 1 Char 密码类型 6 Char 密码 14 Char 交易金额 14 Char 卡片原余额 8 Char 前置流水号 圈存交易主机返回报文扩展字段 圈存交易主机返回报文扩展字段内容如下表所示: 名称 长度 格式 20 Char 客户号 20 Char 客户姓名 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 25 Char 客户账户 7 Char 柜员流水 6 Char 开户行代码 3 Char 开户行机构号 1 Char 循环贷款标志 14 Char 主账户余额 3.3.1.4 主要处理流程 终端圈存请求消息处理: 1. TPLGetMessage截取上送柜台消息; 2. 调用CheckMsgMac校验MAC; 3. 调用AgtChkCardStat函数判断交易卡是否已经列入黑名单; 4. 判断这笔交易的类型，如果是终端发起的冲正交易则进入DevRsvRes 函数(稍后说明)处理。否则继续进行正常处理 5. 调用CreditForLoad生成校验码(MAC2); 6. 申请一个新的流水号，并且登记超时; 7. 将上送的信息插入到银行请求消息表(调用AgtInsBnkMsg函数，记录支 行号和终端号等信息); 8. 在交易明细表(agtxndtl)中插入一条交易明细;状态为resp_code = “??”, agn_resp_code = “??”, rvsl_flg = “0”; 9. 组包向主机发送圈存交易的请求;注意交易流水号(EJFNO)为“0”+ 平台流水号(6位)，原交易流水号为这笔交易的终端流水号 主机成功应答消息处理: 1. 恢复交易明细表中的这条交易数据;判断交易状态，如果rvsl_flg 不等 于 “0”则表示此交易已经被冲正，此应答是一个迟到应答，平台将调用 Req84**FromHostTimeoutFun函数进行异常处理。 2. 如果非迟到应答，则解除超时登记; 3. 将交易状态修改为resp_code = “00”, agn_resp_code = “00”, rvsl_flg = “0”; 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 4. 调用AgtSelAGBNKMSG恢复SessionHead; 5. 调用FillVarNorToDevAndSend组包向终端发送应答。 3.3.2 圈提 通过圈提交易，用户可以将指定金额由电子钱包账户转入用户主账户，并同时在IC卡中扣减相应金额，为了实现交易的一致性，确保交易完整性，并保证卡片电子账户余额小于后台账户余额，圈提交易采用先扣卡片金额，再进行后台转账处理的流程。 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.3.2.1 交易流程 网点前置主机时间 卡片圈提初使化 卡片圈提 圈提请求 校验MAC2 产生MAC3 圈提请求 超时流水申请 圈提帐务处理 失败失败 成功成功 超时 主机超时，交易失败 取消交易 3.3.2.2 异常流程 ? 3.3.2.3 通讯报文 圈提初使化交易Teller请求报文扩展字段 圈提交易Teller请求报文扩展字段内容如下表所示: 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 名称 长度 格式 19 Char 卡号 2 Char 币种 1 Char 密码类型 6 Char 密码 14 Char 交易金额 14 Char 卡片原余额 1 Char 账户类型 2 Char 卡片密钥索引 2 Char 联机交易序号 2 Char 密钥版本号 1 Char 算法标识 1 Char 交易类型标识 8 Char 卡片随机数 8 Char 卡片MAC1 图表 3-15 圈提初使化交易请求报文扩展字段 圈提初使化交易前置返回报文扩展字段 圈提初使化交易前置返回报文扩展字段内容如下表所示: 名称 长度 格式 14 Char 交易日期、时间 MAC2 8 Char 图表 3-16 圈提初使化交易返回报文扩展字段 圈提交易网点请求报文 圈提交易网点请求报文内容与圈提初使化交易相同。 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 圈提前置申请报文扩展字段 圈提交易前置申请报文扩展字段内容如下表所示: 名称 长度 格式 1 Char 账户类型 19 Char 卡号 2 Char 币种 1 Char 密码类型 6 Char 密码 14 Char 交易金额 14 Char 卡片原余额 8 Char 前置流水号 圈提交易主机返回报文扩展字段 圈提交易主机返回报文扩展字段内容如下表所示: 名称 长度 格式 20 Char 客户号 20 Char 客户姓名 25 Char 客户账户 7 Char 柜员流水 6 Char 开户行代码 3 Char 开户行机构号 1 Char 循环贷款标志 14 Char 主账户余额 圈提交易前置返回报文扩展字段 圈提交易前置返回报文扩展字段内容与主机返回前置扩展内容相同。 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.3.2.4 主要处理流程 终端的圈提初始化请求消息处理: 1. TPLGetMessage截取上送柜台消息; 2. 调用CheckMsgMac校验MAC; 3. 调用AgtChkCardStat函数判断交易卡是否已经列入黑名单; 4. 调用CreditForUnLoadInit进行圈提初始化操作; 5. 申请一个新的流水号，并且登记超时; 6. 调用FillVarNorInitToDevAndSend返回终端; 终端的请求消息处理: 1. TPLGetMessage截取上送柜台消息; 2. 调用CreditForUnLoad生成校验码(MAC3); 3. 申请一个新的流水号，并且登记超时; 4. 将上送的信息插入到银行请求消息表(调用AgtInsBnkMsg函数，记录支行 号和终端号等信息); 5. 在交易明细表(agtxndtl)中插入一条交易明细;状态为resp_code = “??”, agn_resp_code = “??”, rvsl_flg = “0”; 6. 组包向主机发送补换卡交易的请求;注意交易流水号(EJFNO)为“0” +平台流水号(6位)，原交易流水号为这笔交易的终端流水号。 3.3.3 电子存折取现 取现交易只支持电子存折，持卡人可以在银行网点从电子存折账户上提取指定额度的现金。 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.3.3.1 交易流程 网点前置主机时间 卡片取现初始化 取现初始化 产生MAC1 卡片取现 取现请求 取现请求 超时流水申请 取现帐务处理 失败失败 成功成功 超时 主机超时，交易失败取消交易 3.3.3.2 3.3.4 卡余额查询 持卡人用IC卡可在Teller查询卡上记录的帐户余额，此交易由Teller调用相 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 应的卡片指令完成，与前置、Host无关。 3.3.5 交易明细查询 持卡人用IC卡可在Teller查询卡上保存的最近10笔交易明细，此交易由Teller调用相应的卡片指令完成，与前置、Host无关。 3.3.6 历史交易明细查询 持卡人用IC卡可在Teller查询历史交易明细，此交易由Teller直接向Host发送， 不经过前置，可以采用现有系统功能提供。 4 城市应用功能描述 4.1 代理机构信息维护 代理机构信息维护的交易报文如下表所示: 名称 长度 格式 8 Char 代理机构号 60 Char 代理机构名称 4 Char 开户行号 21 Char 开户账号 20 Char 联系人 60 Char 代理机构地址 20 Char 代理机构电话 10 Char 邮政编码 2 Char 行业分类代码 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 4.1.1 代理机构增加 4.1.2 代理机构修改 4.1.3 代理机构基本信息查询 代理机构信息表包含如下内容: 名 称 域 名 格 式 描 述 agn_inst_no Char(8) 代 理 机 构 号 agn_inst_name Char(60) 代 理 机 构 名 称 agn_inst_stat Char(1) 代 理 机 构 状 1, 正 常 态 2, 清 户 opn_bank_no Char(4) 开 户 行 号 opn_bank_act_no Char(21) 开 户 账 号 Contact_name Char(30) 联 系 人 agn_inst_addr Char(60) 代 理 机 构 地 址 agn_inst_tel_no Char(20) 代 理 机 构 电 话 zip_code Char(10) 邮 政 编 码 Type Char(2) 行 业 分 类 代 码 last_mod_date Char(8) 最 后 修 改 日 期 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.4 代理业务品种维护 3.4.1 代理业务品种增加 3.4.2 代理业务品种修改 3.4.3 代理业务品种查询 增加代理业务品种，则至少需要详细输入以下信息: 代理业务名称 所属代理机构代码 代理业务类别(1. 小额支付类 2. 充资充点类 3. 信息采集类 4. 其他) 对应IC卡区 (1 金融电子存折 2 金融电子钱包 3 专用电子钱包 4专用行业区) 代理业务过渡帐号 充资方式 (1 实时联机 2 脱机批量 3 全部) 消费方式 (1 实时联机 2 脱机批量 3 全部) 对帐方式(0 不对帐 1 对总帐 2 对明细 4总分核对) 与代理机构结算依据(1 全额结算 2 机构数据 3 银行数据 4 对帐不平不结算) 手续费收取标志 (0 不收 1 收取) 手续费种类 手续费结算时间(设置多少天结算手续费) 特殊控制标志(0 无 1 有) 特殊控制算法名称 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.5 代理业务手续费信息维护 3.5.1 手续费种类增加 3.5.2 手续费种类修改 3.5.3 手续费种类查询 手续费名称 分段标志 分段算法名称 费率 计算范围 (此为一组多项选择，包括开户、销户、充资、消费、退款、 挂失/解挂、冻结/解冻、止付等交易) 计算依据 (1 交易笔数 2 交易金额) 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.6 代理机构的交易明细数据 3.6.1 交易明细查询 3.6.2 交易明细报表 3.7 客户管理 3.7.1 客户信息维护 3.7.1.1 客户信息增加 3.7.1.2 客户信息修改 3.7.1.3 客户信息查询 3.7.1.4 客户信息删除 3.7.1.5 客户业务信息查询 3.7.2 分析参数维护 3.7.2.1 客户分析参数增加 3.7.2.2 客户分析参数修改 3.7.2.3 客户分析参数查询 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.7.3 信息分析 3.7.3.1 优质客户信息查询 3.7.3.2 不良客户信息查询 3.7.3.3 行业信息客户查询 3.8 参数管理模块 3.8.1 参数维护 3.8.2 规则算法库 3.9 交易模块 3.9.1 代理业务开户 交易流程如下: , 持卡人在银行柜台填写代理业务开通申请单，对于类似燃气应用， 持卡人还需填写燃气机具信息，并出具相关资料; , 柜台进行开户信息的输入，具体交易接口需与代理机构协商后定， 但以下信息必须输入: , IC卡号(IC读写器读入) , 代理业务品种代码 , 对应机具号(在类似燃气应用中必须输入，来控制一机具三卡) , 客户手续费收取标志(0 不收取 1 收取) , 手续费种类 , 特殊规则控制(0 无 1 有) , 如此代理业务对于持卡人是新的业务，且使用行业专用区，则需要 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 对此IC卡进行二次发卡，即从后台获取此代理业务的文件结构数据， 然后通过IC读写器写入IC卡; , 二次发卡的安全控制类似电子存折圈存，在此不再阐述; , 此交易支持与代理机构的实时连接和脱机二种方式，对于实时连接 方式，必须等到代理机构授权后，此交易才能继续进行; , 与代理机构进行实时交易通讯时，需要对交易消息包进行MAC验 证; 交易成功后，在城市一卡通子系统中增加一条客户业务记录，并记录交易明细 3.9.2 代理业务销户 当IC卡持卡人需要在其卡上停止某项代理业务时，需要到银行柜台办理 此交易。交易流程如下: , 持卡人在银行柜台填写代理业务销户申请单，对于类似燃气应用， 持卡人还需填写燃气机具信息，并出具相关资料; , 柜台进行销户信息的输入，具体交易接口需与代理机构协商后定， 但以下信息必须输入: , IC卡号(IC读写器读入) , 代理业务品种代码 , 对应机具号(在类似燃气应用中必须输入，来控制一机具三卡) , 特殊规则控制(0 无 1 有) , 此交易支持与代理机构的实时连接和脱机二种方式，对于实时连接 方式，必须等到代理机构授权后，此交易才能继续进行; , 与代理机构进行实时交易通讯时，需要对交易消息包进行MAC验 证; , 交易成功后，记录交易明细。 由于客户销户时，仍可能存在与此代理业务有关的脱机消费明细未上传到帐，因此如客户要求销户退款，则必须等待若干天后才能退。 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.9.3 充资 IC卡持卡人可通过银行柜台、自助设备等对某个专用应用区进行充资， 充资包括现金充资和转帐充资。交易流程如下: , 输入相关信息，具体交易接口需与代理机构协商后定，但以下信息 必须输入: , IC卡号(IC读写器读入) , 代理业务品种代码 , 对应机具号(在类似燃气应用中必须输入，来控制一机具三卡) , 交易金额 , 特殊规则控制(0 无 1 有) , 此交易支持与代理机构的实时连接和脱机二种方式，对于实时连接 方式，必须等到代理机构授权后，此交易才能继续进行; , 与代理机构进行实时交易通讯时，需要对交易消息包进行MAC验 证; , 如果与代理机构实时连接的，则可以由代理机构进行金额与数量单 位之间的换算，否则必须在城市一卡通子系统中维护此代理业务的 当日价格表，以便进行换算; , 交易成功后，在城市一卡通子系统中更新客户业务记录，并记录交 易明细。 , 将充资金额或数量单位通过IC读写器写入卡内的相应应用区，此交 易的安全控制类似电子钱包圈存; , 会计分录:借 现金或转出户 贷 代理业务过渡户 , 如为转帐通存，则会计分录: 受理行 借 清算帐户 贷 代理业务过渡户 转出行 借 转出户 贷 清算帐户 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.9.4 退款 退款交易是充资交易的反交易，对于退款交易，有如下几个约定: , 只能转帐退款，即退款金额必须转回基本主帐户; , 只能通过银行柜台进行，且需主管授权; , 与代理机构必须协商好退款期限; , 换算成数量单位进行充资的业务(如燃气应用)，如无特殊需要，不 允许退款。 交易流程如下: , 输入相关信息，具体交易接口需与代理机构协商后定，但以下信息 必须输入: , IC卡号(IC读写器读入) , 代理业务品种代码 , 对应机具号(在类似燃气应用中必须输入，来控制一机具三卡) , 交易金额 , 特殊规则控制(0 无 1 有) , 此交易支持与代理机构的实时连接和脱机二种方式，对于实时连接 方式，必须等到代理机构授权后，此交易才能继续进行; , 与代理机构进行实时交易通讯时，需要对交易消息包进行MAC验 证; , 交易成功后，在城市一卡通子系统中更新客户业务记录，并记录交 易明细。 , 将退款金额通过IC读写器写入卡内的相应应用区，此交易的安全控 制类似电子存折圈提; , 会计分录:借 代理业务过渡户 贷 基本主帐户 , 如为转帐通兑，则会计分录: 受理行 借 代理业务过渡户 贷 清算帐户 转出行 借 清算帐户 贷 基本主帐户 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.9.5 消费 IC卡持卡人可通过银行柜台、自助设备等进行消费(或缴费)业务，交 易流程如下: , 输入相关信息，具体交易接口需与代理机构协商后定，但以下信息 必须输入: , IC卡号(IC读写器读入) , 代理业务品种代码 , 交易金额 , 特殊规则控制(0 无 1 有) , 以上交易金额可以手工输入，也可通过读取相应应用区内的信息后 进行换算，如交警罚没应用，通过读取对应应用区内的罚金金额来 进行缴费; , 此交易支持与代理机构的实时连接和脱机二种方式，对于实时连接 方式，必须等到代理机构授权后，此交易才能继续进行; , 与代理机构进行实时交易通讯时，需要对交易消息包进行MAC验 证; , 此交易支持与后台城市一卡通子系统的实时连接和脱机二种方式， 实时连接时: , 交易成功后，在城市一卡通子系统中更新客户业务记录，并记录 交易明细。 , 会计分录:借 电子钱包户 贷 基本主帐户 借 基本主帐户 贷 代理业务过渡户 , 如为转帐通存，则会计分录: 受理行 借 清算帐户 贷 代理业务 过渡户 发卡行 借 电子钱包户 贷 基本主帐 户 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 借 基本主帐户 贷 清算帐户 , 脱机时，在机具中形成交易明细，以备脱机明细上送进行清算，清 算会计分录同上。 3.9.6 冻结/解冻 此业务一般由相关代理机构发起，通过发卡行柜台进行办理。交易流程 如下: , 输入相关信息，具体交易接口需与代理机构协商后定，但以下信息 必须输入: , IC卡号(IC读写器读入) , 代理业务品种代码 , 对应机具号(在类似燃气应用中必须输入，来控制一机具三卡) , 冻结/解冻金额(支持部分冻结) , 特殊规则控制(0 无 1 有) , 此交易支持与代理机构的实时连接和脱机二种方式，对于实时连接 方式，必须等到代理机构授权后，此交易才能继续进行; , 与代理机构进行实时交易通讯时，需要对交易消息包进行MAC验 证; , 交易成功后，在城市一卡通子系统中更新客户业务记录，并记录交 易明细。 3.9.7 补发 如果客户在丢失了卡后补办了新卡，则可通过此交易将原卡上的 行业应用通过二次发卡的方式写入到新卡中，但如无特殊需要，所 有应用的余额都初始化为零。此业务必须通过新卡的发卡行柜台进 行办理。 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.9.8 当日交易明细查询 3.10 对帐及清分模块 3.10.1 对帐 本系统提供了灵活的对帐机制，所谓“灵活”主要体现在以下几个方面: , 可以与代理机构(或特约商户)约定对帐时间，而无须等到日终; , 对帐交易可以由银行端驱动，也可由代理机构驱动; , 对帐内容支持交易明细对帐、汇总数据对帐、客户行业应用区余 额对帐等; , 对帐交易的数据格式可以与代理机构(或特约商户)约定，支持 文件对帐方式，系统内做数据格式的转换; 3.10.2 差错处理 3.10.3 清分 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 5 前置交易流程: 根据交易的性质，将交易分类为:金融类交易(指记账类交易)和非 金融类交易(指查询类交易)。其中记账类交易还可以根据业务处理要求 的不同分为:正常记账、冲正记账和取消记账等。 以下各小节中，我们将分别描述对于上述几种不同的交易如何定义事 件流程。 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 3.11 记帐类交易 3.11.1 正常交易 , 取出从网点设备发来的请求消息 call TPLGetMessage(vcaMsgText) vcaMsgText的前24 个字节是Session Header，Session Header将被用作 TPLSendToDev()的输入参数，在将应答发回给网点设备时使用 3.11.2 冲正交易 3.11.3 取消交易 3.12 查询类交易 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 6 数据库设计 6.1 发卡类 6.1.1 批量开卡明细表(BATCH_CARD_DTL) 6.2 终端管理类 6.2.1 终端信息表 (Term_Info_Table) 主关键字:终端号、终端类型 字段名 中文名 类型 长度 Id CHAR 12 终端号 Type CHAR 2 终端类型 nodeno CHAR 8 所属网点 blackcard_ver 6 黑名单版本号 NUM(6) InistCode CHAR 8 所属机构 State CHAR 1 使用状态 Mem CHAR 128 备注 说明: 字段 –使用状态: 0 -------- 状态正常 1 ------- 此终端已停用 6.2.2 黑名单信息表(BlackCard_Info_Table) 主关键字:卡号、版本号、属性 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 字段名 中文名 类型 长度 CardNo CHAR 19 卡号 VerNo NUM6 6 版本号 Prop CHAR 1 属性 Mem CHAR 128 备注 说明: 字段 –属性: „-„ -------- 此版本中 此卡号不为黑名单 „+„ ------- 此版本中 此卡号成为黑名单 6.2.3 黑名单信息控制表(Blackcard_Control_Table) 主关键字:批次号、版本号 字段名 中文名 类型 长度 BatchNo Num6 6 批次号 VerNo Num6 6 版本号 AddTotal Number6 6 新增黑名单总数 DelTotal Number6 6 删除黑名单总数 DateTime Char8 8 中心处理时间 Mem Char 128 备注 6.2.4 PSAM卡管理信息表(SamCard_Info_Table) 主关键字:PSAM卡号 字段名 中文名 类型 长度 CardNo Char 19 PSAM卡号 TermNo Char 12 SAM卡读写器终端号 Type Char 1 类型 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 NodeCode Char 6 网点号 NodeTermNo Char 6 网点终端号 Status Char 1 状态 IssueDateTime Char 8 发卡时间 Mem Char 128 备注 6.3 行业管理类 6.3.1 行业计量换算信息转换表(TradeMeasureTable) 主关键字:代理机构号、代理种类 字段名 中文名 类型 长度 Agn_inst_no CHAR 8 代理机构号 Fee_Name Char 3 代理种类 Flag CHAR 1 分段标记 fee_amt Number(9,2) 9 固定收费金额 fee_ratio Number(9,6) 9 收费比率 min_fee_amt Number(9,2) 9 最低收费金额 max_fee_amt Number(9,2) 9 最高收费金额 Mode CHAR 1 折算方式 Mem CHAR 128 备注 说明: 分段标记: 0------无分段标记 (Scale1=Scale2=Scale3=Scale4=Scale5) 1------有分段标记 折算方式: 小数点后 0----------末尾去处法 1----------四舍五入 2----------末尾进位法 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 6.3.2 分断计量表 主 关 键 字: 代理机构号、代理种类 字段名 中文名 类型 长度 Agn_inst_no CHAR 8 代理机构号 Fee_Name Char 3 代理种类 low_txn_amt Number(13,2) 13 起始交易金额 high_txn_amt Number(13,2) 13 截止交易金额 fee_amt Number(13,2) 13 固定收费金额 fee_ratio Number(9,6) 9 收费比例 discount_ratio Number(5,2) 5 折扣率 effect_date Char(8) 8 折扣生效日期 expire_date Char(8) 8 折扣失效日期 6.4 客户信息管理类 6.4.1 客户代理业务协议信息补充表 (AGCLTATH_ACCERY) 说明: 在客户代理业务协议信息表中，如果增加一个行业应用，相应增加行业 信息内容，具体的行业信息随着不同的行业信息不同而不同。即不同的行业 信息字段说明不同 主关键字:卡号、客户号 字段名 中文名 类型 长度 CardNo Char 19 卡号 CustemID Char 13 客户号 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 Act_seq_no Char 6 账号顺序号 Agn_code Char 3 代理代码 Agn_inst_no Char 8 代理机构号 Foreign_act_no Char 30 外部账号 Info1 信息1 Info2 信息2 : : InfoN : Mem 备注 6.5 交易类 6.5.1 联机交易明细附属表 AGTXNDTL_ONLINE_ACCERRY 主关键字:交易日期、交易时间、交易流水号 字段名 中文名 类型 长度 txn_date CHAR 8 交 易 日 期 txn_time CHAR 14 交 易 时 间 rvsl_to_seq_no CHAR 6 原交易流水号 to_seq_no CHAR 6 超 时 流 水 号 MtxnNo CHAR 6 主 机 记 账 流 水 号 BankNo CHAR 11 交 易 行 号 TermNo CHAR 8 设 备 号(终端号) 设 备 序 号(设备流水 TermFlowId CHAR 6 号) NodeId CHAR 6 网点号 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 TellerId CHAR 4 柜 员 号 CardNo CHAR 10 卡 号 交易类型 CHAR(圈存、圈Ntype 1 提) Amount 交易金额 Random CHAR 8 随机数 KeyVerNo CHAR 2 密钥版本号 KeyIndex CHAR 2 密钥索引号 NAlgord CHAR 2 算法标识 OldAmount NUMBER 9.2 原先余额 MAC CHAR 4 交易验证码 TAC CHAR 4 交易验证码 Mem CHAR 128 备注 6.5.2 脱机消费交易明细附属表 AGTXNDTL_OFFLINE_ACCERRY 关键字:交易日期、交易时间、终端流水号 字段名 中文名 类型 长度 Tran_date CHAR 8 交易日期 Tran_time CHAR 6 交易时间 T_seq_no CHAR 6 终端流水号 CardNo CHAR 10 卡号 MerchantId CHAR 10 商户号 TranCode CHAR 2 交易码 TermId CHAR 8 终端号 T_node_no CHAR 6 网点号 TellerId CHAR 6/4 操作员号 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 TTC CHAR 6 终端交易序号 Tran_amt NUMBER 9.2 交易金额 Tran_stat CHAR 2 交易标志 Tac CHAR 4 交易验证码 MAC CHAR 4 交易验证码 C_on_seq CHAR 6 联机交易序号 Old_amt NUMBER 9.2 原先余额 Random CHAR 8 随机数 Key_ver CHAR 2 密钥版本号 Key_index CHAR 2 密钥索引号 NAlogd CHAR 2 算法标识 Mem CHAR 128 备注 6.5.3 开卡信息控制表 (PREV_CARD_CONTROL) 关键字:批次号、交易时间 字段名 中文名 类型 长度 BatchNo CHAR 6 批次号 DateTime CHAR 8 交易日期 Number NUMBER 8 预制数量 InstNo CHAR 8 机构号 CardType CHAR 2 卡型 Mode CHAR 1 操作方式 Mem CHAR 128 备注 6.5.4 开卡信息明细表 (PREV_CARD_DTL) 关键字:卡号、卡片类型 字段名 中文名 类型 长度 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 CardNo CHAR 19 卡号 CardType CHAR 2 卡片类型 PreDateTime CHAR 8 开卡日期 IssueDateTime CHAR 8 发卡时间 CardStatus CHAR 2 卡状态 AccountNo CHAR 账号(基本主) InstNo CHAR 8 机构号 CustomId CHAR 8 客户号 UseDateTime CHAR 8 领用时间 Mem CHAR 128 备注 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 7 函数设计 (SA)脚本使用 7.1 加密机函数接口 3.12.1 报文校验 CheckMsgMac 功能: MAC比较 参数: integer iKeyIndex 使用的密钥索引 vcarray vcaMacData 参与MAC运算的数据 integer iMacDataLen 参与MAC运算的数据长度 carray caMac[8] MAC 参与比较的MAC数据 返回: integer: 0 运算成功， -1 运算失败, -2 加密机无返回 -3 MAC结果数据补正确 3.12.2 获得加密结果 GetMac 功能:产生MAC 参数: integer iKeyIndex 使用的密钥索引 vcarray vcaMacData 参与MAC运算的数据 integer iMacDataLen 参与MAC运算的数据长度 质量管理运作体系文件—三级文件记录编号403041-QR IC卡前置系统详细设计 carray caMac[8] MAC (返回) 返回: integer: 0 运算成功， -1 运算失败,