支付设备集成工具：UDemo

需要快速将 ID TECH 读卡器集成至 POS（或其他）系统的支付应用开发人员，可借助 ID TECH 的 Universal SDK 迅速取得进展。该 SDK 提供库（及通用 API），支持以多种语言（如适用于 Windows 的 C#、适用于 Android 的 Java、适用于 iOS 的 Swift，以及适用于 Linux 的 C）操控 ID TECH 当前在产的所有读卡器，包括芯片卡（EMV）、磁条卡（MSR）和非接触式读卡器。

不过，您实际上无需安装 SDK 即可运行配套的演示程序——一款独立应用，我们称之为 Universal Demo，简称 UDemo。您可以前往以下地址获取 UDemo（Windows 独立版）： 此处.

我们建议所有开发者客户熟悉 UDemo 应用，因为它详细展示了（发送到设备及从设备返回的）原始请求与响应内容，允许您为设备配置特定参数，并提供一个测试场所，便于开发者使用不同参数值实时测试各类命令。UDemo 也是深入了解 EMV 的绝佳途径。

运行 UDemo 安装程序后，启动该应用。您将看到类似如下的窗口：

请注意，您可以随时将任何受支持的 ID TECH 读卡器插入计算机的 USB 端口，UDemo 会自动检测到该设备。设备识别完成后，命令树（参见上文"COMMANDS"）将填充该设备特有的命令（例如，若设备支持非接触式交互，则显示"CTLS"组；若设备支持接触式 EMV 芯片卡交易，则显示"EMV"组，依此类推）。

基本使用流程为：

1. 插入设备。
2. 浏览命令树，直至找到您感兴趣的命令。
3. 在命令树中双击该命令，或单击绿色的 执行命令 按钮（位于窗口底部）。
4. 查看日志窗格，了解请求与响应内容。（发送到设备的值标记为"OUT"，从设备接收的值标记为"IN"。）
5. 查看 结果 窗格（位于右侧），获取所发生情况的英文说明。

在上方截图中，针对 ID TECH VP3300 读卡器运行了 Start EMV Transaction 命令，使用默认交易金额 1.00 美元。实际运行的命令显示在日志顶部。设备返回了四条"IN"响应：第一条响应为 ACK；接下来的两条"IN"响应包含表示 LCD 消息（如"Processing…"）的状态信息，这些消息可能需要在交易进行时显示在 POS 上；第四条也是最后一条 IN 包含读卡器返回的一组 TLV（标签-长度-值）数据。部分 TLV 解析结果显示在 Result 窗格中。

UDemo 是一款高度交互式的工具，最好通过实际使用来学习。为了更快掌握使用方法，您可以注意以下几点：

1. 许多命令可接受参数值，或在运行前可进行特定配置。只需在 Commands 列表中单击某条命令。若该命令可接受附加值，相应的表单字段将自动出现在 Log 窗格上方。填入所需值后，双击该命令即可使用这些值运行。
2. 当插入读卡器的卡片要求 PIN 输入作为其持卡人验证方式之一时，右上方的虚拟键盘将被激活。
3. 在 Command 列表上方有一个按钮，标签为 解密。单击此按钮将弹出对话框，允许您解密交易数据。
4. 在 Log 窗格下方，您会看到一个 开始捕获到磁盘 按钮（连同 清除日志 按钮和 将日志通过电子邮件发送至支持团队按钮）。当您想捕获会话数据以供日后分析时，Start Capture 按钮非常有用。如果您需要开启技术支持工单，甚至可以使用 Email Logs 按钮将结果通过电子邮件发送给我们。

运行 EMV 交易前

当然，UDemo 只是一款测试工具，无法对（真实的）信用卡执行实际扣款交易，但它会模拟接触式 EMV 会话的全部三个阶段（Start、Authenticate 和 Completion）。但是，在运行交易命令前，读卡器至少需要完成若干配置。（否则模拟将失败。）

您可以通过运行以下三条命令，快速完成设备配置（采用合理的默认值）：

1. 首先，在命令树的 AID 节点下找到 Load Default AID 并运行。这实际上是一个批处理操作，会将六个左右的常用 AID 加载到设备中。请等待约十秒。
2. 其次，在命令树的 CAPK 节点下找到 Load Default CAPK 命令并运行。同样，这也是一条批处理命令，需要几秒钟时间。它会加载各卡组织的公钥，用于在交易时验证芯片卡生成的密码学产物。（注意：这些密钥仅供测试使用，不可用于生产环境。请向您的网关或支付处理机构索取生产密钥。）
3. 最后，在命令树的 Terminal Config 节点下找到并运行 Save Terminal Data。此操作将为读卡器加载合理的默认 TLV，以支持各项终端功能。

运行完这些命令后，读卡器即包含相应的默认数据，Start Transaction 等命令应能无错误运行。

了解更多信息

显然，UDemo 应用中的功能远不止这些，难以在此尽述。获取更多信息的最佳方式是？查看 UDemo 屏幕左下角（参考上方图示），找到粉色的 文档 按钮。点击该按钮后，将在 Acrobat Reader 中打开一个 PDF（前提是您的电脑已安装该软件），显示 UDemo 的快速入门指南。

若要了解 UDemo 中显示的所有十六进制字节的含义，您可能需要获取适用于您读卡器的底层（固件）API 指南。通常可以直接从我们公开的知识库中 下载 板块获取（无需注册），但部分文档仅按需提供。在这种情况下，您可联系您的 ID TECH 代表，相关文档将免费提供。

对 Universal SDK 或 ID TECH 的任何产品有疑问？请通过以下方式联系我们的专家： 1-800-984-1010!