金融POS机与收银机标准函数接口说明

金融POS机与收银机标准接口函数说明上海杉德银卡通信息服务有限公司2008年10月目录(一)动态库接口定义31.传入传出数据结构定义：（C语言）32.传入字段说明：43.传出字段说明：4(二)相关表定义51.操作类型表：52.交易类型表：53.卡类型表：54.字段与交易类型关系表：（M为必填字段）6(三)收银一体化61)串口POS一体化通讯流程：7附录一 发卡行标识11附录二 动态库返回码表：（动态库只返回串口通讯上的错误）12附录三 其它部分返回码及信息12(一) 动态库接口定义 / 动态库名字:LIBSAND.DLL(WIN) LIBSAND.SO(LINUX)/ZLSH.LIB(DOS) /函数名称：card_trans /函数功能：按传入数据完成刷卡任务 /参数：/ com 串口号 / upData 传入数据 / downData传出数据 / void card_trans(int com, char * upData, char * downData);1. 传入传出数据结构定义：（C语言） struct strTransUp struct strTransDown char OperateType 2; char OperateType 2;char TransType 2; char TransType 2;char CardType 2; char CardType 2;char CashRegNo 6; char ResponseCode 2;char CasherNo 6; char ResponseMsg 40;char Amount 12; char CashRegNo 6;char CashTraceNo 6; char CasherNo 6;char OriginTraceNo6; char Amount 12;char Reserved 48; char SellteNum 6; char MerchantID 15;char MerchantName 40;char TerminalID 8;char CardNo 19;char Exp_Date 4;char BankNo 6; char TransDate 8;char TransTime 6;char Auth_Code 6;char SysRefNo 12;char CashTraceNo 6;char OriginTraceNo6;char SysTracdNo 6;char OriginSysTraceNo 6;char Reserved 48; ;2. 传入字段说明：字段名称长度数据类型备注操作类型2ASC固定值（见操作类型表）交易类型2ASC固定值（见交易类型表）卡类型2ASC固定值（见卡类型表）收银机编号6ASC商场内唯一（左补零，无则全补空格）柜员号6ASC（左补零，无则全补空格）金额12ASC以分位单位（左补零）收银流水号6ASC同一收银机内唯一（左补零，无则全补空格）系统流水号6ASC撤销时填写预留字段48ASC退货交易时，左起12位参照号4位日期MMDD3. 传出字段说明：字段名称长度数据类型备注操作类型2ASC固定值（见操作类型表）交易类型2ASC固定值（见交易类型表）卡类型2ASC固定值（见卡类型表）返回码2ASC“00”为成功，其它详见错误返回码表返回信息40ASC返回码对应的信息收银机编号6ASC柜员号6ASC金额12ASC以分位单位（左补零）结算批次6ASC商户号15ASC商户名称40ASC终端号8ASC卡号19ASC卡有效期4ASC发卡行编码6ASC（见发卡行编码表）交易日期8ASCYYYYMMDD交易时间6ASCHHMMSS授权号6ASC系统参照号12ASC退货时要用到的参照号收银流水号6ASC原收银流水号6ASC撤销原样返回系统流水号6ASC原系统流水号6ASC预留字段48ASC巍康和斯玛特交易时，返回12位卡余额+24位斯玛特批次号联华卡交易时，返回12位卡余额+15票据号(二) 相关表定义1. 操作类型表：操作代码操作类型备注“A0”交易返回“A1”“B0”查询返回“B1”2. 交易类型表：交易代码交易类型备注“30”消费返回“31”“40”撤销返回“41”“50”退货返回“51”（支持部分退货功能）“90”初始化斯玛特，魏康卡用，银行卡无此项“91”签到必须支持此功能“92”结算必须支持此功能3. 卡类型表：卡类型编码卡类型备注“01”银行卡“03”斯玛特卡“06”巍康卡“05”联华OK卡“07”联华积点卡4. 字段与交易类型关系表：（M为必填字段）交易类型操作类型交易类型卡类型收银机编号操作员号金额收银机流水号原收银机流水号预留字段消费A030M撤销A040MM退货A050MM初始化A090签到A091结算A092(三) 收银一体化收银一体化指将业务终端和POS机有机的连接或统一起来，实现系统整合。收银一体化的方式是多样的，主要有以下几种：1） 串口POS（通过串口与服务器实现通讯）一体化串口POS起到了取卡信息与密码输入的作用，除了取卡信息和密码输入外，还需要控制POS机与业务终端的动态库之间的交互，以便多批不同数据的处理。动态库需要多次从POS机接受指令并传递数据给服务器；2） 网络POS一体化网络POS实现与收银一体化，动态库的任务是从业务终端接收交易指令，并传递给POS机，然后由POS机完成与服务器的交互并将交易结果返回给业务终端。3） 拔号POS一体化与网络POS类似，不同之处是POS机是以电话线拔号的方式通讯。1) 串口POS一体化通讯流程：串口一体化网络拓扑图：附录一 发卡行标识序前2位含义第3至6位含义100内卡0001交换中心200内卡0102工商银行300内卡0103农业银行400内卡0104中国银行500内卡0105建设银行600内卡0100邮政储汇局700内卡0301交通银行800内卡0302中信实业银行900内卡0303光大银行1000内卡0304华夏银行1100内卡0305民生银行1200内卡0306广发银行1300内卡0307深发银行1400内卡0308招商银行1500内卡0309兴业银行1600内卡0310浦发银行1700内卡0311 | 0401上海银行1800内卡0402 | 6501上海农信1900内卡0408 | 6408宁波银行2000内卡0410平安银行2100内卡0316浙江银行2200内卡0317渤海银行2300内卡0403北京银行2400内卡0417盛京银行2500内卡0420大连银行2600内卡0423杭商银行2700内卡0434天津银行2800内卡4802银联商务天津分公司2901威士卡XXXXVISA3002万事达卡XXXXMaster Card3103JCB卡XXXXJCB3204大来卡XXXXDinner Club3305运通卡XXXXAmerican Express附录二 动态库返回码表：（动态库只返回串口通讯上的错误）代码错误信息备注D1“LRC校验错误”几乎不会有此错误16“初始化COM错误”设备被占用或没找到D2“打开COM错误”线路不通时返回（常见）D3“接收COM错误”几乎不会有此错误D4“发送COM错误”几乎不会有此错误D6“操作类型错误”几乎不会有此错误D7“交易类型错误”几乎不会有此错误13“交易金额错误”几乎不会有此错误附录三 其它部分返回码及信息代码返回信息含义00Approved Or Completed Successfully承兑或交易成功01Refer To Card Issuer查发卡方02Refer To Card Issuers Special Condition查发卡方的特殊条件03Invalid Merchant无效商户04Pick-up没收卡05Do Not Honor不予承兑06Error出错07Pick-up Card, Special Condition特殊条件下没收卡09Request In Progress请求正在处理中12Invalid Transaction无效交易13Invalid Amount无效金额14Invalid Card Number(No Such Number)无效卡号15No Such Issuer无此发卡方19Re-enter Transaction重新送入交易20Invalid Response无效应答21No Action Taken不作任何处理22Suspected Malfunction怀疑操作有误23Unacceptable Transaction Fee不可接受的交易费25Unable To Locate Record On File未能找到文件上记录30Format Error格式错误31Bank Not Supported By Switch交换中心不支持的银行33Expired Card过期的卡(没收卡)34Suspected Fraud有作弊嫌疑(没收卡)35Card Acceptor Contact Security受卡方与安全保密部门联系(没收卡)36Restricted Card受限制的卡(没收卡)37Card Acceptor Call Acquirer Security受卡方呼受理方安全保密部门(没收卡)38Allowable PIN Tries Exceeded超过允许的PIN试输入(没收卡)39No Credit Account无此信用卡帐户40Requested Function Not Supported请求的功能尚不支持41Lost Card挂失卡(没收卡)42No Universal Account无此帐户43Stolen Card, Pick-up被窃卡(没收卡)44No Investment Account无此投资帐户45-50Reserved For ISO UseISO保留使用51Not Sufficient Funds无足够的存款52No Chequing Account无此支票帐户53No Saving Account无此储蓄卡帐户54Expired Card过期的卡55Incorrect Personal Identification Number不正确的PIN56No Card Record无此卡记录57Transaction Not Permitted To Cardholder不允许持卡人进行的交易58Transaction Not Permitted To Terminal不允许终端进行的交易59Suspected Fraud有作弊嫌疑60Card Acceptor Contact Acquirer受卡方与安全保密部门联系61Exceeds Withdrawal Amount Limit超出取款金额限制62Restricted Card受限制的卡63Security Violation违反安全保密规定64Original Amount Incorrect原始金额不正确65Exceeds Withdrawal Frequency Limit超出取款次数限制66Card Acceptor Call Acquirers Security Department受卡方呼受理方安全保密部门67Hard Capture(Requires That Card Be Picked Up At ATM)捕捉(没收卡)68Response Received Too Late收到的回答太迟69-74Reserved For ISO UseISO保留使用75Allowable Number Of PIN Tries Exceeded允许的输入PIN次数超限77需要向网络中心签到POS批次与网络中心不一致78网络中心需要向POS终端下载数据网络中心需要向POS终端下载数据79脱机交易对帐不平POS终端上传的脱机数据对帐不平76-89Reserved For Private Use私有保留使用90Cutoff Is In Process日期切换正在处理91Issuer Or Switch Is Inoperative发卡方或交换中心不能操作92Financial Institution Or Intermediate Network Facility Cannot Be Found For Routing金融机构或中间网络设施找不到或无法达到 93Transaction Cannot Be Completed. Violation Of Law交易违法、不能完成94Duplicate Transaction重复交易95Reconcile Error调节控制错96System Malfunction系统异常、失效97Invalid ATM/POS IdsATM/POS终端号找不到98SW couldnt get reply from IS交换中心收不到发卡方应答99PIN Block ErrorPIN 格式错A0MAC FailedMAC鉴别失败以下为POS冲正原因码Z0Response Receiv