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

《自助终端收银系统Windows标准接口文档.docx》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、银联商务自助终端收银系统Windows标准接口文档V3.3.0银联商务有限公司技术开发中心MIS室版本控制信息版本日期拟稿和修改人说明1.0.02014-08-26王玉珏创建2.0.02014-10-30王玉珏修改交易编号增加全民付48域组织说明3.0.02014-12-03王玉珏增加对传统业务IC卡的支持3.1.02015-01-16王玉珏增加对增值业务手机充值、信用卡还款IC卡的支持3.2.02015-03-05王玉珏增加对外挂非接模块R50、R30的支持3.3.02015-04-25王玉珏增

2、加关闭读卡器函数、吞卡函数3.3.02015-04-29王玉珏增加传统交易必填要素表本文档中的所有内容为中国银联商务有限公司的机密和专属所有。未经中国银联商务有限公司的明确书面许可，任何组织或个人不得以任何目的、任何形式及任何手段复制或传播本文档部分或全部内容。1文档说明本文档向收银软件开发商描述了银联商务windows版本自助收银系统的接口和调用流程。此版本采用插卡器实现IC、磁条卡联机，采用外挂式非接模块（R50、R30）实现闪付交易（目前只在传统应用内支持闪付类的消费和查余交易）。2函数调用

3、流程1)调用初始化函数UMS_Init(appType)，初始化应用类型根据所要进行的业务类型取值。2)调用进卡函数UMS_EnterCard()，系统根据配置设置读卡器为可插、挥卡状态。此函数同时尝试开启插卡器和外挂非接感应器，并返回设备开启情况。3)根据第2步返回结果，提示用户插、挥卡。4)调用检测卡函数UMS_CheckCard(byte*state_out)，判断读卡器内或者非接感应器上是否有卡。如果有卡则关闭另一个设备。并以返回值返回采用了哪个设备。（此过程会阻滞约2秒钟时间）建议循环调

4、用,直至检测卡超时时间到来。5)当检测到卡片插入或在非接模块感应区内之后，调用读卡函数UMS_ReadCard(char*cpData)，此时会返回给ERP用户卡号。此函数会检测卡片类型，产生阻滞。6)对于联机交易，读卡成功后，调用打开密码键盘函数UMS_StartPin()。7)提示用户输入密码。8)调用取键值函数UMS_GetOnePass(unsignedchar*key_out)，根据具体的键值绘制密码输入画面。9)密码输入完毕后，调用取用户密码密文函数UMS_GetPin()。10)调用

5、交易函数UMS_TransCard(char*strReq,char*strResp)进行交易。如果该交易函数是无磁无密函数，则跳过2~9步。对于闪付类交易，跳过6~9步。11)调用关闭读卡器函数UMS_EjectCard()，弹出卡片（关闭非接模块），并提示用户拔卡、取走卡片。（若为磁条卡，也可以在第5步之后弹出卡片，防止持卡人忘记取卡。若为闪付交易，请让持卡人在交易过程中保持卡片在非接感应器上，不可以中途移走卡片。）12)继续循环调用UMS_CheckCard(byte*state_out)，

6、判断持卡人是否真正拿走了卡片。13)如持卡人在时限内未拿走卡片，调用吞卡函数UMS_CardSwallow()，将卡片没收。14)调用关闭读卡器函数UMS_CardClose()。3函数说明所有函数都封装在umsapi.dll里。使用前请先加载此动态库。也可以采用头文件加lib库的形式静态加载。发布文件请仅仅放置于c:umsips文件夹目录下。3.1初始化intUMS_Init(intappType);功能描述：初始化密码键盘、检查冲正、检查签到结算、下公钥、下公参、检查设备能力、脱机交易上送、

7、TC上送。参数：apptype:应用类型1:传统银行卡应用2:全民付应用3:预付卡。不同应用支持的交易类型，见本章3.11节。返回：0：成功其他情况：-101：appType非法-102：加载主配置main.ini失败-103：初始化密码键盘失败-104：银联卡模块初始化失败-105：增值模块初始化失败-106：预付卡模块初始化失败-107：暂不支持的appType-108：向EMV内核下载IC卡参数失败1.1进卡int__stdcallUMS_EnterCard()功能描述：允许读卡器进卡，调用

8、成功后，提示用户插卡。参数：无。返回：0:插卡器启动成功，外挂非接模块无法打开；1:外挂非接模块启动成功，插卡器无法打开；2:外挂非接模块、插卡器均启动成功；-201~-210:失败。1.2检测卡int__stdcallUMS_CheckCard(byte*state_out)功能描述：返回读卡器内卡片位置，可循环调用，建议1秒为周期。参数：state_out:卡片信息码位置码含义说明0x34卡在插卡器卡口位置可提示用户插、拔卡0x35未检测到卡可提示用户插卡、挥卡0x37插卡器内