项目背景
目前,越来越多的酒店入住登记是通过支付宝设备,进行便捷的入住登记。支付宝设备的应用不仅提高了入住效率,还提升了客户体验。对于宾客而言,无需排队等待前台办理入住手续,减少了等待时间。同时,自助入住方式更加私密,个人信息更加安全。此外,支付宝设备还支持多种支付方式,如扫码支付、刷脸支付等,为宾客提供了更加便捷的支付体验。
诺塔斯智能身份证云读卡器是支付宝设备入住登记的一个重要信息采集设备,使用支付宝小程序入住登记需要接入将诺塔斯身份证云读卡器。诺塔斯身份证云读卡器支持可读写基于ISO14443 TYPE A/B协议的13.56MHz非接触式智能卡、NFC电子标签。通过USB2.0接口或RS232实现与上位机及其相关设备进行通信,USB采用免驱技术能够与多种设备和应用相互操作,即插即用无需安装USB驱动,方便用户安装使用。随机提供多种平台、多语言的二次开发包,丰富的函数接口和范例源码,用户二次开发照搬范例即可,开发难度极小。附带演示程序实现访问射频卡的全部功能,支持Windows、Linux、Android、统信UOS,麒麟,鸿蒙等操作系统。
在支付宝开放平台搜索读卡器可以查询到支持接入支付宝小程序的身份证阅读器厂商名单,如下图所示。
接口调用
设置云读卡器
my.ix.cardReaderCommand({
cmds: {'cmd':'setConfigs', 'args': [{'server':'设备代码', 'appId':'XXXXXXXXXXXXX'}]},
success: (r) => {
this.setData({
message: "设置成功--> " +JSON.stringify(r)
})
},
fail: (r) => {
this.setData({
message: "设置失败--> " +JSON.stringify(r)
})
},
});
读卡
my.ix.cardReaderCommand({
cmds: {'cmd':'readCard', 'args': []},
success: (r) => {
this.onCardInfo(r)
},
fail: (r) => {
this.setData({
message: "读卡失败--> " +JSON.stringify(r)
})
},
});
读卡器状态监听 是监听读卡器与主机设备连接状态的 API。主要有以下两个步骤:
- 等待读卡器状态改变的回调。
- 结束状态监听。
-
示例代码
.js 示例代码
-
开始监听读卡
my.ix.onMonitorCardReader((r) => { if (r.success) { this.onCardInfo(r) } else { this.setData({ message: "读卡失败--> " +JSON.stringify(r) }) } })
停止监听读卡
my.ix.offMonitorCardReader({ complete: (r) => { this.setData({ message: "已停止监听读卡器" }) }, });
1. 等待读卡器状态改变的回调
my.ix.onMonitorCardReader(callback)
入参
名称
类型
必填
描述
callback
Function
是
成功的回调函数。
fail
Function
是
失败的回调函数。
错误码说明
-
error
类型
说明(errorMessage)
2001
Number
未知错误
2002
Number
读卡器不支持
2003
Number
连接读卡器失败
2004
Number
无访问权限
2005
Number
寻卡失败
2006
Number
选卡失败
2007
Number
读卡错误
2008
Number
证照读取失败
2009
Number
认证失败
以上内容是 诺塔斯身份证云读卡器接入支付宝小程序的相关介绍,如有遗漏请联系作者。