Check the cloud connection

In a cloud Terminal API integration, terminals establish a WebSocket connection to access Terminal API over the cloud. Our POS Support Team needs to enable websockets for you. After websockets are enabled, you can verify in real time whether terminals have a live cloud connection.

You can verify this:

• Remotely:

  • Using your Customer Area

  • Using an API request

• On the physical terminal

Check in the Customer Area

In your Customer Area, you can view the terminals list or the terminal details to verify whether terminals have a live cloud connection to Terminal API:

1. In your Customer Area, go to Point of sale > Terminals.

2. Check the Websocket column. This uses cloud symbols to indicate the cloud connection status of each terminal, or a minus sign () if WebSockets aren't enabled.

   If the Websocket column isn't shown, select the settings icon and select the column.

   There is a delay between the actual status and the status shown in the list. You may want to check an individual terminal as described below.

3. Select the terminal from the list.
   The page Settings > About this terminal appears.

   If you don't see the field Cloud connection, WebSockets aren't enabled for the terminal.

4. At Cloud connection, select Check connection.
   An icon indicates the result, and a message pops up, either:

   • Terminal is connected
   • Terminal is disconnected
     The terminal is turned off, or there is a problem with the terminal's cloud connection.

   The connection icon is not updated automatically. You need to click Check connection each time you want to know the current state.

Check using an API request

The /connectedTerminals API returns a list of terminals for a specific merchant account or store that have a live cloud connection. You can also use this API to check if a specific terminal has a live cloud connection.

The endpoint to use differs for test and live terminals:

• For test terminals: https://terminal-api-test.adyen.com/connectedTerminals
• For live terminals: https://terminal-api-live.adyen.com/connectedTerminals

Authenticate your requests using the same API key that you use for your Terminal API requests.

To verify whether terminals have a live cloud connection to Terminal API:

1. Make a POST request to the test or live /connectedTerminals endpoint, specifying:

   Parameter	Required	Description
   merchantAccount		The merchant account that you want to check.
   store		The store that you want to check. Must belong to the specified merchantAccount.
   uniqueTerminalId		The POIID of the terminal that you want to check, in the format [device model]-[serial number]. Must belong to the specified merchantAccount

   Here are some example requests:

   Get connected terminals under a merchant account

   {
       "merchantAccount": "YOUR_MERCHANT_ACCOUNT"
   }

   https://docs.adyen.com/point-of-sale/diagnostics/check-cloud-connection#get-connected-terminals-under-a-merchant-account
   Get connected terminals under a store

   {
       "merchantAccount": "YOUR_MERCHANT_ACCOUNT",
       "store": "YOUR_STORE_ID"
   }

   https://docs.adyen.com/point-of-sale/diagnostics/check-cloud-connection#get-connected-terminals-under-a-store
   Check a specific terminal

   {
       "merchantAccount": "YOUR_MERCHANT_ACCOUNT",
       "uniqueTerminalId": "V400m-324688178"
   }

   https://docs.adyen.com/point-of-sale/diagnostics/check-cloud-connection#check-a-specific-terminal

2. You receive a response with:

   • uniqueTerminalIds: an array with the POIIDs of the terminals that have a live cloud connection. If you checked a specific terminal, the same uniqueTerminalId from the request is returned.
   /connectedTerminals response

   {
      "uniqueTerminalIds" : [
         "MX915-284251016",
         "MX925-260390740",
         "V400m-324688136",
         "V400m-324688178",
         "V400m-324688181"
      ]
   }

   https://docs.adyen.com/point-of-sale/diagnostics/check-cloud-connection#-connectedterminals-response

   If the uniqueTerminalIds array from the response is empty, this can indicate:

   • No terminal found with a live cloud connection.
   • WebSockets are not enabled.

Check on the terminal

To verify on the physical terminal whether it has a live cloud connection to Terminal API, run a Terminal API connection test:

1. Check the icons in the top row of the terminal display.
   There should be a cloud icon.
2. Go to the Diagnostics menu.
   • On a non-Android terminal, go to the Admin menu and select Network > Diagnostics.
   • On an Android terminal, go to Settings and select Diagnostics.
3. Select Terminal API.
   The items API enabled, WebSocket enabled, and WebSocket connection should all have a green check mark .

Restore the cloud connection

If the result from your check indicates the terminal doesn't have a live cloud connection to Terminal API:

1. Check that WebSockets are enabled:
   In your Customer Area > Point of sale select the terminal and go to Settings > Integrations > field Enable WebSockets.

   If disabled, ask our POS Support Team to enable WebSockets.

2. If you checked remotely, verify that the terminal wasn't turned off at the time.

3. If the terminal is turned on, restart/reboot it.

See also