ADadyen
General

Get the account or store of a terminal

Changed on

Returns the company account, merchant account, or store that a payment terminal is assigned to.

From January 1, 2025 POS Terminal Management API is deprecated and support stops on April 1, 2025. To automate the management of your terminal fleet, use our Management API.

post/findTerminal

Request

  • Base URL
    https://postfmapi-test.adyen.com/postfmapi/terminal/v1
  • URL
    https://postfmapi-test.adyen.com/postfmapi/terminal/v1/findTerminal
  • Auth
    • HTTP basic
    • or API key in header X-API-Key

Request body

terminalstring required

The unique terminal ID in the format [Device model]-[Serial number].

For example, V400m-324689776.

Response

OK - the request has succeeded.

companyAccountstring required

The company account that the terminal is associated with. If this is the only account level shown in the response, the terminal is assigned to the inventory of the company account.

merchantAccountstring

The merchant account that the terminal is associated with. If the response doesn't contain a store the terminal is assigned to this merchant account.

merchantInventoryboolean

Boolean that indicates if the terminal is assigned to the merchant inventory. This is returned when the terminal is assigned to a merchant account.

  • If true, this indicates that the terminal is in the merchant inventory. This also means that the terminal cannot be boarded.

  • If false, this indicates that the terminal is assigned to the merchant account as an in-store terminal. This means that the terminal is ready to be boarded, or is already boarded.

storestring

The store code of the store that the terminal is assigned to.

terminalstring required

The unique terminal ID.

Changes