MISPOS系统系统详细设计

1、mis-pos系统v4.0系统详细设计一、 服务端系统设计1.1 操作系统选型操作系统：redhat as4.0数据库：oracle xe（4g数据库、1cpu、2g内存）1.2 系统模块划分系统模块划分及相互关系如下图所示：系统主要包括接入管理进程（umsclisrvx-x为编号，根据不同接口而定，4.0系统标准接口为0）、业务处理进程（umsmainsrv)、输出处理进程（umsextsrvxx为编号，代表不同的外部转接系统，银联接口为0）以及加密进程（umspinsrv）。输入管理进程负责接收来自收银终端的各类请求，是系统的业务发起端。来自收银端的交易分为两类，一类是业务类交易，输入管理

2、进程负责解析报文，并将其转换为系统内部接口，将其转至业务处理进程进行具体的处理，并等待应答（同步通讯）；另一类是管理类交易，由输入管理进程直接处理（如自动查错交易等）。业务处理进程负责接受来自输入管理进程的任务，并根据不同的业务进行处理，包括具体的业务逻辑处理以及数据库操作等；当业务逻辑需要将交易发往银联或其它第三方外部机构进行处理时，该进程将通过内部接口将任务转至输出处理进程，并等待输出处理进程的应答（同步通讯）。输出处理进程负责将内部通讯接口转换为外部标准接口，并按照外部系统的标准与协议规范将交易发往外部系统，完成相应的业务功能。加密进程负责操作具体的加密设备，为上层应用逻辑提供必须的加密

3、指令集，与外部通过消息队列或其它形式通讯（视加密机的类型而定）。1.3 模块详细设计输入管理进程设计输入管理进程的处理流程如下图所示：对于业务类交易，本进程仅负责接口转换及转发，无具体业务逻辑；对于管理类交易，由本进程直接处理，主要包括以下管理类交易： 自动查错交易：前台系统提供自我诊断功能，其中一部分是检测服务端系统的状态及与外部系统的网络状态等，自动查错交易即用来诊断以上问题，具体业务流程如下图所示：step1：检测umsclisrv。如建立连接，直接返回a0即可。step2：检测umsmainsrv。向该进程发测试交易，返回测试结果。step3：检测umspinsrv及密钥设置情况。调用

4、加密库，利用指定的workkey及密钥索引做加密运算， 业务处理进程设计输出处理进程设计1.4 模块间交互控制输出处理进程与外部系统一般采用tcp通讯，超时时间50秒。业务处理进程与输出处理进程之间采用本地socket方式通讯，超时时间53秒。输入管理进程与业务处理进程之间采用本地socket方式通讯，超时时间56秒。前台系统与输入管理进程之间采用tcp通讯，超时时间60秒。任何进程产生超时都将向上一级系统（进程）返回内部返回码e00只有前台系统与业务处理进程能够发起冲正。业务处理进程在遇到接收应答超时、收到内部返回码e00时，将直接发起冲正，并返回内部返回码e00；当前台系统遇到接收应答超时

5、或交易成功但后续操作失败（如打印签购单失败）时，将发起冲正交易，前台系统收到e00不需再发起冲正。1.5 接口定义前台接口定义收银端接口报文由【报文长度报文头报文体mac】的结构构成。【报文长度】为两个字节的网络字节序整数，具体定义如下：#define u_int16 unsigned short u_int16 ipacklen;【报文头】采用结构体定义的定长格式，报文头为每个交易所必须的公共部分，具体定义如下：typedef struct tagtums_client_pkgheadchar saversion2 + 1;/主版本号1byte副版本号1byte，如10char satran

6、scode4 + 1;/交易代码（功能号）char sacrypt2 + 1;/加密方式1byte，0不加密，1des，23des，其它保留char saoperno20 + 1;/收银员编号char samchtcode20 + 1;/商户编号（系统内部编号，可以与银联的商户代码一致，也可自行分配，通过商户编号与收银台号对应一个机台，并在服务器端根据不同的应用映射真实的商户代码与终端号，如银联应用、储值卡应用等）char sacounterno10 + 1;/收银台号（前台统一设置收银台号，由后台自动映射终端编号）char saserial20 + 1;/标识该笔交易的序列号，应答报文应原样

7、返回，格式” yyyymmddhhmiss”，序列号+商户编号+终端号唯一标识一笔交易，后台应做校验，目前暂定14位，后补0char sarecnum4 + 1;/记录条数（报文体中含有多条信息时适用，一般报文填0001）char sanextpkg1 + 1;/是否有后续包（0没有，1有）char saretno3 + 1;/内部返回码（返回提示信息saretmsg由于是可变长字段，一般定义在报文体的第一个字段中，不得超过250个字节）char satrack2len2 + 1;/二磁道信息长度，压缩之前的长度char satrack224 + 1;/二磁道信息char itrack33 +

8、 1;/三磁道长度char satrack364 + 1;/三磁道信息 tums_client_pkghead;报文头共计176个字节【报文体】报文体采用竖线分割的变长结构（报文体中不得出现不可见字符，否则一律使用bcd码展开；最后一个字段之后没有分隔符），具体定义如下报文体的最大长度为1280个字节，不得越界。红色部分字段为必填项。【mac】视交易而定，不需要mac的交易，该字段为8个字节的/0银联posp应用类交易（功能号头两位01）取工作密钥（向服务器取工作密钥）ums_cup_getworkkey（0101）上送字段名字段长度描述ums_cup_getworkkey（0101）返回字段

9、名字段长度描述saretmsg/返回内容描述，可为空sapinkey16samackey16消费（需要mac）ums_cup_pca（0102）上送字段名字段长度描述saamt/单位元，小数点二位saencpin16sakey32前台保存的pinkey+mackeysaenflag10返回中文，1返回英文，涉及到的返回字段：samchtname 、sabankname、saadvsaannid20099循环取数，标识当前公告的版本，如版本不一致，则下发新的公告内容，如不需要公告，则传-1saexflow20收银系统的小票流水号（二次开发时使用，记入流水库，与收银系统对帐匹配时使用）返回内部错误

10、时（返回码e开头）：ums_cup_pca（0102）返回字段名字段长度描述saretmsg/返回内容描述，可为空saannid2最新公告版本saannounce公告内容（不得含有|）返回码a开头：ums_cup_pca（0102）返回字段名字段长度描述saretmsg/返回内容描述，可为空saannid2最新公告版本saannounce公告内容（不得含有|）sacupretno2银联posp应用的返回码sacupretmsg/应用返回码描述sacuprethelp/应用返回错误时的提示操作samchtcode15银联posp应用的具体商户代码samchtname/商户名称satermno8银

11、联posp应用的终端号sabankcode8发卡银行编号sabankname/发卡银行名称sacardno/卡号sarefseq12中心流水sadate14交易日期yyyymmddhhmisssaexdate4卡有效日期sabatchno6批次号saseqno6流水号saauthno6授权号saamt/交易金额，元为单位，小数点2位saadv/签购单上打印的额外信息，如为空则不打印（譬如中奖信息等等）；换行通过分割sasdbankcode8收单银行代码sasdbankname/收单银行名称iappid/1-银联卡应用，2-银商储值卡,3-瑞富通卡注：返回e07，则表示前台存放密钥过期，新密钥通

12、过报文pca应答带回，存放在报文体saretmsg中（32个字节，pinkeymackey）中，前台应用应更新保存密钥，同时重新驱动密码键盘，提示用户再次输入密码并再次上送。如连续两次上送。返回e00，表示交易超时，但前台应用不需发起冲正；只有在交易无应答或后续操作失败的情况下，可发起冲正。内部返回码e开头，则表示系统内部错误，无需判断应用返回码；a开头，则系统操作无误，需判断应用返回码。内部返回码a01，应用返回码00，则表示已中奖，应提示收银员并将中奖信息saadv打印在签购单上。消费冲正（需要mac）ums_cup_ pcc（0152）上送字段名字段长度描述saorserial14原交易

13、序列号saamt/单位元，小数点二位，用于校验ums_cup_ pcc（0152）返回字段名字段长度描述saretmsg/返回内容描述，内部返回码e开头时有效，可为空注：冲正通过“序列号+商户编号+终端号”唯一标识原交易，其中商户编号及终端编号在报文头中，序列号在报文体中所有银联冲正应答结构都采用统一格式撤销（需要mac）ums_cup_pra（0103）上送字段名字段长度描述saamt/单位元，小数点二位sabatchno6原批次号saseqno6原流水号saencpin16密码密文sakey32前台保存的pinkey+mackeysaenflag1同消费报文saannid2最新公告版本sa

14、exflow20收银系统的小票流水号（二次开发时使用，记入流水库，与收银系统对帐匹配时使用）ums_cup_pra（0103）返回字段名字段长度描述saretmsg/返回内容描述，可为空saannid2最新公告版本saannounce公告内容（不得含有|）sacupretno2银联posp应用的返回码sacupretmsg/应用返回码描述sacuprethelp/应用返回错误时的提示操作samchtcode15银联posp应用的具体商户代码samchtname/商户名称satermno8银联posp应用的终端号sabankcode8发卡银行编号sabankname/发卡银行名称sacardno

15、/卡号sarefseq12中心流水sedate14交易日期yyyymmddhhmisssaexdate4卡有效日期sabatchno6批次号saseqno6流水号saauthno6授权号saamt/交易金额，元为单位，小数点2位saadv/签购单上打印的额外信息，如为空则不打印（譬如中奖信息等等）sasdbankcode8收单银行代码sasdbankname/收单银行名称iappid/1-银联卡应用，2-银商储值卡, 3-瑞富通卡注：若服务器未找到匹配的原交易，则返回e08同消费报文处理撤销冲正（需要mac）ums_cup_prc（0153）上送字段名字段长度描述saorserial14原交易

16、序列号saamt/单位元，小数点二位，用于校验ums_cup_prc（0153）返回字段名字段长度描述saretmsg/返回内容描述，内部返回码e开头时有效，可为空注：冲正通过“序列号+商户编号+终端号”唯一标识原交易，其中商户编号及终端编号在报文头中，序列号在报文体中查询余额（需要mac）ums_cup_inq（0104）上送字段名字段长度描述saencpin16密码密文sakey32前台保存的pinkey+mackeysaannid2最新公告版本ums_cup_inq（0104）返回字段名字段长度描述saretmsg/返回内容描述，可为空saannid2最新公告版本saannounce公告

17、内容（不得含有|）sacupretno2银联posp应用的返回码sacupretmsg/应用返回码描述sacuprethelp/应用返回错误时的提示操作saamt/余额，元为单位，小数点2位查询交易明细（不需要mac）ums_cup_schtxn（0120）上送字段名字段长度描述saamt/单位元，小数点二位sabatchno6原批次号saseqno6原流水号查询失败返回：ums_cup_schtxn（0120）返回字段名字段长度描述saretmsg/返回内容描述，可为空查询成功返回（记录条数在报文头中指定，报文最大长度控制明细笔数）：ums_cup_schtxn（0120）返回字段名字段长度

18、描述lst1lst2lstn每笔明细内容（通过分割）（148个字节一笔）samchtcode15银联posp应用的具体商户代码satermno8银联posp应用的终端号sabankcode8发卡银行编号sabankname8发卡银行名称sacardno20(max)卡号sarefseq12中心流水sadate14交易日期yyyymmddhhmisssabatchno6批次号saseqno6流水号saauthno6授权号saamt13(max)交易金额，元为单位，小数点2位saoperno20(max)操作员编号satxnname10(max)交易类型重打印查询（不需要mac）ums_cup_r

19、eprint（0121）上送字段名字段长度描述sabatchno6原批次号，如果为空，则系统自动查找当日上一笔交易返回saseqno6原流水号saenflag1同消费报文查询失败返回：ums_cup_reprint（0121）返回字段名字段长度描述saretmsg/返回内容描述，可为空注：未找到原交易，返回e08。查询成功返回（与消费交易格式一致）：ums_cup_reprint（0121）返回字段名字段长度描述saretmsg/返回内容描述，可为空sacupretno2银联posp应用的返回码sacupretmsg/应用返回码描述sacuprethelp/应用返回错误时的提示操作samcht

20、code15银联posp应用的具体商户代码samchtname/商户名称satermno8银联posp应用的终端号sabankcode8发卡银行编号sabankname/发卡银行名称sacardno/卡号sarefseq12中心流水sadate14交易日期yyyymmddhhmisssaexdate4卡有效日期sabatchno6批次号saseqno6流水号saauthno6授权号saamt/交易金额，元为单位，小数点2位saadv/签购单上打印的额外信息，如为空则不打印（譬如中奖信息等等）satrnname8交易类型sasdbankcode8收单银行代码sasdbankname/收单银行名称

21、iappid/1-银联卡应用，2-银商储值卡, 3-瑞富通卡终端换批服务器收到换批交易后，依次向中心发送结算、签退以及签到交易（如某一步交易无法成功，则直接返回错误步骤及原因，不需继续往下做），并将结果返回前台。前台在做完换批交易后，应联机做签到交易，更新密钥。ums_cup_chgbatch（0105）上送字段名字段长度描述ums_cup_chgbatch（0105）返回字段名字段长度描述saretmsg/返回内容描述，可为空管理类交易（功能号头两位00）检测密码键盘密钥有效性ums_manage_chkpinpad（0001）上送字段名字段长度描述saencpin/加密的密码密文ums_m

22、anage_chkpinpad（0001）返回字段名字段长度描述saretmsg/返回内容描述，可为空注：交易约定输入的密码明文为123456，pinkey密文：1234567890abcdef，服务器端应预先保留加密正确的密文结果（checkvalue），以便检测时核对；返回检测结果根据内部返回码判定，a00检测通过，e02检测不通过，返回其它则为其它错误，无法认定检测结果。检测网络状态ums_manage_chknet（0002）上送字段名字段长度描述ums_manage_chknet（0002）返回字段名字段长度描述saretmsg/返回内容描述，可为空istep/检测步骤，详见注解注：

23、检测网络分为几个步骤，返回istep必须有返回值，一项未检测，istep=0；istep小于最后一项的步骤，说明中间存在问题，未全部检测通过istep=1：收银台到服务器网络通畅，后续步骤未检测istep=2：正在检测服务器到路由器网络，成功返回a00，失败返回e02istep=3：正在检测服务器到银联网络（发模拟报文检测），收到银联应答，则返回a00，否则返回e02检测服务器状态ums_manage_chksrv（0003）上送字段名字段长度描述ums_manage_chksrv（0003）返回字段名字段长度描述saretmsg/返回内容描述，可为空istep/检测步骤，详见注解注：检测网络

24、分为几个步骤，返回istep必须有返回值，一项未检测，istep=0；istep小于最后一项的步骤，说明中间存在问题，未全部检测通过istep=1：检测数据库是否正常。后续步骤未检测。登陆成功，返回a00，无法登陆返回e04istep=2：检测加密进程状态。成功返回a00，失败返回e03istep=3：检测加密机主密钥。以123456为pin明文，1234567890abcdef为pinkey密文，调用加密指令加密pin，与预先设置的checkvalue进行比对，如全部检测通过，返回a00，否则返回e03，saretmsg应包含检测哪组主密钥未通过的相关信息。istep=4：检测业务处理进程状

25、态。通过发检测报文测试，收到应答返回a00，否则返回e02。收银机公告ums_manage_announce（0004）上送字段名字段长度描述idx/公告索引（可设置多个公告信息）ums_manage_announce（0004）返回字段名字段长度描述saretmsg/返回内容描述，可为空saannid2最新公告版本saannounce公告内容（不得含有|）注：公告内容可设置多项，具体由监控管理平台提供设置界面，公告应能设置有效期、公告范围（即收银台号范围），后台根据合法性校验，判别是否发送公告内容，需要发送返回a00，无公告信息最新saannid以及空的saannounce字段，否则返回其它

26、错误。身份认证ums_manage_chkoper（0005）上送字段名字段长度描述sapass/收银员登陆密码（收银员号在报文头）itype/验证类别ums_manage_chkoper（0005）返回字段名字段长度描述saretmsg/返回内容描述，可为空saopername20(max)操作员姓名注：itype表示验证类别0收银员登陆认证1收银主管授权认证某些特殊的交易需要收银主管认证，譬如撤销时的主管认证等等。2系统管理员认证一些管理类功能的授权认证，譬如设置系统参数等等。认证通过，返回a00，否则返回e06普通收银员登陆，后台可配置是否校验密码，一个终端同时只能由一个收银员登陆，不能

27、覆盖，只能由收银程序发送收银换班交易，统计信息清零后才能覆盖。系统初始化在收银程序启动时调用，用于与后台同步终端信息，包括：1、 检查终端参数设置有效性（如商户代码、终端号等）2、 检查该终端是否已有收银员登陆，若有则取回收银员信息，若无，则提示收银员登陆3、 取回公告信息ums_manage_initsys（0006）上送字段名字段长度描述saenflag1同消费报文注：报文头中saoperid为空ums_manage_initsys（0006）返回字段名字段长度描述saretmsg255(max)返回内容描述，可为空saoperid20(max)收银员号，若为空，前台提示收银员登陆，并做登

28、陆交易saopername20(max)收银员姓名saannid2最新公告版本saannounce256(max)公告内容（不得含有|）safunc32开通功能sapinkey16最新的密钥samackey16最新的密钥samchtname根据saenflag返回中文或英文商户名称开通功能字段说明：每一位代表一项功能是否开通，1开通，其它屏蔽具体功能位定义如下（以delphi格式定义，后期可扩充）： topenfuncdef = (ofdreserved, ofdpca, ofdpra, ofdschtxn, ofdreprint, ofdmanage, ofdauthgroup, ofdin

29、q, ofdchongzhi, ofdmaxfield);收银员换班（不需要mac）ums_manage_chgoper（0007）上送字段名字段长度描述sapass/收银员登陆密码（收银员号在报文头），可根据后台配置是否验证密码失败返回：ums_manage_chgoper（0007）返回字段名字段长度描述saretmsg/返回内容描述，可为空注：换班由商户号终端号收银员号确定（规定一个商户号终端号下面只能由一个收银员号上机，除非该收银员下机后，其它收银员才能继续上机操作）未登记收银员上机记录（一般均需先登陆），返回e09。成功返回：ums_manage_chgoper（0007）返回字段名

30、字段长度描述saretmsg/返回内容描述，可为空sasum直接打印的要素salist1直接打印的要素salist2直接打印的要素直接打印的要素salistn直接打印的要素收银员换班1（不需要mac）ums_manage_chgoper1（0010）上送字段名字段长度描述sapass/收银员登陆密码（收银员号在报文头），可根据后台配置是否验证密码失败返回：ums_manage_chgoper1（0007）返回字段名字段长度描述saretmsg/返回内容描述，可为空注：换班由商户号终端号收银员号确定（规定一个商户号终端号下面只能由一个收银员号上机，除非该收银员下机后，其它收银员才能继续上机操作）

31、未登记收银员上机记录（一般均需先登陆），返回e09。成功返回：ums_manage_chgoper1（0010）返回字段名字段长度描述saretmsg/返回内容描述，可为空icnt后续list明细的数量salist1应用名称交易名称笔数金额，为0x1csalist2同上同上salistn同上收银员改密ums_manage_chgpass（0008）上送字段名字段长度描述saoldpass/旧密码（需要后台校验，看后台是否配置了校验密码）sanewpass/收银员新密码（收银员号在报文头）ums_manage_chgpass（0008）返回字段名字段长度描述saretmsg/返回内容描述，可为空

32、emv-pos应用类交易（功能号头两位03，如外卡业务）透明转发报文（需要mac）ums_emv_trans（0301）上送字段名字段长度描述sapkg/不含头两位的长度字段，长度由包头确定返回a00时返回：ums_emv_trans（0301）返回字段名字段长度描述sapkg如不为a00，则为空注:saretmsg返回错误信息复用返回包头结构中的satrack3字段当返回包文头结构中saretno(内部返回码)字段为exx时表示此交易需要pos终端发起冲正交易。pos交易上送服务器（功能号头两位05）pos交易上送服务器（需要mac）ums_emv_trans（0501）上送字段名字段长度描

33、述saretcode2posp交易处理返回信息，如交易成功为“00”，密码错误“55”等sabankcode8发卡银行代码saacqcode8结算银行代码sacardno19银行卡卡号sahostser12posp中心主机流水号satrtime14pos交易时间，其格式为yyyymmddhhmmsssaexpire4卡有效期sapatchno6批次号sapserial6流水号saauthno6授权号saamt12交易金额，小数点satrcode4交易类型，上送mis请求交易类型，与emv-pos上送保持一致satrstate2交易方式，01-正常交易, 02-拨号交易，03脱机交易saoldp

34、serial6原流水号saoldauthno6原授权号saacqdate4清算日期,格式mmddsaauthdate4授权日期,格式mmddsacardtype6卡类型,如银联卡为cupsaneedrev200-无需冲正,01-需冲正交易sasrvretcode3服务器返回代码sasrvretmsg/服务器返回错误信息返回：ums_emv_trans（0501）返回字段名字段长度描述sacupretmsg+sacuprethelp/返回a00时有效，放在一个字段内，格式：“【sacupretmsg】【sacuprethelp】”，如上送时saretcode为00，则该字段为空注:saretms

35、g返回错误信息复用返回包头结构中的satrack3字段pos交易上送服务器（需要mac）ums_emv_resendtrans（0502）上送字段名字段长度描述saretcode2posp交易处理返回信息，如交易成功为“00”，密码错误“55”等sabankcode8发卡银行代码saacqcode8结算银行代码sacardno19银行卡卡号sahostser12posp中心主机流水号satrtime14pos交易时间，其格式为yyyymmddhhmmsssaexpire4卡有效期sapatchno6批次号sapserial6流水号saauthno6授权号saamt12交易金额，小数点satrc

36、ode4交易类型，上送mis请求交易类型，与emv-pos上送保持一致satrstate2交易方式，01-正常交易, 02-拨号交易，03脱机交易saoldpserial6原流水号saoldauthno6原授权号saacqdate4清算日期,格式mmddsaauthdate4授权日期,格式mmddsacardtype6卡类型,如银联卡为cupsaneedrev200-无需冲正,01-需冲正交易sasrvretcode3服务器返回代码sasrvretmsg/服务器返回错误信息返回：ums_emv_resendtrans（0502）返回字段名字段长度描述sacupretmsg+sacuprethe

37、lp/返回a00时有效，放在一个字段内，格式：“【sacupretmsg】【sacuprethelp】”，如上送时saretcode为00，则该字段为空注:saretmsg返回错误信息复用返回包头结构中的satrack3字段公共事业缴费交易（功能号头两位06，如充值通等）公共事业缴费（需要mac）ums_emv_trans（0601）上送字段名字段长度描述satrcode2交易代码10签到交易 11缴费交易 12交易查询13交易统计14定制交易sapayway1支付方式1-银行卡交易，0-现金，2-无磁（手输卡号）sabankcard20银行卡号saamt13交易金额,带小数点sapin16银

38、行卡密码savender2服务提供商,详见附表sattype2业务类型，详见附表sacustid30服务提供商的客户标识号satrser30合作方业务流水saf1128备用字段返回代码为e开头时：ums_emv_trans（0601）返回字段名字段长度描述saretmsg64系统返回错误信息返回代码为a开头时:ums_emv_trans（0601）返回字段名字段长度描述saretmsg64系统返回错误信息saretcode2中心返回码saserial10终端流水samchtid15中心商户号satermid8中心终端号sabankcard20银行卡号sapbatch6批次号sapserial6

39、流水号saauthno6授权号sacserial12中心流水号saacqdate4清算日期saexpiry4有效期sainscode8发卡行saacqcode8收单行satser20业务受理流水 sapinfo1是否带打印信息,0-无，0则为打印小票联数saprtinfo640缴费等交易为打印信息,如为签到则为终端密钥匙,前40位32位pinkey+8位checkval,后40为32位mackey+8位checkval,均为bcd展开字符应该是16个字节注：查询交易的时候satrser如果不为空则表示为原交易终端流水，如果为空则读取saf1原交易外部流水号（原交易包头的流水），然后由后台系统根

40、据此值取的原交易终端流水。附：算法说明磁道信息压缩算法普通磁道信息在传输过程中应根据银联posp规范进行bcd码的转换，即将ascii编码的磁道信息压缩为bcd码，其中=号需事先转换为d字符，原则上后台不保存磁道信息，如有需要，后台数据库只允许保存二磁道信息的前12个字节，作为交易索引mac算法【报文头】+【报文体】部分按每8位异或，最后不足部分使用0填充，结果通过bcd算法展开，取前8个字节作为mac。内部接口定义兼容接口定义1.6 数据库定义1.7 数据字典定义内部返回码返回码含义a00交易成功a01交易成功，有中奖信息e00通讯超时e01非法交易类型e02内部检测不通过e03加密机操作失

41、败e04数据库操作失败e05无公告信息e06身份认证失败e07终端密钥与主机存放密钥不符e08服务器上未找到对应原交易e09未登记收银员上机记录e10后台交易记录已成功（前台流水一致），应提示到后台查询并重打印该笔交易e99pos交易包转发成功，系统内部处理失败，需冲正外部返回码银联返回码定义：其它返回码定义：其它1.8 命名规范二、 客户端系统设计2.1 系统选型操作系统：windows（标准版）数据库：无2.2 系统模块划分客户端由单一主应用进程（umsclient.exe）构成。主程序分为底层硬件驱动层、应用逻辑层及主应用程序三层。底层硬件驱动层负责操作收银机外设，根据收银机的不同提供不

42、同的外设驱动库；应用逻辑层负责具体的应用逻辑，包括操作硬件驱动、采集交易必须的输入内容、组织通讯逻辑报文、与后台服务端通讯等功能，应用逻辑根据不同的应用封装，以便于日后升级维护；主应用程序负责组织应用程序的框架、初始化应用环境等功能。2.3 模块详细设计硬件驱动层设计所有硬件驱动库必须包含以下公共接口： 获取驱动库信息接口procedure umspub_vgetdrvinfo(var itype: integer; sadesp: pchar);itype：输出，驱动库类型，0密码键盘、1刷卡器、2打印机sadesp：输出，驱动中文描述，用于快速判别驱动功能a)密码键盘驱动密码键盘驱动必须实

43、现以下接口： 初始化动态库环境外部应用在使用本驱动时必须首先调用，否则其它接口将直接报错 sint umspinpad_iinit(char *sadevname, int iboudrate, int imin, int imax)参数：sadevname：密码键盘接口，如com1iboudrate：波特率，如1200、9600imin：输入密码的最小长度，0时不设置imax：输入密码的最大长度，1时不设置返回：0成功，0失败 设置工作密钥（此函数在随即改变工作密钥时使用）该函数在umspinpad_ireadpin中已联动调用，上层应用可根据情况选择是否调用int umspinpad_is

44、etworkkey(char *sapinkey, char *samackey)参数： sapinkey：新的pin工作密钥密文（已使用主密钥加密,null则不修改）samackey：新的mac工作密钥密文（已使用主密钥加密,null则不修改）返回：0成功，0失败 使密码键盘提示输入密码、显示金额并发出语音，使用ansi9.8算法进行运算 int umspinpad_ireadpin(char *saencpin, char *sapinkey, char *sacardno, int itimeout, double damt)参数：saencpin：函数返回的ansi运算出的密文sapi

45、nkey：pin工作密钥密文（为null则不修改工作密钥而使用以前的）sacardno：参加ansi9.8运算的卡号（如果为null则不使用ansi9.8算法）itimeout：超时时间damt：在显示屏上显示的金额，如0，则不显示返回值：0 成功，非0 失败 下传数据使用ecb算法计算mac（数据长度不得大于256字节） int umspinpad_igenmac(char *samackey, int idatalen, char *sadatabuf, int itimeout, char *samacbuf)参数：mackeytmp：工作密钥的密文idatalen：数据长度（不超过25

46、6字节，超过按前256个字节计算mac）sadatabuf：数据itimeout：超时时间samacbuf：返回mac数据（8字节）返回值：0成功，非0失败b) 刷卡器驱动刷卡器驱动必须实现以下接口： 获取磁道信息通用接口function umstrack_igettrack(sadevname: pchar; iboudrate, imaxwaittime, icfgtracknum: integer;var ilen2, ilen3: integer; satrack2, satrack3: pchar): integer; stdcall;imaxwaittime：输入，最大等待刷卡时间

47、（单位秒），一般为18icfgtracknum：输入，刷卡器回车数目，一般为1或2ilen2、ilen3：输出，2、3磁道长度satrack2、satrack3：输出，2、3磁道信息c) 打印机驱动 初始化驱动（一些驱动需要打开端口及其它初始化操作）上层应用调用打印驱动必须首先调用初始化procedure umsprn_vinitprn(icom: integer);stdcall;icom：端口号，如com1（或prt1），则icom=1， 关闭驱动（一些驱动需要关闭端口，打印结束之后调用）上层应用调用打印驱动后，必须调用procedure umsprn_vcloseprn;stdcall; 打印一行信息procedure umsprn_vprintline(const prncom: integer; info: pchar);stdcall;prncom：端口地址（写端口模式适用），如888，1000等