...
Go to the Handpoint status page https://status.handpoint.com/ to check the status of the cloud API
If there are no issues, ask the merchant for the serial number of the terminals encountering problems.
Make sure that the app standby optimizer is disabled on the terminal. This will allow the terminal to keep an internet connection in the background even if it is in sleep mode:
...
Go to the PAX Store and download the logs of the terminal
If the logs are going from Disconnected → Connecting → DIsconnecting → Connected and CloudUnavailable it means that the terminal is losing internet connection and points to an unreliable network on merchant premises.
Code Block Here is a small extract from the logs: [2023-07-29 14:30:35].628 W/App-Detailed-Logger( 2742): ***[APP] -> [SDK] CLOUD - Pusher connection status changed DISCONNECTED --> CONNECTING [2023-07-29 14:30:35].651 W/App-Detailed-Logger( 2742): ***[APP] -> Event received connectionStatusChanged:CloudUnavailable [2023-07-29 14:30:35].665 W/App-Detailed-Logger( 2742): ***[APP] -> [SDK] CLOUD - stopped ReconnectionTimer [2023-07-29 14:30:35].680 W/App-Detailed-Logger( 2742): ***[APP] -> [SDK] CLOUD - starting ReconnectionTimer [2023-07-29 14:30:35].690 W/App-Detailed-Logger( 2742): ***[APP] -> [SDK] CLOUD - Pusher connection status changed CONNECTING --> DISCONNECTING [2023-07-29 14:30:35].708 W/App-Detailed-Logger( 2742): ***[APP] -> Event received connectionStatusChanged:CloudUnavailable [2023-07-29 14:30:35].718 W/App-Detailed-Logger( 2742): ***[APP] -> [SDK] CLOUD - stopped ReconnectionTimer [2023-07-29 14:30:35].732 W/App-Detailed-Logger( 2742): ***[APP] -> [SDK] CLOUD - starting ReconnectionTimer [2023-07-29 14:30:35].755 W/App-Detailed-Logger( 2742): ***[APP] -> [SDK] CLOUD - Pusher connection status changed DISCONNECTING --> CONNECTED [2023-07-29 14:30:35].767 W/App-Detailed-Logger( 2742): ***[APP] -> Event received connectionStatusChanged:CloudConnected [2023-07-29 14:30:35].775 W/App-Detailed-Logger( 2742): ***[APP] -> [SDK] CLOUD - stopped ReconnectionTimer [2023-07-29 14:30:35].779 W/App-Detailed-Logger( 2742): ***[APP] -> [SDK] CLOUD - Pusher connection status changed DISCONNECTED --> CONNECTING [2023-07-29 14:30:35].794 W/App-Detailed-Logger( 2742): ***[APP] -> Event received connectionStatusChanged:CloudUnavailable [2023-07-29 14:30:35].799 W/App-Detailed-Logger( 2742): ***[APP] -> [SDK] CLOUD - stopped ReconnectionTimer [2023-07-29 14:30:35].803 W/App-Detailed-Logger( 2742): ***[APP] -> [SDK] CLOUD - starting ReconnectionTimer [2023-07-29 14:30:35].808 W/App-Detailed-Logger( 2742): ***[APP] -> [SDK] CLOUD - onError - There was a problem connecting to Pusher: Connection not authorized within timeout - code: 4009 [2023-07-29 14:30:35].814 W/App-Detailed-Logger( 2742): ***[APP] -> [SDK] CLOUD - stopped ReconnectionTimer [2023-07-29 14:30:35].825 W/App-Detailed-Logger( 2742): ***[APP] -> [SDK] CLOUD - Pusher connection status changed CONNECTED --> DISCONNECTED [2023-07-29 14:30:35].830 W/App-Detailed-Logger( 2742): ***[APP] -> [SDK] CLOUD - starting ReconnectionTimer [2023-07-29 14:30:35].840 W/App-Detailed-Logger( 2742): ***[APP] -> Event received connectionStatusChanged:CloudDisconnected
In this case there are a couple of troubleshooting steps :
Instead of connecting the terminal to the premises wifi, connect it to a mobile hotspot (generated by a phone). If that works fine and the merchant is able to send payments, it narrows down the issue to the wifi router.
If the problem is the wifi based on the test made in 1. then there are 2 paths forward:
Install a sim card, Paysafe or the ISV should be able to provide the merchant with a SIM that works in the PAX terminals - THIS IS THE PREFERRED SOLUTION AS A SIM WILL PROVIDE IMMEDIATE STABILITY
Connect to a different wifi, if the router generates 2.4ghz network and 5ghz network you can try to switch between both to check if there is any difference in how the reader behaves.
Restart the Wifi router on merchant premises