Listar Terminais

Retorna a lista paginada dos terminais POS do intermediador autenticado, com filtros opcionais por serial number, vendedor e status transacional.

Listar Terminais

get

Lista paginada dos terminais do intermediador autenticado, isolada pela company. Apenas a conta principal (payfac) acessa (senão 403 / BAR-PP-09).

Authorizations

ApiKeyAuth

X-Token-ApistringRequired

Chave de API do intermediador (conta principal/payfac da company)

Query parameters

serialNumberstringOptional

Filtra por serial number (normalizado para maiúsculas)

Example: 1850123456

sellerNamestringOptional

Filtra por nome do vendedor associado

Example: Loja

sellerDocumentstringOptional

Filtra por documento do vendedor associado

Example: 12345678000199

transactionStatusstring · enumOptional

Filtra por status transacional do terminal

Example: ACTIVEPossible values:

pageintegerOptional

Página (0-based)

Default: 0

limitinteger · min: 1 · max: 100Optional

Tamanho da página (1 a 100)

Default: 20

Responses

200

Página de terminais

application/json

Página de terminais (paginação 0-based)

400

Parâmetro inválido (ex.: transactionStatus fora do enum)

application/json

403

Token não é da conta principal (payfac) da company (BAR-PP-09)

application/json

get/physical-payments/payfac/v1/terminals

HTTPcURLJavaScriptPython

GET /physical-payments/payfac/v1/terminals HTTP/1.1
Host: api.barte.com
X-Token-Api: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "serialNumber": "1850123456",
      "idSeller": 456,
      "sellerName": "Loja Centro",
      "sellerDocument": "12345678000199",
      "transactionStatus": "ACTIVE",
      "fromBarte": true,
      "model": "A910"
    }
  ],
  "pageable": {
    "page": 0,
    "limit": 20,
    "totalRecords": 1,
    "totalPages": 1
  }
}