Detalhar Terminal

Retorna os detalhes de um terminal a partir do seu serial number, incluindo o histórico de alocação a vendedores da company.

Detalhar Terminal

get

Retorna os detalhes de um terminal e seu histórico de alocação a vendedores da company. Apenas a conta principal (payfac) acessa (senão 403 / BAR-PP-09). Retorna 404 quando o serial number não existe na company.

Authorizations

ApiKeyAuth

X-Token-ApistringRequired

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

Path parameters

serial_numberstringRequired

Serial number do terminal (normalizado para maiúsculas)

Example: 1850123456

Responses

200

Detalhes do terminal e histórico de alocação

application/json

Detalhes do terminal e histórico de alocação (isolado aos vendedores da company)

serialNumberstringOptionalExample: 1850123456

modelstringOptionalExample: A910

fromBartebooleanOptionalExample: true

sellerNamestring · nullableOptionalExample: Loja Centro

sellerDocumentstring · nullableOptionalExample: 12345678000199

idSellerinteger · nullableOptionalExample: 456

transactionStatusstring · enum · nullableOptionalExample: ACTIVEPossible values:

lastTransactionstring · date-time · nullableOptional

Data/hora da última transação

Example: 2026-07-20T14:05:00

activatedAtstring · date-time · nullableOptional

Data/hora de ativação do terminal

Example: 2026-01-10T09:00:00

403

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

application/json

404

Terminal não encontrado na company

application/json

get/physical-payments/payfac/v1/terminals/{serial_number}

HTTPcURLJavaScriptPython

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

{
  "serialNumber": "1850123456",
  "model": "A910",
  "fromBarte": true,
  "sellerName": "Loja Centro",
  "sellerDocument": "12345678000199",
  "idSeller": 456,
  "transactionStatus": "ACTIVE",
  "lastTransaction": "2026-07-20T14:05:00",
  "activatedAt": "2026-01-10T09:00:00",
  "allocationHistory": [
    {
      "sellerId": 456,
      "sellerName": "Loja Centro",
      "linkedAt": "2026-01-10T09:00:00",
      "unlinkedAt": null
    },
    {
      "sellerId": 455,
      "sellerName": "Loja Antiga",
      "linkedAt": "2025-06-01T08:00:00",
      "unlinkedAt": "2026-01-09T18:00:00"
    }
  ]
}