Start connection tests on the terminal and learn how to run the connection tests, what it means when a connection test fails and how to interpret the results.
What's in the article?
1. How to run a diagnostic connection test from the terminal?
4. Local Communications TLS Test
Run diagnostic connection tests from a terminal
-
Check the icons in the top row of the terminal display. If an expected icon is missing, that is the first indication of what is wrong.
- If the terminal uses a Wi-Fi connection, you should see the Wi-Fi symbol.
-
If you have a cloud Terminal API integration, you should see a cloud symbol.
-
Go to Settings and select Diagnostics.
- On non-Android terminals, go to the Admin menu (9 -> enter) and select Network> Diagnostics.
-
On an Android terminal, go to Settings and select Diagnostics.
-
Under Diagnostics, select PSP connection and check the result.
-
Go back to Diagnostics, select Terminal API and check the result.
-
Go back to Diagnostics and select Endpoints. The terminal runs tests on four URLs and shows the results.
On a non-Android terminal, when tests pass the terminal shows a green check mark 
for all steps in a test. If a test fails, it is marked with red cross 
, and all steps are also marked as failed with a red cross .
On an Android terminal, when tests pass the terminal shows Successful. If you tap Successful, all steps show a green check mark . If a test fails, the terminal shows Failed, and all steps when you tap Failed are also marked as failed with a red cross .
The next sections explain what it means when a test step fails.
PSP connection test
The PSP connection test verifies the connection to the payments platform. The test checks the DNS resolution, firewalls, routing, and TLS negotiations.
If a test step fails, all steps after that are also marked as failed with a red cross .
Terminal API test
The Terminal API test verifies the API connection and the cloud WebSocket connection. If you are not using cloud communications, you can ignore the WebSocket test result.
If a test step fails, all steps after that are also marked as failed with a red cross .
Local communications TLS test
The Terminal API test also returns information about the Transport Layer Security (TLS) used in your local communications integration.
If you are using cloud communications, the above fields are empty.
Endpoints test
The Endpoints test verifies whether the terminal is able to connect with several URLs:
- Sync URL, which is used for refunds and cancellations.
- Config URL, where the terminal retrieves its configuration.
- PAL URL, where the terminal sends requests.
- Firmware URL, where the terminal retrieves the latest software release.
The test also shows the Maximum Transmission Unit (MTU) value that the terminal is using.
For each of the above URLs the terminal carries out the following test steps:
If a test step fails, all steps after that are also marked as failed with a red cross .