Search docs

Are you looking for test card numbers?

Would you like to contact support?

Start searching Adyen's documentation...

  Documentation

Retrieve connected terminals

Return a list of your terminals connected to our Terminal Cloud API.

If you have a number of terminals, you may need to return a list of these terminals that are powered on and connected based on the merchant account or store to which they are registered. You can also check if a specific terminal is connected by using its unique Terminal ID.

Endpoints

The test endpoint is available through the following service:

Endpoint
https://terminal-api-test.adyen.com/connectedTerminals

The live endpoint is available through the following service:

Endpoint
https://terminal-api-live.adyen.com/connectedTerminals

Request - All terminals under a merchant account

 {
    "merchantAccount": "PME_POS"
}

Request - All terminals under a store

{
    "merchantAccount": "PME_POS",
    "store": "Store12345"
}

Request - A specific terminal

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

Response

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