金融POS机与收银机标准函数接口说明(windows版本2013).docx

金融POS机与收银机标准接口函数说明2013年3月动态库接口定义 /// summary动态库名字:LIBSAND.DLL(WIN) LIBSAND.SO(LINUX)///ZLSH.LIB(DOS) ///函数名称：card_trans ///函数功能：按传入数据完成刷卡任务/// com串口号 /// upData 传入数据 /// downData传出数据 ////summaryvoid card_trans(int com, char * upData, char * downData);传入传出数据结构定义：（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 OriginTraceNo[6];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 OriginTraceNo[6];char SysTracdNo [6];char OriginSysTraceNo [6];char Reserved[48];};批次（概念）：上一笔结算到本次结算之间称为一批次。撤销（概念）：当批次且当天内对之前一笔消费（当天）进行全额撤销。正常情况下一天营业结束做结算，所以以当天为撤销的有效期。退货（概念）：隔天，对前一笔消费进行全额或部分退货。金额问题：传入金额为收银机传入需要消费或撤销的金额，传出金额为实际的消费或撤销金额，固将传入金额与传出金额做比较。（联华OK卡交易，如下发金额大于卡内余额，联华后台会将卡内余额扣掉，返回实际的交易金额，所以联华OK卡交易时要判断金额）。传入字段说明：字段名称长度数据类型备注操作类型2ASC固定值（见操作类型表）交易类型2ASC固定值（见交易类型表）卡类型2ASC固定值（见卡类型表）收银机编号6ASC商场内唯一（左补零，无则全补空格）柜员号6ASC（左补零，无则全补空格）金额12ASC以分位单位（左补零）收银流水号6ASC同一收银机内唯一（左补零，无则全补空格）系统流水号6ASC撤销时填写预留字段48ASC银行卡退货交易时，左起12位参照号4位日期MMDD支付宝、微信条码支付交易时付款码从左起传入条形码传出字段说明：字段名称长度数据类型备注操作类型2ASC固定值（见操作类型表）交易类型2ASC固定值（见交易类型表）卡类型2ASC固定值（见卡类型表）返回码2ASC“00”为成功，其它详见错误返回码表返回信息40ASC返回码对应的信息收银机编号6ASC柜员号6ASC金额12ASC交易的实际金额，以分位单位（左补零）联华OK卡交易，如下发金额大于卡内余额，联华后台会将卡内余额扣掉，返回实际的交易金额，所以联华OK卡交易时要判断金额银行卡交易金额返回为收银机下发金额。结算批次6ASC商户号15ASC商户名称40ASC终端号8ASC卡号19ASC卡有效期4ASC发卡行编码6ASC（见发卡行编码表）交易日期8ASCYYYYMMDD交易时间6ASCHHMMSS授权号6ASC系统参照号12ASC退货时要用到的参照号收银流水号6ASC原收银流水号6ASC撤销原样返回系统流水号6ASC原系统流水号6ASC预留字段48ASC巍康和斯玛特交易时，返回12位卡余额+24位斯玛特批次号联华卡交易时，返回12位卡余额+15票据号微信、支付宝的交易，返回的应是交易号，最大长度为32有优惠交易时，预留字段前12位放实际交易