API POS Terminal Management API
Consulte POS Terminal Management API, do provedor adyen.com, versão 1: documentação, especificação OpenAPI 3.1.0 e referências para planejar a integração.
adyen.com · Versão 1
Conheça a plataforma
O que integrar com POS Terminal Management API
Descrição técnica preservada da especificação de origem. A versão do contrato ajuda a identificar a API; confirme a disponibilidade atual no fornecedor.
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. Authentication 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: curl -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. Versioning 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.
Ficha técnica
Como funciona a integração
Versões, permissões, preços e limites podem mudar. Consulte a documentação da plataforma antes de implementar.
Do planejamento à produção
Checklist para integrar POS Terminal Management API
- Defina o fluxo. Identifique quais dados precisam circular, o sistema de origem e o resultado esperado.
- Leia os requisitos oficiais. Verifique acesso à API, plano necessário, versão e ambiente de testes.
- Configure o acesso com segurança. Guarde credenciais secretas no servidor e conceda apenas as permissões necessárias. Restrinja chaves públicas conforme a documentação do fornecedor.
- Teste a primeira requisição. Valide os campos, a paginação e o formato de resposta com dados de teste.
- Prepare o tratamento de falhas. Considere limites de requisição, retentativas com espera e prevenção de operações duplicadas.
- Acompanhe a integração. Registre erros sem expor dados sensíveis e monitore alterações na API.