跳到主要内容

WLAN/LAN模式集成

介绍

WiseCashier ECRHub服务为POS application提供了使用WLAN模式将订单推送到支付终端的功能。WiseCashier ECRHub服务模拟后端服务器,POS应用程序充当客户端,通过客户端-服务器通信发送和处理订单。

  • 在WLAN模式下,您必须确保POS应用程序和支付终端位于同一WLAN上。
  • WLAN模式比较比USB模式更稳定,不受USB电缆和操作系统的限制。
  • WLAN模式允许客户端和服务器之间的双向通信,而云模式只允许单向通信。

以下是流程图:

  1. POS application通过本地WLAN/LAN通信将订单信息(如:订单号、总金额等)发送到WiseCashier
  2. WiseCashier的结账模块收集银行卡信息并进行安全处理,然后将其与交易数据中的订单信息合并,并将支付请求发送到支付网关或获取系统。
  3. 支付网关或获取系统对WiseCashier的响应结果。
  4. WiseCashier通过本地WLAN/LAN将交易结果发送给POS application,并在屏幕上显示支付结果。
跨终端应用集成WLAN/LAN模式结构图,流程图

开发指引

1. 应用设置

1.1 准备

  • 需要包括一个或多个无线接入点(AP)的稳定无线局域网环境来覆盖POS/ECR系统和POS终端所在的区域。
  • 无线接入点需要正确配置,包括网络名称(SSID)、安全加密(例如WPA2或WPA3)、信道选择和带宽设置。
  • POS/ECR系统和POS终端需要分配正确的IP地址,可以是静态IP地址分配,也可以是通过DHCP自动获取。
  • 确保POS/ECR系统和POS终端的网络设置与WLAN环境兼容,包括子网掩码、默认网关和DNS服务器。

1.2 WiseCashier设置

  • 在POS终端上启动WiseCashier应用程序。
  • 单击侧菜单,进入Settings > General > ECR Hub
  • 启用ECR集线器,然后选择WLAN/LAN。
  • 选择要连接的可用设备,然后单击它进行配对。返回待机页面,确认POS/ECR设备已连接到终端。
跨终端应用集成WLAN/LAN模式,WiseCashier设置

2. 两种集成方式

2.1. 通过WiseCashier-SDK进行集成

我们提供在本地网络下与WiseCashier SDK快速集成。目前,SDK支持以下编程语言

我们建议开发人员使用WiseCashier SDK,它对通信协议层进行了二次打包。SDK可以帮助开发者快速完成应用支付集成。 ,您可以通过我们的GitHub获取它们的源代码和最新版本信息。

2.2 与WebSocket API集成

如果上述SDK无法满足您的需求,或者您需要对产品细节进行更深入的控制,您可以参考我们的API规范并编写自己的代码。

接下来阅读:

以下是一个使用Postman进行WLAN/LAN集成的示例截图:

Postman进行WLAN/LAN集成的示例截图