Electron+Vue.js收银应用对接Worldline Yomani支付终端问题咨询

通用交互实现逻辑 #

线下支付终端的免手动输金额发起支付能力，仅在终端受控对接模式下开放，普通公开渠道搜不到对接文档是行业常规操作——这类涉及资金交易的设备协议，只对签约收单合作方、认证ISV开放，不会对外公开发布。
主流对接模式共三类：

• 本地直连模式：终端通过USB虚拟串口/局域网TCP和收银主机建立连接，收银端按照厂商定义的私有协议组包，把金额、交易类型、订单号等字段发给终端，终端收到校验通过后直接唤起支付流程，交易完成后将支付结果原路返回给收银端。终端本身的以太网连接仅用于和收单机构清算链路通讯，和本地收银端的指令交互无关。
• 本地代理转发模式：部分厂商不允许应用直连终端，要求主机安装官方提供的驱动/本地代理服务，代理服务常驻后台监听本地固定端口，收银端只需要向本地端口发送HTTP/WebSocket请求，由代理完成指令签名、转发、结果回传全流程。
• 云端推送模式：终端提前和商户号绑定保持公网在线，收银端把交易请求提交给收单机构的云端网关，网关通过长连接把交易指令推送给对应终端，这种模式不需要本地和终端做物理连接匹配，只要终端在线即可触发。

Worldline Yomani 落地对接步骤 #

• 第一步先拿官方对接权限：如果你是通过Worldline官方或者合作收单渠道采购的设备，直接向对接的渠道技术支持索要《Yomani终端集成规范》，文档里会明确标注串口波特率、报文结构、签名算法、结果码定义，没有这个文档靠逆向基本走不通，设备自带报文签名校验，非法指令会直接触发终端锁机。
• 第二步完成本地连接配置：Yomani系列的USB连接默认走虚拟串口模式，不是通用HID设备。把终端接主机后先检查设备管理器的端口列表，没识别到设备就先装官方提供的终端驱动，识别到对应COM/ttyACM端口后，不需要额外配置以太网参数即可做本地指令交互。
• 第三步集成到Electron+Vue项目：直接在Electron主进程里引入serialport依赖实现串口通讯，不要在Vue渲染进程里直接调用串口API。交易发起时把金额转成对应货币的最小单位（比如人民币按分计算），按照规范组包通过串口发给终端，监听串口返回的结果报文，解析后通过IPC同步给渲染进程的Vue页面更新状态即可。
• 基础消费交易的报文核心结构参考（基于合作方公开的通用片段）：

<!-- 交易金额单位为对应货币最小计价单位，示例为100元人民币消费 -->
<TransactionRequest>
  <TxnType>PURCHASE</TxnType>
  <Amount>10000</Amount>
  <CurrencyCode>156</CurrencyCode>
  <MerchantOrderNo>系统内部生成的唯一订单号</MerchantOrderNo>
</TransactionRequest>

注意：所有涉及交易签名的密钥不要硬编码在前端代码里，Electron打包后可以做代码反编译，密钥存在主进程做签名计算更安全。

内容的提问来源于stack exchange，提问作者Mr Dany