Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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
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
get/physical-payments/payfac/v1/terminals/{serial_number}
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"
    }
  ]
}

Last updated

Was this helpful?