Help Articles

Network Requirements

In order to ensure the optimal functioning of our in-store solutions, a number of network requirements has to be met. Stores that don’t follow these networking best practices will be running a high risk of seeing the reliability of our system drop significantly, including critical operations such as handling customer payments.

This document may be updated in the future as we identify new potential problem areas or find solutions to existing ones. Contact our support if you have any questions.


Hardware

  • Use an uninterrupted, standard power socket for each stationary device, including iPads, printers, card readers, and scanners.
  • For Apple devices, use the official charging cables whenever possible.
  • Use a dedicated router for the devices running our apps and the hardware coupled with them. If it’s not technically feasible to do so, please refer to the Setup section below for how to mitigate that.
  • When using the iPhone or iPad version on the move, use a dual-band router or access point. Connect the phone or tablet to the 5GHZ wifi band, and the terminals to the 2GHZ band.
  • Use a professional-grade access point that supports 802.11n or 802.11ac wireless standards, Bonjour discovery, device discovery, and other advanced features. We cannot guarantee a smooth experience when cheap, unreliable networking hardware is used.
  • Use an RJ45 CAT5-E (or CAT6/6-A) ethernet cable when connecting devices directly to the access point or to a network switch.
  • Use an unmanaged network switch to connect the devices running Kaching apps to peripherals such as printers and card readers. Using smart and/or managed network switches might result in connectivity issues if set up incorrectly.
  • Your access points (routers, modems, etc) need to be set up in a location that is clear from physical obstructions, such as ceilings and unobstructed walls. If your store is multi-floor, consider using a mesh network installed by a professional networking technician.

Setup

  • If the card reader, printer, or scanner you use support wired connection through LAN, prioritize that over using a wireless connection.
  • If the card reader, printer, or scanner you use support connecting directly to an iPad using lightning cables or USB-C (depending on the model), prioritize that over connecting them via Wifi and/or Bluetooth.
  • Make sure that your connection speed on Speedtest or Bredbandskollen is above 8Mbps for downloads, and 4Mbps for uploads.
  • Enable Bonjour and device discovery on your access point.
  • Use DHCP reservations to assign static IPs to the devices running our apps and the hardware coupled with them. This ensures unique IP addresses and avoids having to recouple peripheral devices.
  • We recommend having a 4G modem in standby in case the local network goes down. Please keep in mind that these don’t fulfill the network requirement cited in this document, and as such, should not be used outside of emergencies.
  • Ensure the DNS server in your local network can access our domains (*.kachingretail.com, *.kachinghq.com) as well as those of our partners. Failure to do so will result in some services not working as intended, or at all.

Bandwidth Usage

  • Devices running Kaching apps should not be streaming music or videos at any moment during active usage. Doing so will interface with the proper functioning of the transaction process.
  • Devices streaming music or video should have a lower traffic priority, use a different SSID, or a different access point altogether. (see above)
  • When using a shared access point with other devices (music streaming, staff devices, etc), use virtual local area networks to give devices running Kaching as well as payment terminals the highest priority (VLAN 0). Limit the bandwidth allocation of the other virtual networks (VLAN 1, VLAN 2, etc) if there are more than 5 devices in your store that are connected via the same access point.

Wifi

  • Use a dedicated network (SSID) for the devices running our apps and the hardware coupled with them.
  • Use the least congested channel for the Kaching In-store peripherals whenever possible. Some access points can do that automatically.
  • Make sure wirelessly connected devices have an optimal wifi signal strength. For iOS devices, that corresponds to 4 full bars in the wifi signal indicator.
  • Turn on mobile network as a failover on iPhone and other compatible devices in case the local network is performing poorly.

Bluetooth

  • If you have more than dozen devices using Bluetooth in the store, avoid using it to connect the devices running Kaching apps to peripheral devices such as card readers and printers. Device discovery time is negatively impacted by the number of devices using BT in the same area.