自助终端收银系统Windows标准接口文档V3.3.0..docxVIP

银联商务自助终端收银系统系统Windows标准接口文档 第 PAGE 6页共 NUMPAGES 13页 FILENAME \* Upper \* MERGEFORMAT银联商务自助终端收银系统Windows标准接口文档V3.3.0 银联商务有限公司技术开发中心MIS室  版本控制信息 版本 日期 拟稿和修改人 说明 1.0.0 2014-08-26 王玉珏 创建 2.0.0 2014-10-30 王玉珏 修改交易编号 增加全民付48域组织说明 3.0.0 2014-12-03 王玉珏 增加对传统业务IC卡的支持 3.1.0 2015-01-16 王玉珏 增加对增值业务手机充值、信用卡还款IC卡的支持 3.2.0 2015-03-05 王玉珏 增加对外挂非接模块R50、R30的支持 3.3.0 2015-04-25 王玉珏 增加关闭读卡器函数、吞卡函数 3.3.0 2015-04-29 王玉珏 增加传统交易必填要素表 本文档中的所有内容为中国银联商务有限公司的机密和专属所有。未经中国银联商务有限公司的明确书面许可，任何组织或个人不得以任何目的、任何形式及任何手段复制或传播本文档部分或全部内容。  文档说明 本文档向收银软件开发商描述了银联商务windows版本自助收银系统的接口和调用流程。此版本采用插卡器实现IC、磁条卡联机，采用外挂式非接模块（R50、R30）实现闪付交易（目前只在传统应用内支持闪付类的消费和查余交易）。 函数调用流程 调用初始化函数UMS_Init(appType)，初始化应用类型根据所要进行的业务类型取值。 调用进卡函数UMS_EnterCard()，系统根据配置设置读卡器为可插、挥卡状态。此函数同时尝试开启插卡器和外挂非接感应器，并返回设备开启情况。 根据第2步返回结果，提示用户插、挥卡。 调用检测卡函数UMS_CheckCard (byte *state_out)，判断读卡器内或者非接感应器上是否有卡。如果有卡则关闭另一个设备。并以返回值返回采用了哪个设备。（此过程会阻滞约2秒钟时间）建议循环调用,直至检测卡超时时间到来。 当检测到卡片插入或在非接模块感应区内之后，调用读卡函数UMS_ReadCard (char *cpData)，此时会返回给ERP用户卡号。此函数会检测卡片类型，产生阻滞。 对于联机交易，读卡成功后，调用打开密码键盘函数UMS_StartPin()。 提示用户输入密码。 调用取键值函数UMS_GetOnePass (unsigned char *key_out)，根据具体的键值绘制密码输入画面。 密码输入完毕后，调用取用户密码密文函数UMS_GetPin ()。 调用交易函数UMS_TransCard (char *strReq, char *strResp)进行交易。如果该交易函数是无磁无密函数，则跳过2~9步。对于闪付类交易，跳过6~9步。 调用关闭读卡器函数UMS_EjectCard ()，弹出卡片（关闭非接模块），并提示用户拔卡、取走卡片。（若为磁条卡，也可以在第5步之后弹出卡片，防止持卡人忘记取卡。若为闪付交易，请让持卡人在交易过程中保持卡片在非接感应器上，不可以中途移走卡片。） 继续循环调用UMS_CheckCard (byte *state_out)，判断持卡人是否真正拿走了卡片。 如持卡人在时限内未拿走卡片，调用吞卡函数UMS_CardSwallow()，将卡片没收。 调用关闭读卡器函数UMS_CardClose()。 函数说明 所有函数都封装在umsapi.dll里。使用前请先加载此动态库。也可以采用头文件加lib库的形式静态加载。发布文件请仅仅放置于c:\umsips文件夹目录下。 初始化 int UMS_Init(int appType); 功能描述：初始化密码键盘、检查冲正、检查签到结算、下公钥、下公参、检查设备能力、脱机交易上送、TC上送。 参数：apptype:应用类型 1:传统银行卡应用 2:全民付应用 3:预付卡。不同应用支持的交易类型，见本章3.11节。 返回： 0：成功 其他情况： -101：appType非法 -102：加载主配置main.ini失败 -103：初始化密码键盘失败 -104：银联卡模块初始化失败 -105：增值模块初始化失败 -106：预付卡模块初始化失败 -107：暂不支持的appType -108：向EMV内核下载IC卡参数失败 进卡 int __stdcall UMS_EnterCard() 功能描述：允许读卡器进卡，调用成功后，提示用户插卡。 参数：无。 返回： 0:插卡器启动成功，外挂非接模块无法打开； 1:外挂非接模块启动成功，插卡器无法打开； 2:外挂非接模