Search

Are you looking for test card numbers?

Would you like to contact support?

Point-of-sale icon

Check the cloud connection

Remotely check the live websockets connection of terminals.

In a cloud Terminal API integration, terminals establish a websockets connection to access Terminal API over the cloud. Our POS Support Team needs to enable websockets for you. Once websockets are enabled, you can verify remotely and in real time whether terminals are turned on and have a live cloud connection.
You can verify this:

Use the Customer Area

To verify from your Customer Area whether a specific terminal has a live cloud connection to Terminal API:

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

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

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

    • -white_check_mark- Terminal is connected
    • -x- Terminal is disconnected
    • The connection icon is not updated automatically. You need to press Check connection each time you want to know the current state.
    • If you don't see Cloud connection, websockets are not enabled for the terminal.

Use an API call

Using the /connectedTerminals API, you can get a list of terminals registered to a specific merchant account or store that have a live cloud connection. You can also 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 -white_check_mark- The merchant account that you want to check.
    store -x- The store that you want to check. Must belong to the specified merchantAccount.
    uniqueTerminalId -x- 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"
    }
    Get connected terminals under a store
    {
        "merchantAccount": "YOUR_MERCHANT_ACCOUNT",
        "store": "YOUR_STORE_ID"
    }
    Check a specific terminal
    {
        "merchantAccount": "YOUR_MERCHANT_ACCOUNT",
        "uniqueTerminalId": "V400m-324688178"
    }
  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"
       ]
    }

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

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

See also