收银机接口文档.doc

收银机接口文档在使用这套接口软件前，需在系统运行的当前目录创建一个data的子目录，拷贝error.txt文件和syj.dll 、pad03.dll、mfcdll.dll文件和posdot.lib文件到当前目录。在当前目录创建一个syj.ini的参数文件，内容包含：商户号、终端号、远程IP地址，端口号等。收银机的银行卡功能都是通过下面这个函数实现,通过不同的参数实现不同的功能int trans_proc ( TRANS_STR_REQ * loca_req, TRANS_STR_RESP * loca_res)1参数说明:loca_req: 发送交易请求的数据结构.Loca_res:交易回应的数据结构typedef structchar type2; /交易类型char amount12;/交易金额char inputmode;/卡信息输入方式/char track238;/二磁道信息/char track3105;/三磁道信息char addi100; /附加信息(不同交易附加信息格式不同) TRANS_STR_REQ;typedef structchar type2; /交易类型char amount12; /交易金额char shop_no15; / 商户号char terminal8; /终端号char pan19;/主帐号char settle_date4; /清算日期char translate_time10; /交易日期时间char exp_date4;/卡有效期char trace_no6;/流水号char auth_code6;/授权号char batch6;批次号char retr_num12;系统参考号char bank_message15;银行信息char card_type15;卡类信息char people_id20; 个人标识char addi_data50;附加数据char ret_code2;返回码 TRANS_STR_RESP;如果type=01且people_id=Y或type=02是表示交易已撤消2返回值说明若交易正常，函数返回 SUCC，别的返回以下错误信息代码： ERR_TRANS -20 交易错误，不受理该交易 SUCC 0 交易成功 FAIL-1交易失败 DB_CREATE_ERROR 2 数据库创建失败 DB_OPEN_ERROR -3数据库打开失败 DB_READ_ERROR -4读数据库失败 ERROR_DATA -5错误的数据格式 AUTO_VOID_FAIL -6冲正失败 CONNECT_ERROR -7网络连接失败 SEND_ERROR -8数据发送失败 RECV_ERROR -9数据接收失败或超时 DATA_ERROR -10数据错误 DATA_ERROR_TRACK 11磁道信息错误 READ_PIN_ERROR -12读密码失败 DB_WRITE_ERROR -13写数据库失败 PWD_ERROR -14超级柜员密码错 NO_RECORD -15 没有记录 TRANS_CANCL -16 交易被取消 PINPAD_ERROR -17 密码键盘错误WIN_SOCKE_ERR -18/建立WIN_SOCKET失败LOAD_CARDNO_ERR-19/装载卡号错误SELECT_MAST_KEY_ERR -21/选择主密钥失败LOUD_MAC_KEY_ERR -22/下装MAC密钥失败LOUD_PIN_KEY_ERR -23/下载PIN密钥失败CACUL_MAK_ERR -24/计算MAC包失败VOID_TRAN_ERR -25/冲正失败READ_TRACEK_ERR -26/读磁道信息错误TRANS_TRACE_ERR -27/交易流水号错误POS_ID_ERR -28/交易终端号错误TRANS_AMOUNT_ERR -29/交易金额错误UNPACKET_ERR -30/解包错误READ_PIN_ERR -31 /读密码失败OPEN_COM_ERR -32 /打开串口失败FIND_TRACE_ERR -33 /查交易流水失败FIND_SYSTEM_ERR -34 /查系统参数失败FIND_BANKCAN_ERR -35 /查银行参数失败FIND_CARDCAN_ERR -36 /查卡种类参数失败FIND_CUOYUXINXI -37 /查错误信息参数失败AUTO_VOID_TRACE_FAIL -38 /冲正原交易流水错误AUTO_VOID_POSID_FAIL -39 /冲正原交易终端号错误SEND_VOID_ERROR -40 /发送冲正包错误RECV_VOID_ERROR -41 /接收冲正包错误3交易说明a)type 赋值范围01: /* 磁卡消费 */03: /*退货 */17:/*POS查询余额*/18:/*POS查止付*/13:/*预授权*/15:/*预授权完成*/05:/*结算*/12:/*参数下载*/14:/*预授权撤消*/16:/*预授权完成撤消*/02:/*磁卡消费撤消 */04:/*退货撤消*/19: /* 查询交易流水*/20:/*系统初始化 */21:/*查询系统参数*/ 97: /*显示密码键盘默认信息*/98： /*关闭密码键盘串口*/99:/*初始化密码键盘口*/b) inputmode 赋值范围0磁条输入带密码1磁条输入不带密码2手工输入带密码3手工输入不带密码c) addi 附加信息的使用方法1) 作12交易时，附加信息值为：1为下载系统参数；2为下载银行参数；3为下载卡类信息2) 作19交易时，附加信息放6位的交易流水号（“000000”为查询最后一笔流水）3) 作01交易时，在输出数据前两个字节为“ZF”时，应显示”ZF”之后的数据，并将ZF后的数据打印在凭证上（消费在线中奖业务）。4) 作21交易查询系统参数时，附加信息的第一位存放查询参数的类别，应用方式为：i. 1 系统参数信息，后接数据为a) 05 商户名b) 06终端名ii. 2 银行信息 ，后接数据为3位银行代码iii. 3卡类信息，后接数据为2位的卡类代码iv. 4错误信息，后接数据为2位的错误代码6）作 02，14，16等撤消交易时，附加信息数据为6位的超级柜员的密码和6位交易流水号4备注当系统使用这套接口软件时，在首次使用时调用 20 交易 创建基本的数据库和参数文件。之后调用 12 交易下载密钥和系统参数。建议在系统启动时，调用99 交易初始化密码键盘口，以减少在交易时的等待时间。在做消费或撤消交易等与金额有关的联机交易，只有在返回信息的数据中的ret_code等于00时，交易才算真正成功。若交易成功时（ret_code = 00），bank_message的数据格式为3为的银行代码和8位的银行名称，card_type 的数据格式为2位的卡类代码和6位的卡名称。读磁道信息函数int read_track( char *track2, char *track3) 若交易正常，函数返回 SUCC,别的不成功 参数说明：track2：二磁道信息存放地址，需分配大于37个字节空间； track3：三磁道信息存放地址，需分配大于104个字节空间；附磁条卡格式：必须有第二磁数据，三磁数据有的话就一起上送。二磁格式： ；数据？（最大长度40字节）三磁格式： +数据？（最大长度107字节）第三方商户与键盘接口下装主密钥接口函数load_tc_master_key( char *key)返回 SUCC 为成功，别的为失败，key 为16位ASCII 字符（0F）装载工作密钥load_tc_workkey(unsigned char * key )返回 SUCC 为成功，别的为失败，key 为16位ASCII 字符（0F）读取客户密码read_tc_pin(char *card_no,char *amount, char *m_data)返回 SUCC 为成功，别的为失败参数说明： card_no, 用户卡号，最右16位 amount, 用户此次消费金额 m_data, 获取的用户密码密文，为16位ASCII 字符（0F）消费凭证格式要求：API 调用范例：查询交易： TRANS_STR_RESP loca_res;TRANS_STR_REQ * loca_req;Int ret; Memset(&loca_res,0,sizeof(loca_res);Memset(&loca_req,0,sizeof(loca_req);If (read_track( loca_req.track2, loca_req.track3)0) Return Memcpy(loca_req. type,”17”,2);If ( 要输入密码？) Loca_req.inputmode=0;Else Loca_req.inputmode=1;Ret = trans_proc(&loca_req,&loca_res);If ( Ret 0) 显示错误信息；If ( memcmp(loca_res. ret_code.”00”,2)!=0) Memcpy(loca_req,”21”,2);Sprintf(loca_req. addi,”4%2.2s”,loca_res.ret_code);Memset(&loca_res,0,sizeof(loca_res);Trans_proc(&loca_req,&loca_res);MessageBox(NULL,loca_res. addi_data,”msg”,MB_OK); / 显示交易不成功原因显示交易成功，提示持卡人在密码键盘上查看余额消费交易：TRANS_STR_RESP loca_res;TRANS_STR_REQ * loca_req;Int ret; Memset(&loca_res,0,sizeof(loca_res);Memset(&loca_req,0,sizeof(loca_req);If (read_track( loca_req.track2, loca_req.track3)0) Return Memcpy(loca_req. type,”17”,2);If ( 要输入密码？) Loca_req.inputmode=0;Else Loca_req.inputmode=1;Memcpy(loca_req.amount,交易金额，12)；/以分为单位Ret = trans_proc(&loca_req,&loca_res);If ( Ret 0) 显示错误信息；If ( memcmp(loca_res. ret_code.”00”,2)!=0) Memcpy(loc