This API provides endpoints for managing your point-of-sale (POS) payment terminals. You can use the API to obtain information about a specific terminal, retrieve overviews of your terminals and stores, and assign terminals to a merchant account or store.
For more information, refer to Assign terminals.
Each request to the Terminal Management API must be signed with an API key. For this, obtain an API Key from your Customer Area, as described in How to get the API key. Then set this key to the X-API-Key header value, for example:
Docs
Main site
Need help?
Participate
Resourcescurl
-H "Content-Type: application/json" \
-H "X-API-Key: Your_API_key" \
...
Note that when going live, you need to generate new web service user credentials to access the live endpoints.
Terminal Management API supports versioning using a version suffix in the endpoint URL. This suffix has the following format: “vXX”, where XX is the version number.
For example:
https://postfmapi-test.adyen.com/postfmapi/terminal/v1/getTerminalsUnderAccount
When using versioned endpoints, Boolean response values are returned in string format: "true" or "false".
If you omit the version from the endpoint URL, Boolean response values are returned like this: true or false.
Use this page to mock POS Terminal Management API in your testing and development.
Run our mock API sample using the open source WireMock library, or in the free edition of WireMock Cloud. You'll have a working API server simulating the behavior of POS Terminal Management API, which will allow you to keep building and testing even if the actual API you isn't currently available.
